404 lines
9.2 KiB
Markdown
404 lines
9.2 KiB
Markdown
# 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](/mnt/share/torsten/Programs/YourPart3/frontend/src/views/falukant/BankView.vue)
|
|
- Modell `falukant_data.debtors_prism` über [debtors_prism.js](/mnt/share/torsten/Programs/YourPart3/backend/models/falukant/data/debtors_prism.js)
|
|
- Kreditaufnahme und Bankübersicht im Backend in [falukantService.js](/mnt/share/torsten/Programs/YourPart3/backend/services/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`
|
|
|
|
```json
|
|
{
|
|
"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](/mnt/share/torsten/Programs/YourPart3/frontend/src/views/falukant/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.
|
|
|