Eine Einladung erzeugt jetzt ein Mitarbeiter-Konto mit dem Eigentümer des Raums als Förderer. Mitarbeiter arbeiten nur in den eingeladenen Räumen nach ihrer Rolle, legen keine Räume und im persönlichen Raum nichts an und starten ihre Sitzung im Team-Raum. Einladen darf nur der Eigentümer als Hauptnutzer; nur ein Hauptnutzer kann Raum-Eigentümer sein. Hauptnutzer sehen unter Mein Team die Personen in ihren Räumen und verwalten ihre Mitarbeiter (deaktivieren, Einmal-Passwort, aus Räumen entfernen). Der Betreiber sieht die Team-Übersicht mit CSV-Export und macht einen Mitarbeiter zum Hauptnutzer. Eine zentrale Prüfstelle für Grenzen (access/limits.py) wird beim Anlegen von Räumen und beim Aufnehmen und Einladen von Mitgliedern aufgerufen; Tarife folgen später. Die lokale Suite läuft mit 143 Tests grün, der Frontend-Build und 24 Node-Tests ebenfalls. Die Oberfläche wurde noch nicht im Browser bedient. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
9.7 KiB
Benutzerverwaltung, Rollen und Rechte (Ist, 20.10.2026)
Erster Schnitt der Administration. Er baut auf den vorhandenen Mechanismen auf (Kontext-Grants, Datenräume, Audit über domain_events) und führt kein neues Fachmodell ein. Die Auswertung der Objektrechte bleibt unverändert, siehe RECHTEMODELL_IST.md.
Rollen
Feste Bündel, kein Rolleneditor (Technische Spezifikation 5.2). Rollen werden bei jeder Anfrage aus der Datenbank gelesen, nicht in der Session gehalten (backend/app/access/roles.py).
| Ebene | Rolle | Darf |
|---|---|---|
| Plattform | Betreiber (is_superadmin, mehrere möglich) |
Konten anlegen, deaktivieren und aktivieren, Passwort zurücksetzen, Sitzungen beenden, Betreiberrolle vergeben und entziehen, Räume mit Verwaltern sehen, Verwalter in einen Raum ohne Verwalter einsetzen, Verwaltungsprotokoll lesen. Kein Leserecht auf Inhalte. |
| Plattform | Nutzer | eigenes Passwort ändern, eigene Sitzungen ansehen und beenden |
| Datenraum | Verwalter (manager) |
Mitglieder und Rollen verwalten, Einladungen, Raum umbenennen, archivieren und wieder aktivieren |
| Datenraum | Mitglied (member) |
Inhalte im Raum anlegen. Objektrechte weiter nur per Grant |
| Datenraum | Leser (reader) |
Raum wählen und freigegebene Inhalte lesen. Legt im Raum nichts an. Erhält für Objekte dieses Raums keine Bearbeiten- oder Freigeben-Grants |
Schutzregeln
- Der letzte aktive Betreiber lässt sich weder deaktivieren noch zurückstufen. Niemand deaktiviert das eigene Konto.
- Der letzte aktive Verwalter eines Raums bleibt Verwalter. Er kann weder zurückgestuft noch entfernt werden.
- Wer zum Betreiber befördert wird, verliert alle Sitzungen und meldet sich neu an.
- Konten werden deaktiviert, nicht gelöscht. Inhalte, Owner-Bezüge und Protokoll bleiben. Löschen oder Anonymisieren ist ein eigener späterer Schnitt.
Wirkung der Leser-Rolle
Einzelfreigaben (Grants) hängen am Objekt, nicht am Raum. Der Leser begrenzt daher zusätzlich zur Raumfreigabe (siehe unten, dort liest er nur) drei Stellen:
- Anlegen von Akte, Vorgang, Notiz, Datei, Referenz, Aufgabe und Frist mit diesem Heimatraum (
ensure_can_createinops.py). - Vergabe neuer Bearbeiten- oder Freigeben-Grants an einen Leser für Objekte dieses Raums (
grant_access). - Beim Zurückstufen auf Leser werden dessen vorhandene Bearbeiten- und Freigeben-Grants auf Objekte dieses Raums in derselben Transaktion entzogen. Lese-Grants bleiben.
Grants auf Objekte anderer Räume bleiben unberührt.
Datenräume, Eigentümer und Raumfreigabe (seit 21.10.2026)
- Mehrere Räume: Jede Person kann beliebig viele gemeinsame Datenräume anlegen. Ein Raum mit nur dem Eigentümer als Mitglied ist privat, mit weiteren Mitgliedern Mehrbenutzer. Der persönliche Raum bleibt unverändert.
- Eigentümer (
data_rooms.owner_id): der Ersteller. Er ist stets Verwalter, lässt sich nicht entfernen oder zurückstufen und überträgt den Raum an ein aktives Mitglied. Nur er archiviert und stellt wieder her und ändert die Voreinstellung für neue Einträge. Ein Konto, das einen Raum mit weiteren Mitgliedern besitzt, lässt sich erst nach Übertragung deaktivieren. Ist der Eigentümer nicht mehr handlungsfähig, setzt der Betreiber einen neuen ein (protokolliert). Die Eigentümerrolle verleiht kein Leserecht. - Raumfreigabe: Ein Raum ist ein Team. Der Owner teilt eine Akte, Unterakte oder einen Vorgang mit einem oder mehreren seiner Räume, unabhängig davon, wo der Eintrag abgelegt ist. Mitglieder erhalten Rechte nach Rolle (Leser lesen; Mitglied und Verwalter bearbeiten; Weitergeben und Löschen nie), die Freigabe kann auf „nur lesen“ begrenzt werden, einzelne Personen lassen sich ausnehmen. Ein einzelner Vorgang lässt sich teilen, ohne die Akte offenzulegen (Beispiel: nur die Vorgänge, die der Anwalt sehen soll). Die Voreinstellung eines Raums teilt neu angelegte Einträge, die in diesem Raum entstehen, automatisch mit ihm. Der Owner sieht seine Einträge unabhängig von Raum und Mitgliedschaft. Wer ein Team verlässt oder Leser wird, nimmt seine Freigaben an dieses Team mit; wer aus einem Raum entfernt wird, arbeitet danach im persönlichen Raum. Beim ersten weiteren Mitglied zeigt die Oberfläche, was bereits mit dem Raum geteilt ist. Bestehende Freigaben wurden übernommen, nicht geteilte Einträge blieben privat.
- Quellzugänge: Die Raumfreigabe gibt keine Paperless- oder Mail-Zugänge des Owners frei. Dafür bleibt die ausdrückliche Freigabe mit der Option nötig.
- Löschen: Akte und Vorgang löscht nur der Owner (oder wer ein Löschrecht hat), nicht jeder Bearbeiter.
Zugang
- Einmal-Passwort: Der Betreiber legt ein Konto an oder setzt das Passwort zurück. Tsumugu erzeugt ein Passwort und zeigt es einmal an. Das Konto steht auf
must_change_password, bis die Person ein eigenes festgelegt hat. Bis dahin antworten nurauth/session,auth/passwordundauth/logout, alles andere mit 403password_change_required. - Einladungslink: Ein Verwalter erstellt eine Einladung mit Rolle. Der Link enthält das Token im URL-Fragment (
/invite/{id}#{token}), es erreicht also keinen Server-Log. Der Link gilt 7 Tage und einmal und lässt sich widerrufen. Es gibt keinen E-Mail-Versand. - Passwortregel: mindestens 10 Zeichen, höchstens 72 UTF-8-Byte (bcrypt). Beim Ändern des eigenen Passworts enden alle anderen Sitzungen.
Anmeldung
- Die Versuchsbegrenzung steht in der Tabelle
auth_login_attempts(8 Fehlversuche in 10 Minuten je Bucket). Der Bucket ist ein SHA-256 aus Adresse und E-Mail, die Roh-E-Mail wird nicht gespeichert. Ein erfolgreicher Login löscht den Bucket. - Unbekannte und deaktivierte Konten laufen durch einen bcrypt-Vergleich und erhalten dieselbe Antwort wie ein falsches Passwort.
- Der CSRF-Vergleich ist konstantzeitlich.
last_seen_atwird höchstens alle 5 Minuten geschrieben.
Audit
Alle schreibenden Aktionen schreiben in domain_events, ohne E-Mail, Passwort und Token. Ressourcenarten: account, session, room, membership, invitation. Der Betreiber liest sie unter GET /api/v1/admin/events. Nicht protokolliert werden fehlgeschlagene Anmeldungen (die Begrenzung zählt sie in auth_login_attempts).
Bewusst nicht enthalten (Sicherheitskonzept)
MFA (später optional für alle Konten), Leerlaufablauf und Rotation der Sitzung, Änderung der Sitzungsdauer von 14 Tagen, Härtung des Web-Bootstraps für das erste Betreiberkonto (R-04), Mindestlänge 15, Einschränkung von GET /api/v1/principals, E-Mail-Versand, Löschen und Anonymisieren von Konten, Übertragung von Ownership.
Bedienung (21.10.2026)
- Eine Stelle für Datenräume: Verwaltung → Datenräume listet alle eigenen Räume mit Zustand, Rolle und Eigentümer. Ein Klick öffnet die Verwaltung des Raums (
/rooms/{id}): Mitglieder, Rollen, Einladungen, Umbenennen, Voreinstellung, Übertragung, Archivieren. Dafür ist kein Wechsel in den Raum nötig. Der Betreiber sieht darunter zusätzlich alle Räume mit Eigentümer und Verwalter. - Nutzer ist etwas anderes: Verwaltung → Nutzer (nur Betreiber) verwaltet Konten, Verwaltungsprotokoll das Audit. Mein Konto betrifft das eigene Passwort und die Geräte.
- Ziehen zum Teilen: In den Listen Akten und Vorgänge zeigt eine Leiste die Räume, in denen man schreiben darf. Eigene Einträge lassen sich darauf ziehen und werden mit dem Raum geteilt. Die Liste zeigt „geteilt mit …“. Ohne Maus: Eintrag öffnen und Teilen wählen.
Betreiber, Hauptnutzer und Mitarbeiter (seit 22.10.2026)
| Ebene | Kontoart | Aufgabe |
|---|---|---|
| Betreiber | Hauptnutzer mit is_superadmin |
SaaS-Betreiber: verwaltet Hauptnutzer, sieht Räume und Team-Übersicht (Metadaten), keine Inhalte |
| Hauptnutzer | account_kind = main |
privater Raum und eigene Team-Räume; Eigentümer; lädt Mitarbeiter ein und verwaltet sie |
| Mitarbeiter | account_kind = employee |
arbeitet nur in eingeladenen Räumen nach Raumrolle; legt keine Räume an; kein privater Arbeitsbereich |
- Einladung: nur der Eigentümer des Raums (als Hauptnutzer). Das neue Konto ist ein Mitarbeiter;
sponsor_idist der Eigentümer. Ein Verwalter ohne Eigentum nimmt nur bestehende Konten auf. - Mitarbeiter-Sitzung: beginnt im ersten Team-Raum, in dem die Person Mitglied ist. Im persönlichen Raum legt ein Mitarbeiter nichts an. Ohne Raum kann er sich anmelden, aber nichts tun.
- Eigentümer: nur ein Hauptnutzer kann Raum-Eigentümer sein, auch bei Übertragung und beim Einsetzen durch den Betreiber.
- Mein Team (
/team): zeigt die Personen in den eigenen Räumen mit Rolle je Raum. Für selbst eingeladene Mitarbeiter: deaktivieren/aktivieren, Einmal-Passwort, Entfernen aus allen eigenen Räumen. Fremde und unbekannte Konten antworten gleich mit 403. - Betreiber:
/admin/teamzeigt Hauptnutzer mit ihren Mitarbeitern, Räumen und Rollen (auch als CSV, mit Schutz vor Formeleingabe). Nur der Betreiber macht einen Mitarbeiter zum Hauptnutzer; die Person meldet sich dann neu an.
Vorbereitung Subscription
backend/app/access/limits.py ist die einzige Stelle für Grenzen. ensure_can_create_room(conn, owner_id) läuft beim Anlegen eines Raums, ensure_can_add_member(conn, owner_id, room_id) beim Aufnehmen, Einladen und Annehmen einer Einladung. Heute lassen beide alles zu. Das Kontingentsubjekt ist der Eigentümer des Raums, ein Hauptnutzer, wie der Verein bei Shinkan (Entitlements-Blueprint). Vorgesehene Messgrößen: aktive Mitarbeiter je Hauptnutzer und je Raum, aus der Datenbank gezählt. Der Betreiber setzt den Plan. Zahlungsdienst und Tarife gehören nicht in diese Stufe. Offene Entscheidung: Ein Mitarbeiter, den ein zweiter Hauptnutzer als bestehendes Konto aufnimmt, zählt beim Raum-Eigentümer; die Zuständigkeit bei Grenzen klärt das Tarifkonzept.