Füge Migration für Untergrundauftrag 'investigate_affair' hinzu und aktualisiere die Dokumentation

docs/FALUKANT_UNDERGROUND_INVESTIGATE_AFFAIR.md

@@ -4,7 +4,9 @@ Wie die anderen Underground-Tasks: Zeile in `falukant_data.underground` mit `res
 
 ## Typ in der Datenbank
 
-In `falukant_type.underground` einen Eintrag mit **`tr = 'investigate_affair'`** und Backend-Logik, die den Auftrag anlegt.
+Migration **`019_falukant_investigate_affair.sql`** registriert den Eintrag
+**`tr = 'investigate_affair'`** in `falukant_type.underground`. Das Backend legt
+den Auftrag an.
 
 ## Semantik (Spec: Liebschaften & Untergrund)
 

migrations/019_falukant_investigate_affair.sql

@@ -0,0 +1,11 @@
+-- Untergrundauftrag: Liebschaft ausspionieren / aufdecken.
+-- Die Auswertung erfolgt im UndergroundWorker nach der normalen Wartezeit von 1 Tag.
+-- Siehe docs/FALUKANT_UNDERGROUND_INVESTIGATE_AFFAIR.md.
+
+INSERT INTO falukant_type.underground (tr)
+SELECT 'investigate_affair'
+WHERE NOT EXISTS (
+    SELECT 1
+      FROM falukant_type.underground
+     WHERE tr = 'investigate_affair'
+);

migrations/README.md

@@ -53,3 +53,15 @@ Dieses Recht erlaubt den WebSocket-Endpoint `getWorkerSchedules` (Daemon-Laufpla
 
 - Nutzer mit Rechtstitel `admin`
 - Nutzer mit Rechtstitel `worker_schedule_read`
+
+## `019_falukant_investigate_affair.sql`
+
+Registriert den Untergrundtyp **`investigate_affair`**. Der `UndergroundWorker`
+wertet den Auftrag nach einem Tag aus: Bei Erfolg wird eine aktive Liebschaft
+aufgedeckt, wodurch Sichtbarkeit steigt und Diskretion sinkt. Ab Sichtbarkeit
+60 greifen im Familien-Tick die standsabhängigen Folgen (insbesondere die
+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`.