Modern UI contract: envelope, career and manager ids, session and desktop reads
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>
This commit is contained in:
1 parent
9061123c7e
commit
3336d01004
9 files changed
+342
-2
No files matched your search
@@ -0,0 +1,36 @@
|
||||
# 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:<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.
|
||||
Reference in new issue
Block a user