2.2 KiB
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-byundblocksin 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
- Betroffene Ticket-DoD und Dependencies konsistent.
- Passende fokussierte Tests und
verify:*-Gates grün. pnpm typecheck,pnpm lintundpnpm testgemäßdocs/AGENT-CHECKLIST.mdgrün.- Rollback-Pfad und Forward-only-DB-Vertrag in der Ticket-Doc dokumentiert.
- Plane-Kommentar und Status erst nach dem lokalen Proof aktualisieren.