Die Raumfreigabe hängt nicht mehr am Heimatraum. Der Owner teilt eine Akte, Unterakte oder einen Vorgang mit jedem Raum, in dem er schreiben darf; die Mitglieder erhalten Rechte nach ihrer Rolle, begrenzbar auf nur lesen, mit Personenausnahme. Ein einzelner Vorgang lässt sich teilen, ohne die Akte oder die anderen Vorgänge offenzulegen. Wer ein Team verlässt oder Leser wird, nimmt seine Freigaben mit; wer entfernt wird, arbeitet danach im persönlichen Raum und sieht weiter alles, was ihm gehört. Der Heimatraum ist nur noch Ablage. Die Migration übernimmt die bisherigen Raumfreigaben in die neue Tabelle room_shares und wurde mit Bestandsdaten geprüft. Die Sitzung meldet einen Raumwechsel jetzt mit eigenem Fehlercode, die Oberfläche lädt sie dann neu. Die lokale Suite läuft mit 132 Tests grün, der Frontend-Build ebenfalls. Die Oberfläche wurde noch nicht im Browser bedient. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
103 lines
7.6 KiB
Markdown
103 lines
7.6 KiB
Markdown
# 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](../product/TSUMUGU_PRODUCT_SPEC.md) (F-01a–f, S-01b–d) und die vorläufigen [MVP-Annahmen](../MVP_ANNAHMEN.md). Den Sollentwurf beschreibt die [technische Spezifikation, Abschnitt 4.5 und 5](TSUMUGU_TECHNICAL_SPEC.md). 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** (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).
|
||
- Plattform- und Raumrollen (Betreiber, Verwalter, Mitglied, Leser) und ihre Schutzregeln beschreibt [BENUTZERVERWALTUNG.md](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](../review/06_BEFUNDE.md): 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).
|