Files
Dreierpack-Manager/docs/new_engine/ui-anbindung.md
T
ClaudeandClaude Opus 5.5 6e400d708c Modern UI contract: live table in the paused kickoff
live_league_table is shared by the recording and the paused live state;
a paused league match now reports its league with the running scores.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 14:09:04 +01:00

21 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; Festgeld und Kredit im Read bank bzw. credit), 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 €)
advertising 14 Banden (ad:board/<n>), Trikot (ad:shirt), TV-Rechte (ad:tv) je mit Vertrag (Sponsor, Monatsbetrag, Restmonate, Verlängerung, Option) und den offenen Angeboten (offer:ad-<Platz>-<Nr.>, Sponsor, Betrag, Banden, Monate, allowed); die drei Budgets (Merchandising, Presse, Fanarbeit) mit Stand, Höchstbetrag, Lieferwochen; die Finanzvorschau des Originals
stadium Umfeld (14 Objekte mit Namen und Bautagen; Verkehrsanbindung mit stage und maxStage: Classic 3, Modern-Welt 4; sonst built), die acht Anlagen (Stufe, Höchststufe, Bauwochen, ob ausbaubar), die acht Tribünenblöcke (Plätze, Höchstplätze, Sitzplätze, Dach, Bauwochen, Plätze nach dem Bau), Eintrittspreis (8–25 €); das offene Angebot des Stadion-Dialogs (quote: Umfeld mit Preis, oder Anlage mit Zielstufe, Preis, Bauwochen und dem Trinkgeld-Bereich 6–14 %)
transfer die Transferliste (listing:<n>: Spieler, Alter, Position, Stärke, Verkäufer, Ablöseforderung, Gehaltsreferenz pro Jahr, Gehaltsforderung in %, Zahl der Angebote, eigene Listung, eigenes Gebot), der eigene Kader (gelistet oder nicht), Kontostand, Kreditrahmen
scheduling die verlegbaren eigenen Ligaspiele (move:<Tag>-<Liga>-<Runde>-<Nr.>, Datum, Runde, Heim/Gast, mögliche Zieldaten) und die verlegten, die sich zurücknehmen lassen
friendly mit opponentId, optional home: das Angebot für ein Freundschaftsspiel (Heim/Gast, Kosten, Zahler, ob der Gegner einen menschlichen Manager hat) und die freien Daten der Saison; kein Zufall
environment das Umfeld (Diamond 3.6): drei Jugendteams, Co-Trainer, Arzt, Physiotherapeut (environment:<Bereich>), je Stufe 0–6, Monatskosten, Kosten je Stufe; die Jugendteams mit Stärke, Platz, Liga; ob die Akademie läuft
toto der Tippschein (Toto): open (elf Spiele), Spiele, Einsatz und Kosten (Money), Spalten, Regeln, letzte Abrechnung
sponsor das Exklusiv-Sponsor-Angebot aus einem Trainingslager und ein vorgemerkter Vertrag (monthly als Money; asset: null, siehe Trainingslager)
bank Konto, Festgeld, Kreditrahmen, Anlagen (alles Money), die 12 Aktien (Kurs, Vorkurs, Bestand, bezahlt, Höchstkauf, 30 Kurse Verlauf) und die angebotenen Fonds; credit verweist auf den Read credit, der Aktientipp zieht Zufall und kommt als quote.request
credit der Kreditdialog (lenderId bank oder die Manager-ID eines anderen Menschen): saved (Darlehen, Gesamtbetrag, Rate, Laufzeit, vergangene Monate, Zahlungen), fields (acht Felder mit field, label, value, editable, min, max; Werte in ganzen Euro bzw. Monaten), fees, refund, principalPaid (Money). Optional edits [{field, value}] als Vorschau, nichts wird gebucht; Fehler unknown_lender, credit_unavailable, invalid_credit_edit
postmatch das Nachspiel des letzten session.advance (auch am Bundestrainer-Schreibtisch): steps (results, report, team_of_the_day, overview, table je mit available), matches (alle Spiele des Anstoßes im Almanach-Format), reportMatchIds (Spiele menschlicher Manager), teamOfTheDay (die Sportschau-Elf der Engine je Wettbewerb mit Spieler, Verein, Wertung; nur mit der Sportschau-Option der EXE, sonst leer und team_of_the_day nicht verfügbar), tables (die aktuellen Tabellen der Ligen des Spieltags). Rückblick und Abspielen ändern nichts; weiter geht es mit session.advance

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 Spielern null) und Ereignisse (goal, miss, yellow, second_yellow, red, injury, substitution, shootout).
  • ModernSession::read_statistics_screen: der Statistikbildschirm mit den Filtern seiner Demo (section 0–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, values je erfasster Woche und absoluteMin/absoluteMax; die UI skaliert selbst (points bleibt 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.

Live-Ticker (ohne Umschlag)

ModernSession::read_live (für DataSource::read_live, Abfragen wie die Demo: {kind: "fixture"}, {kind: "frame", sequence}, optional revision, fixture_id). Die Engine rechnet einen Spieltag beim Anstoß im Ganzen; der Ticker spielt die Aufzeichnung der Spiele des letzten session.advance ab (source: "engine-recording", Format openbmh-live-fixture@1 der Demo):

  • matches: die Spiele mit menschlichem Manager (höchstens vier), owners: die Manager mit Team und match_id (view ist null; die Aufstellung kommt aus dem lineup-Read).
  • frames in Minutenfolge: Anpfiff, jedes Ereignis (Tor, Chance, Karten, Verletzung, Wechsel, Elfmeter), Halbzeit, Wiederanpfiff, Abpfiff; je Spiel Stand, Chancen, Gelb, Rot, Elfmeter, Spieler auf dem Feld. events (fortlaufend) mit Überschrift und Satz, Spieler, Seite, Stand.
  • conference: die übrigen Spiele des Tages im Almanach-Format.
  • standings (Live-Tabelle) je Frame: pro Liga eines Ticker-Spiels die Tabelle vor dem Spieltag plus alle Spiele dieser Runde im Anstoß mit dem Stand der Minute (beim Abpfiff das gewertete Ergebnis); Zeilen mit rank, previousRank, team, played, won, drawn, lost, goalsFor, goalsAgainst, points. In der Aufzeichnung trägt ein Frame nur die Tabellen, die sich in ihm geändert haben (der erste alle); kind: frame liefert den vollständigen Stand bis dahin. Der angehaltene Live-Anstoß liefert standings ebenso: je Ligagruppe mit einem Live-Spiel die Tabelle mit den Ständen der laufenden Spiele. Fehler: live_unavailable (noch kein Anstoß), live_no_human_match, stale_live_revision, stale_live_fixture, invalid_live_sequence.
  • Live mit Eingriffen: session.advance {live: true} startet den Anstoß in einem eigenen Ablauf, der nach der ersten Minute eines laufenden Live-Spiels eines Menschen anhält (eine gewertete Partie, z. B. ein Forfeit, läuft ohne Halt durch). Solange er steht, liefert read_live {live: true, status: "paused", minute, matches}: je Live-Spiel Stand, Manager je Seite und die bisherigen Ereignisse (goal, miss, yellow, second_yellow, red, injury mit Minute, Seite, Spieler, Vorlage); Wechsel zeigt der lineup-Read. Die vollständige Aufzeichnung folgt nach dem Abpfiff. Alle anderen Befehle antworten live_running, bis der Spieltag vorbei ist.

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
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
advertising.accept offerId nimmt ein Angebot an wie am Schreibtisch; Fehler unknown_offer, advertising_refused
budget.commit budgetId (budget:merchandise, budget:press, budget:fans), amount (Money) setzt ein Budget; Fehler unknown_budget, invalid_amount, advertising_refused (z. B. Lieferung läuft, zu wenig Geld)
ticket.commit price (Money, 8–25 €) der Eintrittspreis; Fehler invalid_amount, ticket_refused
transfer.submit action: list, playerId, optional loan; oder action: bid, listingId, fee, monthlySalary (Money), years 1–4, optional loan setzt einen eigenen Spieler auf die Liste (bzw. bietet ihn zum Verleih an) oder gibt über den Angebotseditor des Originals ein Gebot ab (öffnen, Felder setzen, abschicken). outcome: applied (sofort angenommen), offer_pending (Antwort mit der nächsten Woche), offer_rejected (zu niedrig/abgelehnt). Fragt die Engine einen menschlichen Verkäufer (Abwerben), wird zurückgerollt: decision_pending (noch nicht unterstützt). Fehler unknown_player, already_listed, unknown_listing, own_player, no_bid_slot, transfer_refused
friendly.book opponentId, optional home, date, acceptCost, bei menschlichem Gegner opponentConsent vereinbart das Freundschaftsspiel; Fehler declined (Kosten nicht bestätigt), opponent_declined, insufficient_funds, date_unavailable, plan_full u. a.
fixture.reschedule matchId, date; oder action: undo, date verlegt eine eigene Ligapartie bzw. nimmt die Verlegung zurück; Fehler invalid_day, day_full, team_clash, no_free_slot, no_moved_match
environment.commit itemId, level 0–6 setzt ein Monatsbudget des Umfelds (keine Sofortbuchung, kein Zufall); unverändert: outcome: no_change; Fehler environment_refused
manager.resign.commit confirmed: true Aufgeben (neu in Modern, das Original kennt kein Aussteigen): Der letzte menschliche Manager beendet die Karriere (outcome: career_ended, session-Read sessionState: "ended", danach antwortet jeder Befehl career_ended). Mit weiteren Menschen soll der Computer den Verein übernehmen; das braucht das Nachrücken aller Managertabellen und folgt (resign_not_supported_yet). Fehler confirmation_required
toto.submit stake (Money je Spalte), columns (bis 6 Spalten mit 11 Tipps: 1 Heim, 0 Unentschieden, 2 Auswärts) gibt den Tippschein ab; Fehler toto_refused (z. B. kein offener Schein, Einsatzgrenzen, doppelte Spalte)
sponsor.answer accept Antwort auf das Exklusiv-Sponsor-Angebot: beginnt sofort, wird vorgemerkt oder abgelehnt
quote.request (Stadion) kind: periphery, objectId; oder kind: facility, facilityId, increment 1–3; oder kind: block, blockId (block:a–block:h), places (Ziel insgesamt), optional seats, roof öffnet den Stadion-Dialog und holt das Angebot der Baufirma bzw. wählt Anlage und Stufen bzw. stellt den Tribünenausbau zusammen (Plätze, Sitzplätze, Dach; vorhandene Ausstattung bleibt; Angebot mit Aufschlüsselung Plätze/Sitze/Dach); offer_pending. Der Dialog bleibt offen (andere Schreibtisch-Einstellungen sind bis dahin gesperrt, quote_open für ein zweites Angebot)
stadium.commit quoteId, accept, bei Anlagen und Blöcken tip baut (Anlagen und Blöcke mit oder ohne Trinkgeld für schnelleres Bauen, wie das Original fragt) oder lehnt ab und schließt den Dialog; Fehler stale_quote, stadium_refused
session.advance mit live: true wie oben, dazu contractExpiry Live-Spieltag: hält in der ersten Minute eines Live-Spiels an (changedReadKinds: ["live"]); läuft kein Live-Spiel, endet er sofort wie ein normaler Anstoß
live.step minutes (1–150, sonst 1) spielt so viele Spielminuten des Live-Spiels und hält wieder an; ist der Spieltag vorbei, kommt die Antwort des Anstoßes
live.substitute outPlayerId, inPlayerId Wechsel wie im Spielfeld-Bildschirm des Originals (öffnen, tauschen, schließen; ab Minute 3); Fehler substitution_refused
live.tactics values (8) Taktik wie im Taktik-Bildschirm während des Spiels; Fehler invalid_tactic
live.finish {} spielt den Spieltag ohne weiteren Halt zu Ende; Antwort wie session.advance (bei fehlender Vertragsentscheidung wird der ganze Live-Spieltag zurückgerollt: decision_pending)
bank.commit action deposit/withdraw mit amount (Money, ganze Euro) oder buy/sell mit assetId (stock:<n>, fund:<n>) und count oder credit mit lenderId (optional), edits wie im Read credit und acceptFees (Gebühren wie im Original bestätigen) 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.