# Anbindung der Modern-UI · Engine-Seite Stand: 27. Oktober 2026. Gegenstück zur Übergabe in [new_ui/integration](../new_ui/integration/README.md) (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:`, je Karriere hochgezählt, nie wiederverwendet, gespeichert je Managerplatz. `teamId`: die Welt-ID des Vereins bzw. der Nation; Teams ohne Welt-ID `team:`. `playerId`: die Welt-ID bzw. `player:gen-` (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 | Fehler: `unknown_read`, `manager_not_active`, `no_active_manager`, `unknown_team`. ## 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 `requestId` mit demselben Command liefert die gespeicherte Antwort (keine zweite Buchung); mit anderem Command `duplicate_request`. Gespeichert sind die letzten 64 Antworten dieses Prozesses; nach einem Neustart schützt `expectedRevision`. - Fehler: `invalid_command`, `invalid_payload`, `wrong_career`, `stale_revision` (`retryable: true`), `no_active_manager`, `manager_not_active`, `unknown_command` und 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` | | `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.