yourpart3/docs/FALUKANT_DEBTORS_PRISON_CONCEPT.md

Falukant: Schuldturm, Pfändung und wirtschaftlicher Zusammenbruch

Dieses Dokument beschreibt das Zielmodell für den Schuldturm in Falukant. Ausgangspunkt ist das bestehende Kreditsystem mit credit und dem bereits vorhandenen, aber noch ungenutzten Datenmodell debtors_prism.

1. Bestandsaufnahme

Bereits vorhanden:

• Kredite in falukant_data.credit
  • amount
  • remaining_amount
  • interest_rate
  • falukant_user_id
• Bankübersicht in BankView.vue
• Modell falukant_data.debtors_prism über debtors_prism.js
• Kreditaufnahme und Bankübersicht im Backend in falukantService.js

Noch nicht vorhanden:

• fällige Kreditraten mit Verzug
• automatische Mahnlogik
• echte Schuldturm-Logik
• Pfändung / Verwertung von Vermögen
• Reputations- und Sozialfolgen
• Beziehungsfolgen für Liebhaber/Mätressen
• UI für Haftstatus / wirtschaftlichen Zusammenbruch

Wichtig:

• debtors_prism existiert bereits, ist aber funktional bisher nicht eingebunden.
• Ein Teil der eigentlichen Tick-Logik gehört in den externen Daemon.
• Das Backend muss dennoch Datenmodell, APIs und UI-Basis bereitstellen.

2. Kernidee

Wer seine Kreditverpflichtungen über 3 Tage nicht bedient, kommt in den Schuldturm.

Schuldturm bedeutet:

• Verlust wirtschaftlicher Handlungsfähigkeit
• staatliche / herrschaftliche Pfändung
• Zwangsverwertung veräußerbarer Güter
• sozialer und familiärer Absturz

Das System soll nicht nur eine Geldstrafe sein, sondern ein spürbarer Statuswechsel im Spiel.

3. Auslöser

3.1 Kreditverzug

Der Daemon prüft täglich:

• welche Kreditrate fällig war
• ob sie bedient wurde
• wie viele Verzugstage bestehen

Regel:

• missed_days >= 3 bei mindestens einem aktiven Kredit
• danach Eintritt in den Schuldturm

3.2 Verhältnis zu Bankrott

Schuldturm ist der harte Bankrottpfad für private Kreditverschuldung.

Das bedeutet:

• nicht jeder Geldmangel führt sofort in den Schuldturm
• aber anhaltender Kreditverzug schon

Bankrott und Schuldturm können später getrennt modelliert werden:

• wirtschaftlicher Bankrott
• privater Kreditverzug / Schuldturm

Für die erste Stufe dürfen sie aber gekoppelt sein.

4. Zustand "im Schuldturm"

Ein Charakter im Schuldturm hat:

• kein normales wirtschaftliches Standing
• stark eingeschränkten Zugriff auf Vermögen
• massive Reputations- und Standesfolgen

Empfohlene Effekte:

• keine neuen Kredite
• keine neuen großen Investitionen
• keine Standeserhöhung
• keine neuen prestigeträchtigen Ämter
• evtl. eingeschränkte politische / kirchliche Karriere

5. Pfändungsreihenfolge

Beim Eintritt in den Schuldturm oder im Anschluss über mehrere Ticks wird Vermögen verwertet.

Empfohlene Reihenfolge:

1. frei verfügbares Geld
2. Transportmittel / Fahrzeuge
3. Lagerbestände / verwertbare Waren
4. Häuser / Hausbesitz
5. Schließung von Standorten / Niederlassungen

Wichtig:

• Nicht alles muss in einem Tick geschehen.
• Sinnvoll ist ein mehrstufiger Abbau, damit die UI den Prozess sichtbar machen kann.

6. Verwertbare Güter

6.1 Fahrzeuge

Transportmittel sollen verkauft werden, sofern sie nicht unpfändbar markiert sind.

Folgen:

• geringere Handlungsfähigkeit
• weniger Handelsoptionen

6.2 Lager und Waren

Lagerbestände und handelbare Waren sollen mit Abschlag verwertet werden.

Ziel:

• offene Kreditschuld reduzieren
• laufende Produktion destabilisieren

6.3 Haus

Das Haus soll gepfändet werden, wenn die Schuld nicht anders gedeckt werden kann.

Folgen:

• Rückfall auf ein niedrigeres Haus
• Einbruch bei Hauszustand, Hausstand und Dienerschaft
• negative Effekte auf Ehe, Haushalt und Stand

6.4 Niederlassungen

Standorte sollen geschlossen werden können, wenn Fahrzeuge/Waren/Haus nicht ausreichen.

Empfehlung:

• zuerst unrentable oder niedrigwertige Niederlassungen
• danach teurere / prestigeträchtigere

7. Soziale Folgen

7.1 Reputation

Beim Eintritt in den Schuldturm:

• spürbarer einmaliger Reputationsverlust

Während der Haft:

• täglicher oder periodischer weiterer Malus

7.2 Kreditwürdigkeit

Es braucht einen eigenen Zustand oder Wert:

• creditworthiness oder
• credit_penalty_level

Folgen:

• geringere availableCredit
• höhere Gebühren
• evtl. komplette Kreditsperre für längere Zeit

7.3 Liebhaber / Mätressen

Liebhaber/Mätressen können abspringen.

Wirkung:

• hohe Chance bei geringer Zuneigung oder niedriger Finanzierung
• höhere Chance bei öffentlich gewordenem Schuldturm
• repräsentative Beziehungen brechen eher bei massivem Statusverlust

Mögliche Folgen:

• Beziehungsende
• starke Senkung von affection
• Sichtbarkeit eines Skandals

7.4 Ehe und Familie

Der Schuldturm soll auch auf Ehe und Hausfrieden wirken:

• marriage_satisfaction sinkt
• household_tension_score steigt
• Kinder-/Erbpfad kann instabiler werden

8. Bezug zu bereits existierenden Systemen

Der Schuldturm soll sich an bestehende Falukant-Systeme ankoppeln:

• Kredite
• Haus / Dienerschaft
• Familie / Liebschaften
• Reputation
• Produktionszertifikat
• Sozialstatus

8.1 Produktionszertifikat

Bankrott / Schuldturm kann ein Sonderfall für Zertifikatsverlust sein.

Das passt zur bereits dokumentierten Regel:

• Herabstufung bei Bankrott

8.2 Sozialstatus

Während oder nach schwerem Schuldturm:

• kein Aufstieg im Stand
• evtl. spätere Herabstufung im Extremfall

Für die erste Stufe reicht:

• Aufstieg blockieren

9. Daemon-Aufgaben

Der externe Daemon soll:

9.1 täglich prüfen

• fällige Kreditraten
• bezahlte / unbezahlte Beträge
• Verzugstage je Kredit oder Nutzer

9.2 Schuldturm auslösen

Wenn Verzug >= 3 Tage:

• Schuldturmstatus setzen
• Reputations- und Kreditwürdigkeits-Malus anwenden
• Socket-Events senden

9.3 Verwertung durchführen

In geordneter Reihenfolge:

• Geld abbuchen
• Fahrzeuge verkaufen
• Waren verwerten
• Häuser pfänden
• Niederlassungen schließen

9.4 Familienfolgen anwenden

• Ehe verschlechtern
• Haushaltsspannung erhöhen
• Liebschaften destabilisieren

10. Event-Kommunikation zwischen Daemon und UI

Neue Events:

10.1 falukantUpdateDebt

{
  "event": "falukantUpdateDebt",
  "user_id": 123,
  "reason": "delinquency"
}

Mögliche reason:

• delinquency
• debtors_prison_entered
• asset_seizure
• branch_closure
• vehicle_liquidation
• house_seizure
• debtors_prison_released

10.2 UI-Reaktion

• Bankansicht neu laden
• Haus neu laden
• Niederlassungen neu laden
• Statusbar / Dashboard neu laden
• Familienansicht ggf. neu laden

Zusätzlich sinnvoll:

• Toast für Eintritt in den Schuldturm
• Toast für Pfändung / Zwangsverkauf

11. Backend-Aufgaben außerhalb des Daemons

Das Backend muss:

• Schuldturmstatus lesbar machen
• Bankansicht um Verzug / Haftstatus erweitern
• veräußerbare Güter für den Daemon eindeutig bereitstellen
• Endpunkte und UI-Infos für den Schuldturm liefern

11.1 Datenmodell

Da debtors_prism bereits existiert, bietet sich dieses Modell an für:

• character_id
• entered_at
• released_at
• status
• debt_at_entry
• remaining_debt
• reason

Falls die Tabelle noch nur character_id enthält, muss sie erweitert werden.

11.2 Bank-API

Die Bankübersicht soll später zusätzlich liefern:

• inDebtorsPrison
• daysOverdue
• nextForcedAction
• creditworthiness

12. UI-Anforderungen

12.1 Bank

In BankView.vue:

• Hinweis auf Zahlungsverzug
• Warnstufe bei 1 / 2 / 3 Tagen
• eigener Block für Schuldturmstatus

12.2 Übersicht / Status

In Falukant-Overview / StatusBar:

• sichtbarer Status "Schuldturm"
• evtl. reduzierter Handlungsstatus

12.3 Haus / Niederlassungen

• Hinweise bei Pfändung / Zwangsverkauf
• Schließungsereignisse sichtbar machen

12.4 Familie

• Hinweise auf abgesprungene Liebhaber / Mätressen
• Auswirkungen auf Ehe / Haushalt sichtbar

13. Empfohlene Umsetzung in Phasen

Phase D1: Basis

• debtors_prism fachlich ausbauen
• Bank-API um Verzug und Haftstatus erweitern
• UI-Warnungen in Bank und Status

Phase D2: Verwertung

• Fahrzeuge, Waren und Häuser als verwertbare Assets modellieren
• Daemon führt Pfändung schrittweise aus

Phase D3: Soziale Folgen

• Reputation
• Kreditwürdigkeit
• Liebhaber / Mätressen
• Ehe / Hausfrieden

Phase D4: Langfristige Folgen

• Produktionszertifikat
• Stand / Karriereblockaden
• eventuelle spätere Herabstufung

14. Offene Punkte

• genaue Kreditratenlogik im Daemon
• wie stark Häuser und Niederlassungen mit Abschlag verkauft werden
• ob Schuldturm zeitlich begrenzt oder rein schuldgetrieben endet
• ob Kreditwürdigkeit als eigener numerischer Wert gespeichert wird

15. Empfehlung

Für die erste echte Umsetzung:

1. debtors_prism ausbauen
2. Verzugstage im Daemon sauber pflegen
3. Eintritt in den Schuldturm sichtbar machen
4. zuerst Fahrzeuge/Waren/Haus, erst danach Niederlassungen

So bleibt der Spielzustand hart, aber nachvollziehbar und technisch gut integrierbar.