8.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, download) entsteht je Objekt und Handlungskontext. download (Original speichern oder öffnen, Übergabepaket) hat der Owner immer; über einen Raum folgt es data_rooms.download_roles der Rolle, bei direkten Grants dem Wert direct im Konto des Owners. Es setzt Leserecht voraus, und eine Ausnahme, die das Lesen entzieht, entzieht auch das Herunterladen. Verweigert wird mit 403 und einem erklärenden Text; Lesen in der App bleibt möglich. _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 (Tabelle
room_shares): Der Owner teilt eine Akte oder einen Vorgang mit beliebigen Datenräumen, in denen er Mitglied oder Verwalter ist. Der Heimatraum spielt dafür keine Rolle. Aktive Mitglieder eines aktiven Raums erhalten Rechte nach Rolle: Leser lesen, Mitglied und Verwalter lesen und bearbeiten, Weitergeben und Löschen nie (ROOM_RIGHTS,room_defaultinpolicy.py). Die Obergrenze der Freigabe (access = read) begrenzt auf Lesen. Mehrere Freigaben addieren sich, danach wirken Ausnahmen. Eine Personenausnahme (Grant mitis_exceptionauf eine Person, Kontext leer) nimmt eine Person aus. Elemente und Aufgaben ohne Akte oder Vorgang bleiben beim Owner. Die Rechte der Akte reichen in Vorgänge und Inhalte wie bisher; ein Vorgang kann einzeln geteilt werden, ohne dass die Akte sichtbar wird. Der Owner sieht seine Einträge unabhängig von Raum und Mitgliedschaft. Das Löschen von Akte und Vorgang verlangt Owner oder ausdrückliches Löschrecht, nicht mehr nur Bearbeiten (schließt R-01 des Reviews). - Kontoarten: Ein Mitarbeiter-Konto legt keine Räume an und keine Inhalte im persönlichen Raum an; es arbeitet in den eingeladenen Räumen nach Raumrolle (
ensure_can_create,require_main_user). Raum-Eigentümer und Einladende sind Hauptnutzer. Beschreibung in BENUTZERVERWALTUNG.md. - 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-12 (Teilvorgangstiefe), R-15 (Fristen im Elternkontext).