9.5 KiB
04 – Abgleich mit der technischen Spezifikation 0.3
Grundlage: docs/architecture/TSUMUGU_TECHNICAL_SPEC.md. Kennzeichen siehe 01.
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) |
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.
| 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).