The original asks for a running-out contract in the middle of the calendar. session.advance takes the answers in contractExpiry (renew with years and salary, or release); a contract without an answer rolls the run back and decision_pending names the player, the interface asks and sends the advance again. The test plays two seasons of kickoffs answering every request. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
Anbindung der Modern-UI · Engine-Seite
Stand: 27. Oktober 2026. Gegenstück zur Übergabe in new_ui/integration (Issue #15). Hier stehen die Entscheidungen der Engine und was der Adapter bereits liefert.
Antworten auf die Engine-Entscheidungen
| Punkt | Entscheidung |
|---|---|
| D21 Engine-Ref | Maßgeblich ist der Zweig 0.3 dieses Repositorys (src/modern, docs/new_engine). main ist Classic und bekommt keine Modern-Engine. |
| D01 Geld, Revision | Geld im Vertrag als Money {minor, currency, minorUnits} mit minor als Dezimalzeichenkette, EUR, minorUnits 2. Die Engine rechnet in ganzen Euro; der Adapter (ui_money) multipliziert genau einmal mit 100. Die UI bekommt nur noch Money. Revisionen sind Dezimalzeichenketten. |
| D02 IDs | careerId: career: plus 16 Hexziffern, beim Karrierestart vom System gezogen (kein Spielzufall) und im Spielstand gespeichert. managerId: manager:<n>, je Karriere hochgezählt, nie wiederverwendet, gespeichert je Managerplatz. teamId: die Welt-ID des Vereins bzw. der Nation; Teams ohne Welt-ID team:<Index>. playerId: die Welt-ID bzw. player:gen-<n> (Almanach). Spiel- und Ereignis-IDs folgen mit dem Live-/Almanach-Read. |
| D03 Wiederholung | Folgt mit den Commands: Jeder Command trägt requestId und expectedRevision. Die Revisionsprüfung verhindert doppelte Buchung auch nach einem Neustart; dieselbe requestId mit gleichem Inhalt liefert das gespeicherte Ergebnis, mit anderem Inhalt duplicate_request. |
| D04 Umschlag, Manager | Umschlag wie im Entwurf (messageType, requestId, meta, data). Ein Read darf managerId nennen; er muss der Manager am Schreibtisch sein, sonst manager_not_active. Lesen für einen wartenden Manager folgt, sobald die Session das ohne Platzwechsel kann. |
| D05 Angebote | Engine-Vorschauen, die Zufall ziehen (Transfer-, Bau-, Sponsorangebote), werden ausschließlich als Command quote.request angeboten, nie als Read. |
| D10 Menüs | menuAvailability im Desktop-Read: am Schreibtisch des Bundestrainers sind Toto, Bank, Trainingslager, Training und Stadion gesperrt (reasonCode: national_desk, wie ui/desk_state.cpp). Weitere Sperren der UI sind UI-Policy. |
Die übrigen Punkte werden mit dem jeweiligen Menü entschieden.
Was der Adapter liefert
src/modern/content/ui_contract.*, über ModernSession::ui_read(request, revision); die
Revision kommt vom Aufrufer (Konsole bzw. AppController), der Read ändert nichts.
| Read | Inhalt |
|---|---|
session |
sessionState, activeManagerId, alle menschlichen Manager (ID, Platz, Name, Team, Porträt, active/waiting) |
desktop |
Manager, Team (TeamRef), Kontostand (accounts.cash; Sparguthaben und Kredit folgen mit dem Bank-Read), nächstes Spiel, menuAvailability |
squad |
ein Kader (teamId, sonst der eigene Verein; auch Nationalteams mit Kader): Spieler-ID, Name, Nation, Position, Rolle (starter/bench/reserve), Verfügbarkeit, Verletzung und Sperre in Wochen, Alter, Werte (Stärke, Kondition, Technik, Form), Fähigkeiten; für den eigenen Verein Monatsgehalt und Restlaufzeit in Monaten (fremde Vereine: null) |
camps |
Karten und Lager (Qualität 0–6, Ort, Nation, Exklusiv-Sponsor-Chance), je Lager ein bindendes Angebot für den eigenen Kader (Grundpreis + Kaderzuschlag, ohne Zufall; allowed, reasonCode booked_this_week/visit_limit/no_club, exceedsCash), Schwerpunkte, Aufenthalte der Saison, Buchung dieser Woche |
lineup |
die Kaderzeilen in Reihenfolge (die ersten elf spielen) mit Rolle, die Plätze der Startelf auf der Taktiktafel (depth 0–19, lane 0–8; das JSON hat keine Kommazahlen), manual (Aufstellung von Hand) |
tactics |
die acht Einstellungen (tactic:0 Grundausrichtung bis tactic:7 Einsatz) mit Wert und Maximum aus der EXE; die Bedeutung der Diagramm-Einstellungen 1–3, 5, 6 ist nicht belegt, daher neutrale Namen |
training |
Bälle je Spielertyp und Trainingsbereich (1–3) mit den Grenzen, je Spieler Intensität und Schwerpunkt, ob das Training eingerichtet ist, Automatik-Bits |
contracts |
je Spieler Restlaufzeit, Monatsgehalt, Versicherung, Prämien; das offene Angebot (quote: ID, Spieler, Monatsforderung für 1–4 Jahre, Höchstgehalt 200.000 €) |
bank |
Konto, Festgeld, Kreditrahmen, Anlagen (alles Money), die 12 Aktien (Kurs, Vorkurs, Bestand, bezahlt, Höchstkauf, 30 Kurse Verlauf) und die angebotenen Fonds; Kredite noch unavailable (folgen), der Aktientipp zieht Zufall und kommt als quote.request |
Fehler: unknown_read, manager_not_active, no_active_manager, unknown_team.
Almanach und Statistik (ohne Umschlag)
Die UI ruft diese über DataSource::read_almanac und read_statistics direkt auf; Antwort {ok, ...} wie in ihrer Demo.
ModernSession::read_almanac:index(Jahre, Anzahl, erstes/letztes Datum),calendar {year}(Spieltage mit Anzahl und Höhepunkten),day {date}(alle Spiele des Tages),match {id}(match:<Saisonstartjahr>-<Nr.>). Ein Spiel trägt Datum, Saison, Wettbewerb (league/cup/friendly), Runde, beide Seiten (mit Manager, wenn menschlich), Ergebnis getrennt nach regulärer Zeit, Verlängerung (über die Torminuten) und Elfmeterschießen, Schiedsrichter, Zuschauer, Wetter, Aufstellungen (unter elf Spielernnull) und Ereignisse (goal,miss,yellow,second_yellow,red,injury,substitution,shootout).ModernSession::read_statistics_screen: der Statistikbildschirm mit den Filtern seiner Demo (section0–8,category,country,winner_country,absolute,curves),fictional: false. Aus dem Almanach: 3 Ewige Tabelle (je Land die erste Liga, 5 die eigene), 4 WM-Statistiken (Sieger mit Finale, Torschützen, Länder-Historie), 6 Serien und Rekorde (eigene Liga), 7 Sieger (national, Europapokale, Hallen-Masters), 8 Minuten-Statistik (eigener Verein). Aus den Aufzeichnungen des Originals: 1 Transferhistorie (Käufe, Verkäufe, Leihen des Managers mit Ablöse) und 2 Analytics: die sechs Kurven des Originals mit ihren Namen,valuesje erfasster Woche undabsoluteMin/absoluteMax; die UI skaliert selbst (pointsbleibt leer, die Demo lieferte Bildschirmkoordinaten). Noch ohne Aufzeichnung (available: false,reason: not_recorded): 0 Möglichkeiten, 5 Saisonfinanzen (das Original speichert nur die laufende Saison), bei 4 Gruppen und Finalrunde.ModernSession::read_statistics:competitions,winners,player_stats(Statistik) für eine eigene Spieler- und Siegerstatistik.
Commands
ModernSession::ui_command(request, revision). Ein Command (messageType: command) braucht requestId, expectedRevision (gleich der aktuellen Revision), owner.managerId (der Manager am Schreibtisch), kind und payload; careerId wird geprüft, wenn angegeben. Antwort: command_result mit previousRevision, newRevision (ein Schritt je Command), outcome, changedReadKinds, oder error.
- Ein abgelehnter Command (Prüfung oder Engine) lässt Spielstand und beide Zufallsgeneratoren unverändert (
stateChanged: false). - Dieselbe
requestIdmit demselben Command liefert die gespeicherte Antwort (keine zweite Buchung); mit anderem Commandduplicate_request. Gespeichert sind die letzten 64 Antworten dieses Prozesses; nach einem Neustart schütztexpectedRevision. - Fehler:
invalid_command,invalid_payload,wrong_career,stale_revision(retryable: true),no_active_manager,manager_not_active,unknown_commandund die Gründe der Engine-Aktion.
| Command | payload | Wirkung |
|---|---|---|
camp.book |
campId, optional focus {condition, technique, play} (0–15; Erholung folgt) |
setzt die Schwerpunkte und bucht das Lager wie der Schreibtisch; Fehler unknown_camp, invalid_focus, booked_this_week, visit_limit, insufficient_funds |
session.advance |
optional `contractExpiry {playerId: {action: "renew", years, monthlySalary} | {action: "release"}}` |
quote.request |
kind: contract, playerId |
fragt die Forderungen des Spielers ab (zieht Zufall wie am Schreibtisch); outcome: offer_pending, die Forderungen stehen danach im contracts-Read |
contract.offer |
quoteId, years 1–4, monthlySalary (Money) |
das Angebot gegen die Forderung; outcome applied (verlängert) oder offer_rejected; das Angebot ist danach verbraucht (stale_quote). Versicherung und Prämien folgen |
bank.commit |
action deposit/withdraw mit amount (Money, ganze Euro) oder buy/sell mit assetId (stock:<n>, fund:<n>) und count |
wie die Bank am Schreibtisch; Fehler invalid_amount, amount_unavailable, invalid_share_count, insufficient_funds, investment_limit, invalid_fund_count u. a. |
lineup.commit |
order: Spieler-IDs in der gewünschten Reihenfolge |
öffnet die Aufstellung wie am Schreibtisch und tauscht die Zeilen; Fehler unknown_player, lineup_refused (z. B. Verletzte, Ausländerregel) |
tactics.commit |
values: die acht Werte |
jede geänderte Einstellung über die Prüfung der Taktiktafel (eine gesetzte Grundausrichtung beendet die Steuerung durch den Assistenten); Fehler invalid_tactic |
training.commit |
optional types (4), areas (9), players [{playerId, intensity}] |
richtet das Training bei Bedarf ein, setzt erst die Senkungen, dann die Erhöhungen (jeder Zwischenstand bleibt in den Grenzen); Fehler training_unavailable, unknown_player und die Gründe der Engine |
Test: modern_ui_contract_tests (Umschlag, IDs, Geld, Fehler, Reads ändern den Spielstand nicht; Commands: veraltete Revision, fremder Manager, Wiederholung, Konflikt, Ablehnung ohne Änderung, je ein angenommener und ein abgelehnter Befehl für Lager, Aufstellung, Taktik und Training; braucht Spieldaten).
Noch nicht gefüllt: nationId, crestAssetId der Teams, employments (Amtszeiten), strengthChoice, allowedCommands.
Reihenfolge
Nach der Übergabe (MVP_FOR_CLAUDE.md): A Schreibtisch (dieser Stand) → B Vorbereitung (Kader, Aufstellung, Taktik, Training, Lager) → C Geschäft (Bank, Stadion, Transfers, Verträge, Werbung) → D Live-Ticker → E Eingriff und Nachspiel → F Manager und Presse. Je Lieferung Read- und Command-Tests.