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

6.6 KiB
Raw Permalink Blame History

09 – Maßnahmenplan

Die Reihenfolge ist ein Vorschlag. Jede Stufe ist für sich lieferbar. Befund-IDs siehe 06_BEFUNDE.md. Vor jeder Korrektur zuerst den fehlenden Negativtest aus 07 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.