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>
7.3 KiB
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
- Session (
deps._session_row): Cookie-Hash muss zu einer nicht widerrufenen, nicht abgelaufenen Session eines aktiven Kontos gehören, sonst 401. Bei unsicheren Methoden mussX-CSRF-Tokengleich dem Session-Token sein, sonst 403. - Origin (Middleware in
main.py): unsichere Methoden unter/api/nur mitOriginausALLOWED_ORIGINS. - Datenraum (
deps.get_principal):X-Scope-KindundX-Scope-Idmü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:
readfehlt → 404 (das Objekt existiert für diese Person nicht)readvorhanden, 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_defaultinpolicy.py). Die Rechte werden mit Einzelfreigaben vereinigt, danach wirken Ausnahmen. Eine Personenausnahme (Grant mitis_exceptionauf 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_idnimmt 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).