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

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