81 lines
6.6 KiB
Markdown
81 lines
6.6 KiB
Markdown
# 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.
|