102 lines
9.5 KiB
Markdown
102 lines
9.5 KiB
Markdown
# 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).
|