# 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.