Files
Dreierpack-Manager/docs/new_ui/desktop/contracts/README.md
T

78 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Verträge
## Echter Engine-Einstieg · 28. Oktober 2026
Mit `--ui-career` verwenden die bestehenden drei Tabellen den Read `contracts`
und die aktuellen Kaderwerte. Gehälter und Restlaufzeiten werden weder aus dem
Weltkatalog geschätzt noch aus Saisongehältern abgeleitet. Nicht gelieferte
Spiele/Noten bleiben unbekannt. Monatsgehälter werden einmal exakt in Minor
Units gelesen und für die Summe addiert. Die rechte Summe hat ausdrücklich
bemessene Textfelder; Betrag und Währungszeichen bleiben im Fenster.
Das Öffnen eines Spielers, Tabwechsel und Details sind lesend. Erst
**Forderungen abfragen** sendet `quote.request {kind: contract, playerId}`.
Die vier Forderungen, verfügbare Laufzeiten und Gehaltsgrenze kommen aus der
Engine. Nicht angebotene Laufzeiten erscheinen gesperrt. Im tatsächlichen
Modern-Datensatz der Prüfung benötigte diese Abfrage keinen Zufallszug; der
Client setzt dies nicht voraus und erzeugt selbst keinen.
Gehalts- und Laufzeitänderungen bleiben lokal. Der Zahleneditor bestätigt nur
den Entwurf; danach fragt **Angebot machen** nach einer eigenen verbindlichen
Bestätigung. `contract.offer` verwendet die genaue Quote-ID, Spieler, Manager,
Karriere und aktuelle Revision. Annahme oder Ablehnung folgen ausschließlich
der Engineantwort. Ein abgelehntes Angebot kann den Spieler nach Originalregel
für weitere Gespräche sperren; dies wird beim erneuten Öffnen berücksichtigt.
Es gibt keine 110-%-Demoforderung und keinen garantierten Verhandlungserfolg.
Schließen einer angefragten Verhandlung sendet den neu ergänzten
`contract.cancel {quoteId}`. Der Adapter prüft aktuelle Revision, Manager,
Verein und genaue Quote-ID. Er schließt nur den zugehörigen Owner und ändert
weder Gehalt noch Laufzeit oder Zufallsgeneratoren. Eine Wiederholung derselben
requestId ist idempotent; fremde oder alte Anfragen ändern nichts. Die folgende
Schreibtischaktion bleibt damit bedienbar. Forderungsabfrage/Abbruch verändern
die Sessionrevision und werden vorsichtshalber als ungespeichert markiert.
Versicherungsrestlaufzeit und die sieben gespeicherten Prämienstufen sind über
**Details** lesbar. Neue Versicherungen und Prämienänderungen sind bis zu einem
entsprechenden Engine-Schreibvertrag gesperrt. Die vorhandenen Rohstufen werden
nicht als erfundene Eurobeträge oder gemeinsame Teamwerte ausgegeben.
Neue OBS-Dateien erhalten tatsächliche Verträge und Ablehnungssperren; ein
vollständiger Prozessneustart öffnet keine alte Verhandlung. Private Nachweise:
`bmh_4k_ui/docs/qa/engine-contracts-2026-10-28/`.
Siehe [Engine-Einstieg](../../integration/ENGINE_ENTRY.md).
## Getrennte Präsentationsdemo
Stand: 24. Oktober 2026. HTML-Gold: `bmh_4k_ui`, Revision `ea6c8d97`,
`management-menus.js`, `career-menus.css` und `poc-menus.css`.
Die native Ansicht bietet Daten A, Daten B und Gehalt sowie Verhandlung,
Versicherung und sieben Team-Prämien.
Kader, stabile Spieler-IDs, Namen, Positionen und vorhandene Attribute
stammen unverändert aus der OBW-Welt. Zuständig ist der Verein des ersten
Managers, unabhängig von der Berichtsliga. Der Kader wird vollständig
angezeigt und bei Bedarf gescrollt; fehlende Werte bleiben `—`, ein leerer
Kader wird ausdrücklich benannt. Es werden keine Ersatzspieler erfunden.
Ein vorhandenes OBW-Saisongehalt liefert eine gerundete monatliche
**Vorschau**. Ausdrücklich zur Initialisierung vorgesehene Demoverträge
bekommen fiktive Startgehälter; ohne diese Grundlage bleibt das Gehalt
unbekannt. Herkunftshinweise stehen am Gehalt. Laufzeit, Versicherung,
Forderung und Prämien gehören zum Präsentationszustand, nicht zu einer
Engineverhandlung. Verhandlungsbilder sind GUI-Ressourcen, keine Weltassets.
Gehalt und Laufzeit bleiben lokale Vorschläge. Auch die Bestätigung im
Zahleneditor übernimmt zunächst nur diesen Entwurf; erst „Angebot machen“
schreibt ihn in den Demozustand. Abbrechen und der Wechsel zur Versicherung
verwerfen den Vorschlag. Versicherung mit 0/12/24 Monaten wird direkt
übernommen. Die sieben Prämien akzeptieren 0–255 und nutzen die gemeinsame
Geldbestätigung; dabei wird kein Guthaben abgebucht.
Revision, Welt, Verein und Spieleridentität werden vor dem endgültigen
Angebot geprüft. Ein Vereinswechsel des ersten Managers initialisiert
passende Verträge neu, ohne Bankguthaben oder Bilanzplan zurückzusetzen.
Checkpoints erhalten Vorschauverträge; nur fehlende Altfelder migrieren.
Classic und Engine bleiben unverändert. Prüfnachweise stehen in der
[gemeinsamen Menü-QA](../../menu-qa.md).