Files
tsumugu/docs/review/04_TECHNISCHE_SPEZIFIKATION.md
LarsandCursor d6b70d8f92
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Failing after 2m18s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 10s
Schließe die Connector-Kapselung ab, damit Paperless, IMAP und weitere Quellen über dieselbe Anbindung laufen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 15:00:50 +02:00

9.5 KiB
Raw Permalink Blame History

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).