43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
# Mid-Stream-Änderungen — Rollback-Playbook
|
|
|
|
**Zweck:** Ein laufendes Ticket sicher korrigieren, ohne abhängige Tickets oder bereits ausgelieferte Daten zu beschädigen.
|
|
|
|
## Grundsatz
|
|
|
|
- Plane hält Status und Dependencies; die Ticket-Doc hält Scope, DoD, Rollback und Proof.
|
|
- Änderungen werden an atomaren Checkpoints committed. Ein Rollback erfolgt mit `git revert`, nicht durch Umschreiben veröffentlichter Historie.
|
|
- Vor Contract-, Schema- oder Scope-Änderungen werden `blocked-by` und `blocks` in beide Richtungen geprüft.
|
|
|
|
## Eingriffsstufen
|
|
|
|
### 1. UI/Wording
|
|
|
|
Interim-UI beziehungsweise Subframe-Adapter korrigieren, Visual-Baseline nachziehen und die stabile VM-/Action-Grenze beibehalten. Keine fachliche Logik in Routes oder UI verschieben.
|
|
|
|
### 2. View-Model oder Domain-Logik
|
|
|
|
Pure VM-Builder, Zod-Schema und fokussierte Tests gemeinsam ändern. Bei Schreiblogik zusätzlich Audit, Activity, Notifications, Permission- und RLS-Kontext prüfen.
|
|
|
|
### 3. Datenmodell oder öffentlicher Contract
|
|
|
|
- Neue Forward-only-Migration; angewandte Migrationen nicht umbenennen oder editieren.
|
|
- Inverse-SQL als Kommentar dokumentieren.
|
|
- Alle abhängigen Ticket-Docs und Konsumenten im selben Änderungsschnitt nachziehen.
|
|
- Prisma-Validierung, Migrations-Parität, RLS-Verträge und fokussierte Consumer-Tests ausführen.
|
|
|
|
### 4. Ticket-Ansatz verwerfen
|
|
|
|
Noch nicht gemergte Checkpoints gezielt reverten oder den Branch verwerfen. Bereits gemergte Änderungen ausschließlich über neue Revert-/Fix-Commits korrigieren. Ticket-Doc mit Ursache, Auswirkungen, neuem Plan und aktuellem DoD-Prozentsatz aktualisieren.
|
|
|
|
## Notbremse
|
|
|
|
Wenn ein ausgeliefertes Modul einen vorhandenen Feature- oder Ingress-Schalter besitzt, ihn kontrolliert deaktivieren und die operative Auswirkung dokumentieren. Kein neuer Schalter außerhalb des Ticket-Scopes und kein Deploy-Bypass.
|
|
|
|
## Pflichtnachweise vor Push
|
|
|
|
1. Betroffene Ticket-DoD und Dependencies konsistent.
|
|
2. Passende fokussierte Tests und `verify:*`-Gates grün.
|
|
3. `pnpm typecheck`, `pnpm lint` und `pnpm test` gemäß `docs/AGENT-CHECKLIST.md` grün.
|
|
4. Rollback-Pfad und Forward-only-DB-Vertrag in der Ticket-Doc dokumentiert.
|
|
5. Plane-Kommentar und Status erst nach dem lokalen Proof aktualisieren.
|