yourpart3/docs/FALUKANT_UNDERGROUND_AFFAIR_PLAN.md

Falukant: Restplan für Liebschafts-Ermittlung im Untergrund

Ziel

Die neue Untergrundaktivität investigate_affair soll nicht nur auswählbar sein, sondern einen vollständigen technischen Pfad bekommen:

• Aktivität anlegen
• Aktivität in der UI sichtbar machen
• Ergebnisstruktur vorbereiten
• externe Daemon-Auswertung eindeutig beschreiben

Arbeitspakete

UGA1. Aktivitätstyp im System verankern

Status: abgeschlossen

• Untergrundtyp investigate_affair anlegen
• Ziele expose und blackmail definieren
• UI-Auswahl in UndergroundView ergänzen
• Produktions-SQL für Bestandsdatenbank bereitstellen

UGA2. Aktivitätenliste im Frontend nutzbar machen

Status: abgeschlossen

• echten GET-Endpunkt für Untergrundaktivitäten bereitstellen
• UndergroundView.loadActivities() aktivieren
• Aktivitäten mit Typ, Ziel, Status und Zusatzinformation anzeigen

UGA3. Ergebnisstruktur für spätere Auswertung definieren

Status: abgeschlossen

• Ergebnisformat für underground.result dokumentieren
• Zustände pending, resolved, failed festlegen
• Felder für discoveries, visibilityDelta, reputationDelta, blackmailAmount vorbereiten

UGA4. Externe Daemon-Übergabe für Liebschafts-Ermittlung

Status: abgeschlossen

• Handoff-Dokument für den externen Daemon ergänzen
• beschreiben, wie investigate_affair gelesen und aufgelöst wird
• beschreiben, welche Folgewirkungen auf Liebschaften, Ansehen und Erpressung entstehen dürfen

UGA5. Spätere Ausbaustufe

Status: bewusst offen

• echte Erpressungszustände im Spielmodell
• UI für Forderungen, Schweigegeld, Gegenmaßnahmen
• eigene WebSocket-Events für abgeschlossene Untergrund-Ergebnisse

Definition of Done

Der lokale Teil gilt als fertig, wenn:

1. investigate_affair im Untergrundformular auswählbar ist
2. neue Aktivitäten in der Aktivitätenliste sichtbar sind
3. Typ, Ziel und Status in der UI lesbar sind
4. ein eindeutiges Result-Schema für den externen Daemon dokumentiert ist
5. die externe Daemon-Übergabe die neue Aktivität vollständig beschreibt

Restgrenze

Die tatsächliche Erfolgs-/Misserfolgsberechnung, das Aufdecken von Liebschaften und die Erpressungswirkung werden nicht in diesem Projekt ausgeführt, sondern im externen Daemon.