# 04 – Abgleich mit der technischen Spezifikation 0.3 Grundlage: `docs/architecture/TSUMUGU_TECHNICAL_SPEC.md`. Kennzeichen siehe [01](01_METHODIK_UND_QUELLEN.md#nachweiskennzeichnung). ## 1. Umsetzungspakete | Paket | Soll laut Abschnitt 8 | Status | Belege und Abweichungen | |---|---|---|---| | P0 Foundation und Rand | `create_app`, Settings, Pool, Migrations-CLI, sichere Health-URLs, Problem-Details, Backend nur an `127.0.0.1`, Security-Header, Runtime-Rolle ohne DDL | 🟡 | ✅ Health `{status, app}`, `/health/live`, `/health/ready`, OpenAPI aus, Backend-Port `127.0.0.1`, CSP und Header im Frontend-Nginx, Psycopg 3 mit Pool, Runtime-Rolle ohne `CREATE` (Test `test_runtime_role_cannot_create_tables`), unbekannte Umgebung startet nicht. Abweichungen: Runtime-Rolle mit dem Owner-Passwort, Migration ohne Advisory-Lock, Backend-Container hält DDL-Zugang (R-09); `app = create_app()` beim Import liest Settings (Import ohne Umgebung scheitert); keine Request-ID (R-24) | | P1 Identität und Policy | Einladung, Session-Cookie, persönlicher und gemeinsamer Raum, Grant-Auswertung, Audit | 🟡 | ✅ Cookie-Session mit gehashtem Token, CSRF, Originprüfung, Räume und Mitgliedschaft, Grants, 401/403/404-Semantik. Abweichungen: Betreiber über Web-Bootstrap statt CLI mit MFA (R-04), 14 Tage Laufzeit, keine Rotation (R-08), Auditlücken (R-18), Einladung ohne Oberfläche (R-29) | | P2 Struktur und Notizen | Akte, Unterakte, Vorgang, Teilvorgang, Kapitel, Einbindung, Anmerkung, Chronologie, Oberfläche | ✅ | Tests T-ISO, T-SHARE, T-DETACH, T-CONTEXT. Einzelbefunde R-01, R-02, R-07, R-12 | | P3 Eigene Dateien und Referenzen | Upload, geschützter Download, externe Referenz ohne Live-Abgleich, Storage-Ausfall 503 | 🟡 | ✅ PDF/PNG/JPEG/WebP per Magic-Byte-Prüfung, Download mit Einbindungs- und Assetrecht, Detach löscht keine Bytes, `storage_unavailable` 503. Abweichungen: einstufiger Multipart-Upload ohne Quarantäne, Normalisierung und Metadatenentfernung (R-31); Paperless und IMAP über Live-Connectoren statt nur manueller Referenz (über die Spezifikation hinaus, durch Folgeaufträge gedeckt) | | P4a Aufgaben und Fristen | Aufgaben, unabhängige Fristen, Verknüpfungen | ✅ | Tests T-DL-01, T-ANCHOR-01. Befund R-15 | | P5a Übersicht und Suche | Offene Aufgaben/Fristen, berechtigte Suche, Counts | 🟡 | ohne Trefferleck. Limit vor Rechteprüfung lässt sichtbare Treffer fallen (R-11) | | P4b Finanzen | – | ⏸ | – | | P5b Sichten und Zusammenstellungen | – | ⏸ | – | | P6 Paperless-Abgleich | – | ⏸ | – | | P7 Erster echter Betrieb | Qualifiziertes Release, Backup DB und Medien, Restore-Übung, RLS-Prüfung, HSTS-Nachweis, RPO/RTO | ❌ | nichts davon im Repository; `main` deployt direkt (R-21) | ## 2. Datenmodell (Abschnitt 4) | Vorgabe | Status | Bemerkung | |---|---|---| | UUIDs, `version` für 409, `home_scope_id`, Owner, `deleted_at` an Ankern | ✅ | `cases`, `matters`, `elements`, `tasks`, `deadlines` | | Strukturelle Elternschaft im selben Heimatraum per Composite-FK (Invariante 3) | ✅ | `cases_parent_same_scope`, `matters_parent_same_scope`, `chapters_*_same_scope`, Trigger für Kapitel-Eltern | | Zuordnung, Querverweis, Einbindung, Grant dürfen Datenraum kreuzen (Invariante 4) | ✅ | keine Scope-Gleichheit an `bindings`, `matter_case_links`, `access_grants` | | `bindings` mit Position, Kapitel, Richtung je Einbindung | ✅ | `release_state` fehlt, gehört zu P5b | | `correspondence_dates` getrennt, `recorded_at = created_at` | ✅ | – | | `access_grants` mit Ausnahmen in einem Schema | ✅ | `is_exception`, `grantee_subject_id IS NULL` für Kontextausnahme | | `domain_events` append-only, ohne Notiztexte | ✅ | Audit trägt `context_kind/id` und `occurred_on`. `result` immer `ok` | | Medientabellen nach Datei-Blueprint | 🟡 | `media_assets`, `media_operations` minimal; keine Leases, keine Purge-Zwischenzustände mit Wirkung (Status wird im selben Schritt auf `purged` gesetzt) | | `content_order`, `content_order_dir`, Startwert Datum aufsteigend für neue Objekte | ✅ | Bestand bleibt `position` | | Nicht spezifiziert, aber vorhanden | – | `connectors`, `external_references.detail`, `element_references`, `task_element_links`, `task_dependencies`, `case_link_blocks`, `auth_invitations`, `auth_accounts.is_superadmin/origin` (siehe [DATENMODELL_IST](../architecture/DATENMODELL_IST.md)) | ## 3. Invarianten (Abschnitt 4.4) | Nr. | Invariante | Status | Bemerkung | |---|---|---|---| | 1 | Genau ein Heimatraum und Owner; Einbindung, Zuordnung, Zuweisung ändern sie nicht | ✅ | – | | 2 | Teilvorgang genau ein Elternvorgang | ✅ | Spaltenmodell. Tiefe über `move_matter` ungeprüft (R-12) | | 3 | Strukturelle Elternschaft im Heimatraum | ✅ | Composite-FKs | | 4 | Querbeziehungen dürfen Räume kreuzen | ✅ | – | | 5 | Notiztext einmal | ✅ | – | | 6 | Anmerkung an genau einer Einbindung | ✅ | Kontextprüfung beim Anlegen unscharf (R-02) | | 7 | Sicht nur mit Leseprädikat | ✅ | feste Sichten filtern pro Objekt | | 8 | `pending` in Zusammenstellungen | ⏸ | P5b | | 9 | Detach löscht Einbindung, Element bleibt | ✅ | – | | 10–11, 13 | Finanzinvarianten | ⏸ | – | | 12 | Unsichtbares fehlt in Liste, Suche, Count, Chronologie, Download, Export, ohne Titel und Anzahl | 🟡 | eingehalten in Liste, Suche, Chronologie, Export-Baum. Abweichungen: Export-Prüfung meldet „Antwortbezug lässt sich nicht auflösen“ für ein unsichtbares Gegenstück (R-13); Element-Endpunkte ignorieren Vorgangsausnahmen (R-07) | ## 4. Zugriff (Abschnitt 5) | Vorgabe | Status | Bemerkung | |---|---|---| | 5.1 Kein Leserecht für Betreiber oder Manager auf persönliche Inhalte | ✅ | Test `test_manager_does_not_read_a_personal_case` | | 5.2 Rollentabelle: Löschen des Behälters nur Owner | ❌ | `delete_case`/`delete_matter` verlangen nur `edit` (R-01) | | 5.2 Owner ist `owner_subject_id`, keine Übertragung | ✅ | – | | 5.3 Auswertung im Handlungskontext, keine Vereinigung, Lesen fehlt → 404, Fähigkeit fehlt → 403 | ✅ | `_require` in `policy.py` | | 5.3 Schritt 4: Ausnahme im Kontext entfernt Rechte | 🟡 | Element- und Vorgangsausnahmen wirken. Vorgangsausnahmen wirken nicht auf Inhalte (R-07) | | 5.4 Neue Einbindung: `share` am Element und `edit` am Ziel | ✅ | `bind_element` | | 5.4 Globales Löschen nur Owner, Paperless bleibt | ✅ | `delete_element` | | 5.4 Querverweis nur sichtbar, wenn Ziel lesbar | ✅ | `matter_title_if_readable` | | 5.5 Zugewiesene Person: lesen und Status ändern, sonst nichts | ✅ | `task_rights`, `can_change_status`. Zuweisen nur per API (R-29) | | 5.6 RLS als zweite Linie vor echtem Betrieb | ❌ | nicht geprüft, nicht vorhanden (R-21) | ## 5. API-Verzeichnis (Abschnitt 6.2) Die vollständige Liste der registrierten Endpunkte steht in [API_REFERENZ.md](../architecture/API_REFERENZ.md). | Vorgabe | Status | Bemerkung | |---|---|---| | `/api/v1`, `snake_case`, UTC mit `Z`, `YYYY-MM-DD` | ✅ | – | | Eingaben ohne unbekannte Felder | ✅ | `APIModel(extra="forbid")`. Multipart-Upload ausgenommen | | Anlage 201 mit `Location`, Löschen 204, Listen `{items, next_cursor}` | 🟡 | `POST /cases/{id}/delete` und `/matters/{id}/delete` antworten 200 `{ok: true}`; `next_cursor` fast überall `null` ohne echte Seiten (R-11) | | Problem-Details | 🟡 | Felder `type, title, status, detail, instance, code`; `type` immer `about:blank`, keine `request_id` (R-24) | | Handlungskontext als Query bzw. `context` im Body | ✅ | durchgängig | | `POST /invitations`, `/accept` | ✅ | API vorhanden, keine Oberfläche | | `PATCH /notes/{id}` mit `visible_bindings` und stehendem Hinweis | ✅ | `note_update_payload`, `SHARED_NOTICE` | | `/views/open-reimbursements`, Finanz- und Zusammenstellungsrouten | ⏸ | korrekt nicht registriert | | Medienpfade nach Datei-Blueprint (U0–U3) | 🟡 | einfacher Multipart-Upload `POST /files` | ## 6. Geplante Nachweise (Abschnitt 8.1) | ID | Status | Testfall | |---|---|---| | T-ISO-01, T-ISO-02 | ✅ | `test_rights.py::test_t_iso_hides_unshared_case_note_file_search_and_chronology` | | T-SHARE-01 bis 04 | ✅ | `test_rights.py::test_t_share_text_annotation_and_hidden_binding_count` | | T-CONTEXT-01 | ✅ | `test_rights.py::test_t_context_uses_only_the_requested_case` | | T-DETACH-01 | ✅ | `test_rights.py::test_t_detach_keeps_the_other_binding` (nur Positivfall, siehe R-02) | | T-GRANT-01 | ✅ | `test_rights.py::test_t_grant_edit_does_not_create_a_new_binding` | | T-DL-01 | ✅ | `test_tracking.py::test_t_dl_completed_task_leaves_the_deadline_open` | | T-ANCHOR-01 | ✅ | `test_tracking.py::test_t_anchor_assignee_sees_the_task_but_not_the_hidden_matter` | | T-COMP-01/02, T-ANCHOR-02, T-FIN-01 bis 06, T-META-01/02 | ⏸ | gehören zu P4b, P5b, P6 | ## 7. Betrieb (Abschnitt 8.2) Laut Spezifikation darf Entwicklung den heutigen Deploy-Weg für synthetische Daten nutzen; „Produktion mit echten Akten wartet auf P7“. Der Workflow `deploy-prod.yml` baut und startet bei jedem Push auf `main`, ohne vorgelagerte Tests und ohne Backup. Ob die Produktion schon echte Daten hält, war im Review nicht feststellbar. Siehe R-21. ## 8. Rückfragen (Abschnitt 10) Die vier Produktfragen sind als vorläufige Annahmen in `docs/MVP_ANNAHMEN.md` übernommen und im Code so umgesetzt: Kontext der Aktion gilt, neue Sicht nur mit Freigabe- und Zielbearbeitungsrecht, Detach entfernt Einbindung samt Anmerkungen, globales Löschen nur durch den Owner, Aktenvererbung mit `case_link_blocks` für nicht freigebbare Inhalte. Nicht durch die Annahmen gedeckt ist das Löschen ganzer Behälter durch Bearbeiter (R-01).