Files
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

8.5 KiB
Raw Permalink 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, 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:

  • 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 (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_default in policy.py). Die Obergrenze der Freigabe (access = read) begrenzt auf Lesen. Mehrere Freigaben addieren sich, danach wirken Ausnahmen. Eine Personenausnahme (Grant mit is_exception auf 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). Verknüpfte Originale über die Zugänge des Owners liest ein Mitglied nur mit ausdrücklicher Quellenfreigabe im Raum (room_source_access, room_source_access() und mediated_source_owner in policy.py) oder mit der Einzelfreigabe use_owner_sources.
  • 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_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-12 (Teilvorgangstiefe), R-15 (Fristen im Elternkontext).