Files
tsumugu/docs/review/09_MASSNAHMENPLAN.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

81 lines
6.6 KiB
Markdown
Raw Permalink 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.
# 09 – Maßnahmenplan
Die Reihenfolge ist ein Vorschlag. Jede Stufe ist für sich lieferbar. Befund-IDs siehe [06_BEFUNDE.md](06_BEFUNDE.md). Vor jeder Korrektur zuerst den fehlenden Negativtest aus [07](07_TESTS_UND_CI.md#fehlende-negativtests-zu-den-befunden) schreiben. So wird der Fehler sichtbar und danach die Behebung belegt.
## Stufe 0 – sofort, ohne Code
| Maßnahme | Befund | Abnahme |
|---|---|---|
| Klären, ob die Produktion echte personenbezogene Daten hält. Falls ja: manuelles verschlüsseltes Backup von DB und Medien-Volume auf ein getrenntes Gerät, einmal probeweise zurückspielen | R-21 | Backup und erfolgreicher Testrestore dokumentiert |
| Merge nach `main` nur nach grünem Einzellauf von `test.yml` für denselben Commit | R-21, R-27 | Regel in `DEPLOYMENT.md` |
| Nach jedem Neuaufsetzen einer Umgebung sofort das Betreiberkonto anlegen | R-04 | in `DEPLOYMENT.md` vermerkt (erledigt) |
## Stufe 1 – Rechte und Datenintegrität (klein, hohe Wirkung)
| Maßnahme | Befund | Aufwand | Abnahme |
|---|---|---|---|
| Behälter löschen nur durch Owner; Oberfläche an `is_owner` koppeln | R-01 | klein | Bearbeiter erhält 403; Owner löscht |
| `_binding_in_page` in Detach und Anmerkung verwenden | R-02 | klein | fremde Einbindungs-ID → 404 |
| Vorgangs- und Teilvorgangsausnahmen in `element_rights` für den Aktenkontext abziehen | R-07 | klein | Datei eines gesperrten Vorgangs im Aktenkontext → 404 |
| `move_matter`: Ziel muss Wurzelvorgang sein, verschobener Vorgang ohne Teilvorgänge | R-12 | klein | zweite Ebene → 422 |
| `deadline_rights` um den Elternkontext ergänzen | R-15 | klein | Frist eines Teilvorgangs im Elternkontext lesbar |
| Globales Löschen entfernt `element_references`; Export lässt unsichtbare und gelöschte Ziele still weg | R-13 | klein | Export nach Löschen des Ziels möglich, kein Hinweis |
| Behälter löschen: Einbindungen lösen oder Wiederherstellung anbieten; Dialogtext anpassen | R-14 | klein bis mittel | Inhalte erscheinen beim Owner unter „nicht eingebunden“ |
| „Überall löschen“ an Element-Owner koppeln | R-16 | klein | Schaltfläche nur beim Element-Owner |
## Stufe 2 – Übersicht, Suche, Auslieferung
| Maßnahme | Befund | Aufwand | Abnahme |
|---|---|---|---|
| Offene Aufgaben, Fristen und Suche im SQL auf erreichbare Objekte vorfiltern, Cursor-Paging | R-11 | mittel | eigene Aufgabe sichtbar trotz 250 fremder offener Aufgaben |
| Anlagen und Fremddokumente als `attachment`, Inline-Allowlist ohne SVG, Sandbox-CSP; Frontend öffnet nur erlaubte Typen | R-03 | klein | HTML-Anlage wird heruntergeladen, nicht gerendert |
| Rasterbilder serverseitig neu kodieren, Metadaten entfernen | R-31 | mittel | hochgeladenes Foto ohne EXIF/GPS |
| Suche nur über Blocktexte | R-19 | klein | „paragraph“ findet keine beliebige Notiz |
| Unbekannte Zeichensätze abfangen | R-20 | klein | Mail mit `charset=x-unknown` lesbar |
## Stufe 3 – Auth- und Transaktionsverträge
| Maßnahme | Befund | Aufwand | Abnahme |
|---|---|---|---|
| Web-Bootstrap durch Host-Token oder CLI ersetzen; Betreiber-MFA (TOTP) | R-04 | mittel | kein Betreiber ohne MFA; Bootstrap-Route ohne Token 404 |
| Sessions: Leerlaufablauf, Rotation, persistente Login-Begrenzung, bcrypt-Dummy, konstantzeitlicher CSRF-Vergleich, Passwortwechsel, Logout-all; alternativ längere Laufzeit begründet festhalten | R-08 | mittel | Auth-Blueprint S01–S08, B03, R06 als Tests |
| Kontoauflösung per E-Mail begrenzen | R-08 | klein | keine ID-Auskunft über beliebige Konten |
| Transaktion explizit im Use-Case; externe Aufrufe außerhalb der Transaktion | R-22, R-23 | mittel | Test „Commit-Fehler → kein 2xx“; Quellenaufruf ohne gehaltene Verbindung |
| Export streamen, Gesamtgrenze | R-22 | mittel | Paket über Grenze wird vor dem Bauen abgelehnt |
| Eigenes Runtime-Passwort, Migration als eigener Schritt, Advisory-Lock, Fehlend-Prüfung | R-09 | mittel | Backend-Container ohne Owner-Zugang |
| Quellen-Secrets verschlüsseln | R-05 | klein | Dump enthält keine Klartext-Token |
| Paperless-Weiterleitungen sperren, optional Host-Allowlist | R-06 | klein | Weiterleitung auf fremden Host → Fehler ohne Token-Weitergabe |
| Zugang fest an die Referenz binden, Abruf über den Element-Owner | R-10 | mittel | Ben sieht Adas Paperless-Dokument, nie ein fremdes gleicher Nummer |
| Fehlende Audit-Ereignisse und Labels | R-18 | klein | Protokoll zeigt Login, Scopewechsel, Statusänderung, Zuweisung |
## Stufe 4 – Paket P7 und CI
| Maßnahme | Befund | Aufwand | Abnahme |
|---|---|---|---|
| Produktprofil mit RPO/RTO (Start: 24 h / 4 h) | R-21 | klein | Profil dokumentiert |
| Backup DB + Medien nach gemeinsamem Freeze, `age`-verschlüsselt, unabhängige Kopie, Aufbewahrung 7/4/3 | R-21 | mittel | `COMPLETE`-Beleg; monatliche Restore-Übung |
| Restore in neue Generation, Sessions widerrufen, Konten zunächst gesperrt | R-21 | mittel | synthetischer Drill mit gemessener Dauer |
| Release-Gate vor `deploy-prod` (R2: Prod-Kandidat bauen, testen, dann umschalten) | R-21 | mittel | roter Test verhindert Prod-Umschaltung |
| `test.yml`: ein Auslöser, Concurrency, Testdatenbank je Lauf, Node-Tests | R-27 | klein | keine Doppelläufe |
| RLS-Prüfung nach ADR-06 und technischer Spezifikation 5.6 | R-21 | mittel | dokumentierte Entscheidung, bei Einführung Pool-Tests |
| HSTS am Synology-Proxy nachweisen, `X-Forwarded-Proto` nur vom Proxy | R-21, R-28 | klein | Header-Nachweis |
## Stufe 5 – Qualität und Pflege
| Maßnahme | Befund |
|---|---|
| Request-ID, stabile Problem-Typen, Readiness mit Migrationsstand, OpenAPI in Development als CI-Artefakt | R-24 |
| Transport mit Timeout und Abbruch, robustes Fehlerparsing, 401 setzt Sitzung zurück | R-25 |
| Hash-gebundene Python-Locks, exakte npm-Versionen, Basisimages mit Digest; Versionssprung React/Vite/Router als eigener Auftrag | R-26 |
| Verwaltungsdialoge: Einladung, Zuweisung, Mitglied entfernen/befördern, Konto sperren | R-29 |
| Mehrumfang als Fachpunkte nachtragen; technische Spezifikation 0.4 mit Abweichungsregister | R-17 |
| `.gitignore` um Testhilfsordner ergänzen | R-30 |
| Drag-and-drop-Nachweis UX-17 dokumentieren | – |
## Abhängigkeiten
- Stufe 1 ist unabhängig und sollte vor jeder Erweiterung kommen.
- R-10 (Zugang an der Referenz) entspricht dem ersten Schritt des Connector-Umbaus aus dem Connectoren-Befund. Beide sollten gemeinsam geplant werden.
- R-22/R-23 (Transaktionsschnitt) erleichtert R-10 und den Export-Stream. Daher zuerst R-23.
- Stufe 4 ist Voraussetzung für echte personenbezogene Daten in der Produktion und muss vor dem Finanzausbau (P4b) stehen, weil dann noch sensiblere Daten hinzukommen.