Files
tsumugu/docs/review/04_TECHNISCHE_SPEZIFIKATION.md
T
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

102 lines
9.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).