Dokumentation und Prozessmodell an den belegten Ist-Stand angleichen

Finding: F17 Priorität: P1 Status: OFFEN Stand: 2026-07-16

Problembeschreibung

• Planung, /doku/rechnung-prozess, /prozesse und Code sind inkongruent: Doku behauptet bestehende Playwright-Instanz, Code startet Chromium je Request.
• POSTED-State enthält falsches Datum.
• 10 Rechnungsprozesse/jüngste Dokus fehlen Migrationen.
• Legacy-Pfade /var/www/tmp/playwright-test stehen in Planung.

Ziel

Code, Regeln, Prozessmodell, Doku und Akzeptanzbelege sind kongruent; Einsatzreife ist evidenzbasiert.

Aufgabe

1. Single Source of Truth je Vertrag.
2. Jeden Schritt mit Code/Input/Output/Fehler/Idempotenz/Owner traceen.
3. Fertig/erfolgreich nur mit Evidenz.
4. Legacy markieren; Release Notes aus Gates.

Scope

• In Scope: alle unter Code Blast genannten Komponenten, Daten, Verträge und Tests.
• Out of Scope: neue Features und produktive externe Mutation ohne separate Freigabe.

Harte Spezifikation

• MUST: jede Behauptung mit Code/Test/Run.
• MUST: Schritte entsprechen Use Cases.
• MUST: Abweichungen verlinken Task.
• MUST: kein einsatzbereit bei P0; DB-Inhalte migriert.

Harte Quality Gateways

• Linkcheck 0 tote Links.
• Traceability jeder Rechnungsschritt.
• Reales PDF stimmt feldweise.
• Neuaufbau-DB gleiche Slugs.
• Global: PHPStan Level 8 und PHPUnit liefern 0 Fehler; kein Ignore oder Baseline.

Code Blast

• DB: Doku/Prozesse/Schritte/Artefakte/Links.
• Datei: planung/prozess-rechnung.md und Migrationen.

Code-Impact-Analyse

• Beseitigt falsche Einsatzreife.
• Doku wird Release-Gateway.

Risikoanalyse

| Risiko | Eintritt | Schaden | |---|---|---| | Betrieb folgt falscher Doku | hoch | hoch | | DB-Inhalt verloren/Drift | hoch | kritisch |

Strategie zur Risikonullierung

1. Prevent: Traceability/Migration.
2. Detect: Link/Drift/Evidenz.
3. Contain: P0 blockiert Release.
4. Recover: Baseline.

Abschlussnachweis

Erledigt erst, wenn alle MUST-Spezifikationen implementiert, alle Gateways mit unveränderlicher Evidenz grün und Restrisiken technisch ausgeschlossen oder ausdrücklich fachlich akzeptiert sind.