cleanup at death

migrations/README.md

@@ -65,3 +65,20 @@ negativen Ruf- und Eheeffekte für niedrige und mittlere Stände).
 Der Backend-Auftrag verwendet `performer_id`, `victim_id` und optional in
 `parameters` `goal` (`expose`, Standard; oder `blackmail`) sowie
 `relationship_id`. Details: `docs/FALUKANT_UNDERGROUND_INVESTIGATE_AFFAIR.md`.
+
+## `020_falukant_character_relation_cleanup.sql`
+
+Entfernt bestehende verwaiste Einträge aus `relationship`, `relationship_state`
+und `child_relation`. Sichert anschließend beide Beziehungspartner sowie Kind,
+Vater und Mutter mit Fremdschlüsseln und `ON DELETE CASCADE` ab. Damit werden
+die Verknüpfungen bei jeder Charakter-Löschung entfernt, auch außerhalb des
+Daemons. `relationship_state` wird zusammen mit der Beziehung gelöscht.
+Zeilen mit unbekanntem Elternteil (`NULL`) bleiben gültig.
+
+Voraussetzung: Migration `001` ist eingespielt. Die Migration läuft atomar,
+ist wiederholbar und sperrt Schreibzugriffe auf die betroffenen Tabellen für
+ihre Laufzeit. Nach Backup manuell auf der Ziel-DB ausführen:
+
+```bash
+psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f migrations/020_falukant_character_relation_cleanup.sql
+```