Files
tsumugu/docs/architecture/RECHTEMODELL_IST.md
T
LarsandClaude Sonnet 5.5 1c2f045e7d Führe Raum-Eigentümer und Raumfreigabe ein, damit aus einem privaten Raum ein Mehrbenutzer-Raum wird.
Jeder Datenraum hat einen Eigentümer, der Verwalter bleibt, den Raum übertragen kann und im Notfall vom Betreiber ersetzt wird. Neue Akten und Vorgänge folgen der Voreinstellung des Raums: Bei "im Raum teilen" lesen Leser sie und bearbeiten Mitglieder und Verwalter; Weitergeben und Löschen bleiben beim Owner, der eine Akte privat stellen oder einzelne Personen ausnehmen kann. Bestehende Akten bleiben privat. Beim ersten weiteren Mitglied zeigt die Oberfläche, was sichtbar wird.

Das Löschen von Akte und Vorgang verlangt jetzt den Owner statt nur das Bearbeitungsrecht und schließt damit R-01. Die Rechte der Raumfreigabe gelten nur bei aktivem Raum, aktiver Mitgliedschaft und aktivem Konto.

Die lokale Suite läuft mit 128 Tests grün, der Frontend-Build und 19 Node-Tests ebenfalls. Die Oberfläche wurde noch nicht im Browser bedient.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-20 15:40:30 +02:00

7.3 KiB
Raw Blame History

Tsumugu – Rechteauswertung (Ist-Stand)

Stand: 18.10.2026, Commit f21c64a, ergänzt am 19.10.2026 um die Quellenauflösung. Erstellt im Code-Review aus backend/app/access/policy.py, api/deps.py und ops.py.

Fachlich gelten die bestätigten Entscheidungen der Produktspezifikation (F-01a–f, S-01b–d) und die vorläufigen MVP-Annahmen. Den Sollentwurf beschreibt die technische Spezifikation, Abschnitt 4.5 und 5. Diese Datei beschreibt, wie der Code entscheidet.

1. Vor jeder Fachroute

  1. Session (deps._session_row): Cookie-Hash muss zu einer nicht widerrufenen, nicht abgelaufenen Session eines aktiven Kontos gehören, sonst 401. Bei unsicheren Methoden muss X-CSRF-Token gleich dem Session-Token sein, sonst 403.
  2. Origin (Middleware in main.py): unsichere Methoden unter /api/ nur mit Origin aus ALLOWED_ORIGINS.
  3. Datenraum (deps.get_principal): X-Scope-Kind und X-Scope-Id müssen vorhanden sein und dem in der Session bestätigten Raum entsprechen. Persönlicher Raum nur der eigene, gemeinsamer Raum nur bei aktiver Mitgliedschaft. Sonst 403.

Der Datenraum bestimmt, wo neue Objekte entstehen. Er ist nicht der Rechtepfad. Objekte anderer Räume bleiben über Grants und Einbindungen erreichbar.

2. Rechte und Antwortcodes

Ein Ergebnis Rights(read, edit, share, delete) entsteht je Objekt und Handlungskontext. _require übersetzt:

  • read fehlt → 404 (das Objekt existiert für diese Person nicht)
  • read vorhanden, verlangte Fähigkeit fehlt → 403

Ausnahmen (access_grants.is_exception) entfernen Fähigkeiten im genannten Kontext. Sie gelten für alle Personen (grantee_subject_id IS NULL), auch für den Owner. Nur der Owner des Objekts setzt sie (PUT /exceptions).

3. Auswertung je Objektart

Akte (case_rights)

Fall Basis
Unterakte mit inherit_parent Rechte der Elternakte
Owner alle Rechte
sonst direkter Grant resource_kind='case'

Danach Abzug von Akten-Ausnahmen ohne Kontext (im Code vorgesehen, über die API nicht setzbar).

Vorgang (matter_rights)

Handlungskontext Basis Bedingung
keiner Owner = alle Rechte, sonst direkter Grant –
Akte C Rechte der Akte C Vorgang ist C zugeordnet, oder sein Elternvorgang ist C zugeordnet (dann Elternrechte in C)
Vorgang P direkte Rechte an P Vorgang ist Teilvorgang von P

Danach Abzug der Vorgangsausnahme genau in diesem Kontext. Ein Querverweis erzeugt keine Rechte.

Element (element_rights)

Handlungskontext Basis Bedingung
keiner Owner = alle Rechte, sonst direkter Grant –
Akte C Rechte der Akte C Element ist direkt in C eingebunden oder in einem Vorgang, der C erreicht. Im zweiten Fall darf kein case_link_blocks-Eintrag bestehen
Vorgang M direkte Rechte an M Element ist in M oder in einem Teilvorgang von M eingebunden

Danach Abzug der Elementausnahme in diesem Kontext.

Grenze: Eine Ausnahme am Vorgang im Aktenkontext wird für Elemente dieses Vorgangs nicht abgezogen (Review R-07).

Aufgabe und Frist (task_rights, deadline_rights)

Fall Basis
zugewiesene Person, ohne Kontext Lesen; Aufgabe zusätzlich edit, falls ein Grant es gibt. Status ändern über can_change_status
ohne Kontext Owner = alle Rechte, sonst direkter Grant
Kontext = eigener Vorgang direkte Rechte am Vorgang
Kontext = Akte Rechte des Vorgangs in dieser Akte
Kontext = Elternvorgang nur Aufgaben; bei Fristen fehlt dieser Zweig (Review R-15)

Danach Abzug der jeweiligen Ausnahme.

4. Schreibende Aktionen

Aktion Verlangte Rechte
Inhalt in Behälter anlegen edit am Zielbehälter im Kontext (require_container_edit)
Gemeinsamen Notiztext ändern edit am Element im Kontext
In weiteren Kontext einbinden share am Element im Quellkontext und edit am Ziel
Vorgang einer Akte zuordnen share am Vorgang und edit an der Akte. Inhalte, die die Person nicht freigeben darf, landen in case_link_blocks
Zuordnung lösen edit an der Akte oder share am Vorgang
Querverweis edit am Quellvorgang, read am Ziel in einem eigenen Kontext
Grant erteilen Owner oder share; can_edit nur mit eigenem edit, can_share nur mit eigenem share
Grant entziehen Owner der Ressource oder share
Einbindung lösen edit am Element im Kontext (Kontextzugehörigkeit unscharf geprüft, Review R-02)
Element überall löschen nur Owner des Elements
Akte oder Vorgang löschen edit (Review R-01: laut Rollentabelle nur Owner)
Reihenfolge, Kapitel, Ordnungsart edit am Behälter im Kontext; nur sichtbare Einbindungen; verborgene behalten ihre Position
Aufgabe zuweisen Owner oder share; legt ein Lese-Grant für die zugewiesene Person an
Export je ausgewähltem Inhalt read und share im Kontext

5. Sichtbarkeit in Listen und Antworten

  • Listen (list_cases, list_matters) filtern grob im SQL und prüfen danach jedes Objekt einzeln.
  • Einbindungen, Anmerkungen, Bezüge, Zuordnungen, Querverweise, Teilvorgänge und Elternnamen erscheinen nur, wenn die Person sie im jeweiligen Kontext lesen darf. Verborgenes wird weder benannt noch gezählt (visible_bindings_for_element, matter_title_if_readable).
  • Die Chronologie zeigt nur Ereignisse, deren Ressource im Seitenkontext lesbar ist (_event_title).
  • Breadcrumbs nennen nur lesbare Stationen. Bei mehreren lesbaren Aktenzuordnungen ohne gewählten Kontext erscheint keine Hauptakte.
  • Betreiber- und Verwalterrolle verleihen kein Leserecht auf persönliche Inhalte.
  • Raumfreigabe (cases.visibility, matters.visibility = room): Aktive Mitglieder eines aktiven Datenraums erhalten an Akten und Vorgängen mit diesem Heimatraum Rechte nach Rolle: Leser lesen, Mitglied und Verwalter lesen und bearbeiten, Weitergeben und Löschen nie (ROOM_RIGHTS, room_default in policy.py). Die Rechte werden mit Einzelfreigaben vereinigt, danach wirken Ausnahmen. Eine Personenausnahme (Grant mit is_exception auf eine Person, Kontext leer) nimmt eine Person aus. Der persönliche Raum kennt keine Raumfreigabe; Elemente und Aufgaben ohne Akte oder Vorgang bleiben beim Owner. Das Löschen von Akte und Vorgang verlangt Owner oder ausdrückliches Löschrecht, nicht mehr nur Bearbeiten (schließt R-01).
  • Plattform- und Raumrollen (Betreiber, Verwalter, Mitglied, Leser) und ihre Schutzregeln beschreibt BENUTZERVERWALTUNG.md. Der Leser legt im Raum nichts an und erhält dort keine Bearbeiten- oder Freigeben-Grants; die Auswertung der Objektrechte bleibt unverändert.
  • Ein Quellabruf prüft zuerst das Leserecht im Kontext. Danach wird nur der an der Referenz gebundene Zugang des Owners verwendet. Eine Suche ohne connector_id nimmt bei mehreren eigenen Instanzen nicht die zuletzt angelegte. Ein Empfänger erhält weder Zugangsdaten noch die übrigen Treffer des Owners. Ein Entzug gilt beim nächsten Abruf, weil jedes Lesen die Rechte erneut prüft.

6. Bekannte Abweichungen

Siehe Review-Befunde: R-01 (Behälter löschen), R-02 (Detach/Anmerkung), R-07 (Vorgangsausnahme), R-11 (Übersicht/Suche), R-12 (Teilvorgangstiefe), R-15 (Fristen im Elternkontext).