Files
tsumugu/docs/architecture/BENUTZERVERWALTUNG.md
T
LarsandClaude Opus 5.5 15e0dc7e52
Deploy Development / deploy (push) Successful in 46s
Test Suite / pytest-backend (push) Successful in 6m39s
Test Suite / frontend-build (push) Successful in 24s
Test Suite / smoke-dev (push) Successful in 0s
Gib verknüpfte Originale im Datenraum je Person über die eigenen Zugänge frei, damit Raummitglieder Paperless-Dokumente und E-Mails geteilter Akten lesen können.
Die Raumfreigabe allein gab die Zugänge des Owners nicht weiter. Ein Leser im Raum sah die Akte,
aber kein Original. Neu ist room_source_access: Wer im Raum teilen darf, schaltet für ein Mitglied
„Originale über meine Zugänge“ ein. Das gilt für alle eigenen, mit dem Raum geteilten Einträge.
Ausnahmen, Ende der Raumfreigabe und Verlassen des Raums schließen den Abruf. Beschluss R-01 ist
entsprechend ergänzt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 15:19:15 +01:00

17 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:

  1. Anlegen von Akte, Vorgang, Notiz, Datei, Referenz, Aufgabe und Frist mit diesem Heimatraum (ensure_can_create in ops.py).
  2. Vergabe neuer Bearbeiten- oder Freigeben-Grants an einen Leser für Objekte dieses Raums (grant_access).
  3. 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 (seit 04.11.2026): Die Raumfreigabe allein gibt keine Paperless- oder Mail-Zugänge des Owners frei. Wer in einem Raum teilen darf (Mitglied oder Verwalter), kann einem einzelnen Mitglied dort „Originale über meine Zugänge“ freigeben (Tabelle room_source_access). Die Person liest dann verknüpfte Originale aller Akten und Vorgänge dieses Owners, die mit dem Raum geteilt sind, über dessen Zugänge; sie erhält keine Zugangsdaten und kann nicht im Archiv oder Postfach suchen. Entscheiden kann nur die Person, deren Zugänge benutzt werden. Personenausnahmen, das Ende der Raumfreigabe und das Verlassen des Raums schließen den Abruf; wer aus dem Raum entfernt wird, verliert die Freigabe auch nach einer Rückkehr. Wird der Owner Leser oder verlässt er den Raum, enden seine Quellenfreigaben dort. Daneben bleibt die Einzelfreigabe mit der Option.
  • 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 nur auth/session, auth/password und auth/logout, alles andere mit 403 password_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_at wird 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.
  • Ablage mit Ordnerbaum und Kacheln (Akten, Vorgänge, Räume): Links ein Ordnerbaum („Meine Ablage“ mit Akten und Vorgängen, darunter „Räume“), rechts Kacheln: Ordnersymbol für Akte und Unterakte, Dokumentstapel für Vorgang, Teamordner für Räume. Umschaltbar auf eine kompakte Liste. Ein Klick öffnet den Eintrag, „Inhalt ›“ wechselt in den Ordner (Unterakten und Vorgänge der Akte). Am Handy liegt der Baum hinter „Ordner anzeigen“.
  • Räume sind virtuelle Ordner: Ein Eintrag kann in mehreren Räumen liegen, ohne verschoben zu werden. „In Raum legen“ und „Aus Raum nehmen“ ändern nur die Zuordnung. Auf jeder Kachel zeigen Marken, in welchen Räumen der Eintrag liegt (nur dem Owner).
  • Vier Wege zum Zuordnen: (1) im Raum „Hinzufügen“ mit Auswahl eigener Akten und Vorgänge, (2) eine Kachel auf einen Raum im Baum oder auf eine Raumkachel ziehen, (3) Knopf „In Raum legen“ auf der Kachel (auch am Handy), (4) die Marke auf der Kachel öffnen und „Aus Raum nehmen“. Jede Aktion nennt danach, wer Zugriff hat (zum Beispiel „Ben bearbeitet, Cem liest“).
  • Neu anlegen fragt nicht mehr nach dem Heimatraum. In der Raumansicht entsteht ein Eintrag gleich mit diesem Raum geteilt.

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_id ist 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/team zeigt 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.

Ein Navigationsbaum für Ablage, Akten und Vorgänge (seit 23.10.2026)

Der Baum „Meine Ablage“ steht links auf den Listenseiten und auf den Seiten von Akte und Vorgang. Die frühere Spalte „Struktur“ ist darin aufgegangen.

  • Aufklappen mit Fokus: Ein Klick auf eine Akte oder einen Vorgang öffnet ihn und klappt seine Struktur auf. Der Pfad dorthin bleibt offen, die aktuelle Zeile (auch ein Kapitel) ist hervorgehoben. Nach dem Neuladen der Seite stimmt der Fokus wieder.
  • Unter einer Akte: Überblick, „Direkt in dieser Akte“, Kapitel mit Unterkapiteln, Unterakten und die Vorgänge der Akte. Unter einem Vorgang: „Alle Inhalte“, Kapitel, Teilvorgänge. „Neues Kapitel“ und die Pfeile zum Verschieben stehen im Baum, solange der Eintrag offen ist.
  • Direkt von Vorgang zu Vorgang: Ein Vorgang erscheint unter jeder Akte, in der er liegt, und unter „Vorgänge“. Ein Klick unter einer Akte öffnet ihn in diesem Aktenkontext, unter „Vorgänge“ ohne Akte. Die frühere Auswahl des Handlungskontexts entfällt. Querverweise und weitere Akten stehen unter dem Titel des Vorgangs.
  • Nachladen: Die Wurzeln kommen aus /cases und /matters, die Struktur eines Knotens aus GET /cases/{id}/outline und GET /matters/{id}/outline, einmal beim Aufklappen. Die Antworten enthalten nur Lesbares (keine Inhalte). Ändert sich der offene Eintrag (Kapitel, Unterakte, Vorgang), lädt der Baum seine Struktur neu.
  • Breite und Dichte: Der Baum lässt sich an seiner rechten Kante mit der Maus ziehen (200 bis 560 Pixel, Pfeiltasten auf dem Griff, Doppelklick setzt zurück). Die Breite wird im Browser gemerkt (localStorage, Schlüssel tsumugu-tree-width); ohne Speicher gilt die Standardbreite. Zeilen und Einrückung sind kompakt, damit tiefe Strukturen hineinpassen.
  • Vorgang aus einer Akte lösen: Im Menü des Vorgangs steht „Aus Akte lösen“, wenn er in Akten liegt. Gelöst wird nur die Zuordnung zur gewählten Akte (DELETE /matter-case-links/{id}); der Vorgang, seine Inhalte und seine anderen Akten bleiben. Erlaubt ist es mit Bearbeitungsrecht in der Akte oder mit Teilen-Recht am Vorgang.

Herunterladen von Originalen (seit 23.10.2026)

  • Regel je Rolle: Das Recht „Herunterladen“ ist neben Lesen, Bearbeiten, Teilen und Löschen ein eigenes Recht. Der Eigentümer hat es immer. Über einen Raum folgt es der Rolle (Verwalter, Mitglied, Leser) laut Regel des Raums; direkt freigegebene Personen folgen dem Wert „direkt“ des Eigentümers. Ohne Leserecht gibt es kein Herunterladen.
  • Wo einstellen: Voreinstellung am Konto des Hauptnutzers („Mein Konto“, wird beim Anlegen eines Raums übernommen), danach je Raum in der Raumverwaltung (nur Eigentümer). Bestehende Daten bleiben erlaubt (Migration 20261023T090000Z_download_policy.sql).
  • Was geprüft wird (serverseitig): Speichern oder Öffnen des Originals (?save=true bei Dateien, Paperless-Dokumenten und Mail-Anlagen), die vollständige E-Mail (.eml) und das Übergabepaket. Lesen in Tsumugu bleibt möglich; die Regel ist ein Nutzungsrecht, kein Kopierschutz (Abfotografieren oder Entwicklerwerkzeuge verhindert sie nicht).
  • Dateiname: Gespeichert wird unter dem echten Namen (UTF-8, filename*), die E-Mail unter ihrem Betreff.
  • Endpunkte: GET/PUT /rooms/{id}/download-policy, GET/PUT /auth/download-defaults.

E-Mails als HTML

Die Mail wird formatiert (Standard) oder als Text gezeigt. Der Server bereinigt das HTML mit einer Positivliste (keine Skripte, Formulare, Rahmen, <style>-Blöcke; Formatierung nur aus erlaubten Eigenschaften, ohne url(), Position oder Ausdrücke; Bilder nur eingebettet als PNG/JPEG/GIF/WebP; Links nur http(s) und mailto, mit noopener). Im Browser läuft die Ansicht in einem Rahmen mit leerem sandbox (eigene Herkunft, keine Skripte), Content-Security-Policy default-src 'none'; img-src data: und ohne Referrer. Fremde Bilder werden nicht geladen.

Bilder in E-Mails nachladen

Bilder von fremden Servern bleiben standardmäßig draußen. „Bilder nachladen“ (oder die Einstellung „Automatisch nachladen“ unter „Mein Konto“, getrennt für Computer und Touch-Geräte, gespeichert im Browser; die Gerätegruppe folgt pointer: coarse) ruft GET /external-refs/{id}/mail/html-with-images auf. Der Server lädt die Bilder selbst und liefert sie eingebettet zurück, das Gerät kontaktiert den Absender nicht. Schutz (app/remoteimages.py): nur https auf Port 443, keine Zugangsdaten in der Adresse, Auflösung der Adresse einmal und Verbindung genau dorthin (kein DNS-Rebinding), alle Ergebnisse müssen öffentliche Adressen sein (kein Loopback, privat, Link-Local, Metadaten), höchstens drei Weiterleitungen mit gleicher Prüfung, 5 Sekunden, 1,5 MB je Bild, 12 Bilder und 6 MB je Nachricht, Prüfung des Inhalts an der Dateikennung (PNG, JPEG, GIF, WebP; kein SVG). Restrisiko: Der Absender sieht den Abruf und weiß damit, dass die Nachricht geöffnet wurde.

Handy

PDFs werden auf iPhone und iPad seitenweise mit pdf.js (Legacy-Build) gezeichnet, weil Safari PDFs in einem Rahmen nicht zuverlässig anzeigt (pages/DocumentView.jsx); die PDF-Vorschau in der Liste ist dort weiterhin eingeschränkt, die Leseansicht funktioniert. Der Rahmen der Ablage begrenzt die Höhe, damit die Liste in Akte und Vorgang scrollt, und der Kopf der Leseansicht ist am Handy kompakt.