Bind player negotiations and release cancelled contract quotes (by Codex)

This commit is contained in:
Codex committed 2026-10-28 12:57:40 +01:00
1 parent e9483048f4
commit 622973c2cf
18 files changed
+381 -28

No files matched your search

+37 -1
View File
@@ -17,7 +17,7 @@ werden. Die Quelle wird nicht in DemoSource überführt.
## Gebundener Umfang
- `ModernSession::ui_read`: `session`, `desktop`, `camps`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`, `environment`, `advertising`. Karriere, Manager,
- `ModernSession::ui_read`: `session`, `desktop`, `camps`, `squad`, `lineup`, `tactics`, `training`, `bank`, `stadium`, `credit`, `environment`, `advertising`, `contracts`. Karriere, Manager,
Mannschaft, Datum, Saison, Geld, Lagerqualitäten und Angebote kommen aus der
Engine. Katalog und Engine müssen dieselbe Welt-ID und Datenrevision haben.
- Der bestehende RmlUI-Schreibtisch verwendet die gemeinsamen App-Buttons und
@@ -135,6 +135,42 @@ Native Tests bestätigen acht echte Änderungen, schreibgeschützte Abbrüche,
einen sauberen bestätigten No-op, bestehende Liefersperren und OBS-Neustarts.
Nachweise: `bmh_4k_ui/docs/qa/engine-commerce-2026-10-28/`.
## Spielerverträge
Die [drei Vertragstabellen](../desktop/contracts/README.md) zeigen tatsächliche
Gehälter, Laufzeiten, Versicherung und Kaderwerte. Öffnen und Browsing fragen
keine Gehaltsforderung ab. Erst „Forderungen abfragen“ verwendet den vorhandenen
Command `quote.request {kind: contract, playerId}`. Der Read liefert danach die
Quote-ID, vier Forderungen und die maximale Monatsvergütung. Entwürfe und
Zahleneditor allein verändern diese Enginewerte nicht.
Erst eine gesonderte Bestätigung sendet `contract.offer` mit exakter Quote-ID,
Jahren und `monthlySalary` in Minor Units. Der Client zeigt Annahme oder
Ablehnung aus der tatsächlichen Antwort; ein Original-Ablehnungsflag sperrt
gegebenenfalls den nächsten Versuch. Keine UI-Zufallszahl oder Demoforderung
ersetzt diese Entscheidung. Versicherung und Prämien bleiben hier lesend.
### Ergänzter Runtime-Command: `contract.cancel`
Der Payload ist `{quoteId: "quote:contract-<id>"}`; die gemeinsame Hülle benötigt
`requestId`, `careerId`, `expectedRevision`, `owner.managerId` und `kind` wie die
anderen Commands. Die Capability wird nur am Vereinsschreibtisch bekanntgegeben.
Die Engine prüft die genaue Quote sowie deren Manager und Verein, schließt sie
und erhöht die Sessionrevision. Sie verändert keine Vertragsdaten und weder
spult sie Zufall zurück noch zieht sie neuen. Eine falsche/verbrauchte Quote
führt zu `stale_quote`; eine alte Revision zu `stale_revision`. Dieselbe
requestId erhält die bereits bekannte Antwort, ohne erneut zu schließen.
Dies ergänzt die aktuelle Runtime-Implementierung; die allgemeinen JSON-Schemas
bleiben der separat gekennzeichnete Entwurf. Beim bloß lokalen Schließen ohne
angefragte Quote ist kein Command nötig. Nach einem echten Cancel bleibt eine
andere Schreibtischaktion möglich. In der geprüften Modern-Karriere blieb auch
der gespeicherte RNG bei der Forderungsabfrage gleich; erst die tatsächlichen
Vertragsentscheidungen änderten ihn. Der UI-Code setzt diesen Sonderfall nicht
als Regel fest. Neue OBS-Datei und Neustart erhalten den tatsächlichen Vertrag
und die Sperren, ohne einen offenen Quote-Owner zu hinterlassen.
Private Belege: `bmh_4k_ui/docs/qa/engine-contracts-2026-10-28/`.
## Ausführung und Dateien
Laden, Reads nach einer Aktion, Buchen und Speichern laufen seriell über einen