Versionskontrolle und reproduzierbare Quality-Toolchain herstellen

Finding: F18 Priorität: P2 Status: OFFEN Stand: 2026-07-16

Problembeschreibung

• Projektpfad ist kein Git-Repository.
• Kein Composer-, PHPUnit- oder PHPStan-Projektmanifest; globale Tools sind nicht gepinnt.
• Direkte DB-Änderungen ohne Migrationstracking lassen Code/DB/Doku keinem Release zuordnen.

Ziel

Jeder Release aus Code, DB, Doku und Qualitykonfiguration ist versioniert, reproduzierbar und rollbackfähig.

Aufgabe

1. Autoritativen Repository-Checkout herstellen.
2. Qualitytools/-config versionieren und Runtime trennen.
3. Commit-/Release-ID in Deploy/Doku.
4. CI-Gates für Syntax, Tests, PHPStan, LOC, Secrets, Migration.

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: Produktion referenziert immutable Artefakt.
• MUST: Toolversionen reproduzierbar.
• MUST: Secrets/PDF/State/Logs nie versioniert.
• MUST: Release bindet Migration/Doku; Rollback getestet.

Harte Quality Gateways

• Sauberer Checkout reproduziert Offline-Gates.
• Secret-/Large-file-Scan vor Initialcommit 0.
• Deploy zeigt Commit/Migration/Doku.
• Rollback ohne DB-Datenverlust.
• Global: PHPStan Level 8 und PHPUnit liefern 0 Fehler; kein Ignore oder Baseline.

Code Blast

• VCS/CI/Ignore/Deploymetadaten.
• Kein unmittelbarer Fachcodewechsel.

Code-Impact-Analyse

• Mehr Audit-/Rollbackfähigkeit.
• Initialimport braucht Secret-/Datenprüfung.

Risikoanalyse

| Risiko | Eintritt | Schaden | |---|---|---| | Nicht rollbackfähige Änderung | hoch | hoch | | Initialcommit enthält Secrets/Tooldrift | mittel | kritisch |

Strategie zur Risikonullierung

1. Prevent: Ignore/Secretgates.
2. Detect: CI/Fingerprint.
3. Contain: immutable Artefakte.
4. Recover: Rollback/DB Roll-forward.

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.