Zweite Hälfte von #100 (P2, Nightbot-Befund): schema_migrations kannte
bisher nur den Dateinamen, keine Prüfsumme. Wurde eine bereits
angewendete Migrationsdatei nachträglich bearbeitet (versehentlich,
Merge-Konflikt o. Ä.), lief der nächste `pnpm migrate` klaglos durch –
die Änderung wurde nie angewendet, Umgebungen konnten unbemerkt
auseinanderdriften. Außerdem gab es keine Sperre: zwei gleichzeitige
Migrationsläufe (z. B. zwei parallele Deploys) hätten sich in die
Quere kommen können.
- Neue Spalte schema_migrations.checksum (SHA-256 des Dateiinhalts,
ALTER TABLE ... ADD COLUMN IF NOT EXISTS für bestehende Installationen).
Bereits angewendete Migrationen ohne gespeicherte Prüfsumme werden
einmalig nachgetragen; weicht eine vorhandene Prüfsumme vom aktuellen
Dateiinhalt ab, bricht die Migration mit klarer Fehlermeldung ab statt
die Änderung stillschweigend zu ignorieren.
- GET_LOCK('kc_migrate', 10) um den gesamten Lauf (selbes Muster wie die
Audit-Hash-Kette), verhindert parallele Migrationsläufe.
- Sauberer Fehlerausstieg (Meldung + Exit-Code) statt Stack-Trace.
Gegen die Testdatenbank durchexerziert: Prüfsummen-Nachtrag, No-Op-
Wiederholung, manipulierte Prüfsumme (bricht korrekt ab), danach wieder
sauberer Lauf. Gegen die echte Produktionsdatenbank angewendet: alle 31
bestehenden Migrationen jetzt mit Prüfsumme, kc-api läuft weiter.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
b64cec21a4