First engine delivery for the Modern interface handoff (docs/new_ui/integration, issue #15): ModernSession::ui_read answers in the draft envelope with careerId, worldId, stateRevision, date, season, scope and Money in minor units. Careers and human managers get persistent ids (saved in state/modern.json, older saves get them on load). Reads: session and desktop. Engine decisions on the P0 points in docs/new_engine/ui-anbindung.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.3 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 |
Fehler: unknown_read, manager_not_active, no_active_manager.
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.