Files
Dreierpack-Manager/docs/new_engine/ui-anbindung.md
T
ClaudeandClaude Opus 5.5 99a48a463d Modern UI contract: camps read and the first command, camp.book
ModernSession::ui_command checks careerId, expectedRevision and owner, runs
the engine action and answers command_result or error. A refused command
restores the state and both generators; a repeated requestId gets the stored
answer, a different command under the same id duplicate_request. The camps
read lists maps and camps with a binding, draw-free quote per camp, focus and
the season's stays. Tests cover stale revision, foreign owner, unknown camp,
booking, repeat, conflict and a refused second booking.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 08:25:54 +01:00

5.5 KiB
Raw Blame History

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

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

Test: modern_ui_contract_tests (Umschlag, IDs, Geld, Fehler, Reads ändern den Spielstand nicht; Commands: veraltete Revision, fremder Manager, Wiederholung, Konflikt, Ablehnung ohne Änderung; 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.