Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/docs/MID-STREAM-CHANGES.md
T

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.