The card shows age, strength, condition, technique and form as numerals, the seven skills as marks and contract and status as a list. The line-up pitch draws shirts in the club's colour with a condition dot instead of the data set's figures. League tables carry the prediction's European places and the promotion and relegation places. A display setting turns transitions off. The desk hangs from the top edge of a taller screen. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
33 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 |
nach dem Schema Session: sessionState (desktop, nach dem Ende ended), activeManagerId (nach dem Ende null), managers (ID, Platz, Name, Team, Porträt, control human, status active, employments), humanOwnership (Team, Manager), archivedManagerIds/archivedManagerCount, terminationReason (career_completed wenn die festgelegte Dauer abläuft, last_human_resigned beim Aufgeben; null solange es läuft), mode (club/national/mixed), canAdvance, blockingReason (session_ended). Grund und Datum des Endes stehen im Spielstand |
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). surface (indoor im Hallenturnier, sonst outdoor; der vorbereitete Turnierkontext, beim Laden aus den Cup-Gruppen wiederhergestellt), durationMinutes (40 bzw. 90) und starterCount (immer 11): auch in der Halle spielen elf, die Feldspieler in Paaren, die gemeinsam wechseln. pairs [{rows, playerIds}] sind die Zeilen, die sich gegenseitig als Partner führen (Taktiktafel +0x3f), jede Position trägt ihre partnerId (null ohne Partner). Die Engine kürzt oder benennt nichts um; lineup.commit behält Besitzer, Reihenfolge und Paare. Auch am Schreibtisch des Bundestrainers (das Nationalteam; ohne die Standardschützen-Erweiterung der Vereine), ebenso tactics und lineup.commit |
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 %) |
balance |
view current/real/future, optional edits [{id: balance:<0–17>, amount: Money}]; liefert ursprüngliche Posten/Labels/Grenzen, sechs Zusatzwerte, Abschreibung, Nettoergebnis und Bilanzwarnung. Prognose auf eigener Kopie, kein RNG/Live-Publish. |
achievements |
Reine Manager-Saisonhistorie am Vereinsschreibtisch: managerId, aktuelles teamId, currentSeasonYear, records mit Jahr/Abschlussstatus, Liga-ID/Platz/Teilnehmerzahl und ursprünglichen Pokal-/Europapokalständen samt Text. Keine historische Vereinszuordnung erfinden. available bedeutet vorhandene Aufzeichnungen; originalMenuAvailable nennt zusätzlich die bisherige Ligaspiel-Sperre. Abgeschlossene Daten bleiben in der Modern UI auch zwischen Saisons lesbar; ungespielte neue Saisons werden nicht ergänzt. Kein RNG oder Schreibvorgang. |
transfer |
die Transferliste (listing:<n>: Spieler, Alter, Position, Stärke, Verkäufer, Ablöseforderung, Gehaltsreferenz pro Monat, Gehaltsforderung in %, Zahl der Angebote, eigene Listung, eigenes Gebot), der eigene Kader (gelistet oder nicht), Kontostand, Kreditrahmen; details je Spieler mit vollständigem Namen, Nationalität, Foto, Kondition/Technik/Form und sieben Fähigkeiten; activeStrengths/teamStrengths enthalten vier Positionen und Gesamtschnitt. ownBid.monthlySalary ist das gespeicherte Monatsgehalt; annualSalary bleibt als früher irreführend benannter Alias erhalten. salaryReferencePeriod: month. loanAvailable sperrt vereinslose Anbieter; offerTerms liefert Kauf-/Leihgebühr, jeweilige maximale Gebühr und maximales Monatsgehalt aus den Original-Editorgrenzen. ownBid.loan bezeichnet die gespeicherte Leihart. ownBid.bonuses sind sieben gespeicherte Prämienstufen. Die Projektion und Gebotsprüfung verwenden den weltabhängigen Modern-Pool, nicht Classic 0xb70 (#24). |
news |
Presseereignisse eines Teams (teamId, Vorgabe das Team am Schreibtisch), from/until (ISO, Vorgabe bis heute), limit (Vorgabe 50, die neuesten): events je {id, type, date, scope, data, variant: null} nach Pressevertrag, total. Quelle ist der Almanach, darum gleich bei jedem Lesen und mit stabiler ID (press-event:<Typ>:<Vorkommnis>:<Team>). Typen: match.result, cup.round_result, cup.final_result, cup.extra_time, cup.penalties, player.sent_off, player.injury, run.wins (3/5/8/10/15), run.unbeaten (5/10/15/20/30), run.winless (5/8/10/15), run.losses (3/5/8/10), league.position, league.champion, cup.won, indoor.won. Fakten: team, opponent, competition (mit kind, season), matchId, score {for, against} aus Sicht des Teams, venue, trailed, minute (das entscheidende Tor), outcome, round, shootout, player, matches, position, points. Dazu Geschäftsereignisse aus dem Pressejournal im Spielstand (state/modern.json, press): beim Anstoß aus dem Kadervergleich der menschlichen Vereine transfer.signed (fromClub), transfer.free, transfer.sold (toClub; auch ein freigegebener Spieler, der im selben Anstoß woanders unterschreibt), contract.ended; toto.win/toto.loss (amount); career.season_finished/career.season_started; beim Saisonwechsel league.promoted/league.relegated (competition die neue, from die alte Liga); aus bestätigten Befehlen contract.extended (years, wage), advertising.signed (company, amount monatlich, months, place boards/shirt/tv), finance.loan_approved/finance.loan_repaid (amount, bank), stadium.expansion_planned (block, seats Ziel insgesamt) und career.manager_resigned. Ablösen kennt der Kadervergleich nicht (fee: null). Ohne Welt-IDs (Classic-Daten) heißt ein Verein team:<Laufzeitnummer>, die sich zum Saisonstart ändern kann. Monatlich finance.profit/finance.loss (amount die Veränderung des Kontostands im abgelaufenen Monat, alles Gebuchte eingeschlossen, month als JJJJ-MM; vermerkt beim ersten Anstoß im neuen Monat). Beim Anstoß stadium.expansion_finished (count die Plätze des Stadions danach), wenn die Bauzeit eines Tribünenblocks abläuft. Noch nicht: Derby, Aktien. Dazu messages: das Postfach des Managers am Schreibtisch (die Nachrichten des Originals; id stabil message:<Tag>-<Texthash>, auch wenn das Original seine Einträge zusammenschiebt; subject die erste Zeile, paragraphs der Text, read, folder inbox/archive/trash); articles leer (die UI rendert und hält ihre Artikel), dedupePolicyId |
calendar |
der Saisonkalender des Teams am Schreibtisch, from/until (ISO, Vorgabe der laufende Monat): days (Datum, seasonDay, today, eventKinds: league, cup:<n>, replay, indoor, special, national, friendly; fixtureIds) und fixtures (die eigenen Ligaspiele: fixture:league-<Liga>-<Runde>-<Nr.>, Wettbewerb, Runde, originalDate, scheduledDate, Heim/Gast, status scheduled/played/rescheduled/postponed, result). Verlegte und im Winter ausgefallene Spiele stehen am Nachholtag. Pokalspiele nur als eventKinds; Fehler invalid_range |
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. Am Schreibtisch des Bundestrainers ein Länderspiel (national: true, Gegner ein anderes Nationalteam, dazu ratings beider Teams): das Original zieht für die Bewertung Zufall; der Read rechnet auf einer Kopie des Generators, die Buchung zieht dieselben Zahlen |
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 Spielernnull) und Ereignisse (goal,miss,yellow,second_yellow,red,injury,substitution,shootout).ModernSession::read_statistics_screen: der Statistikbildschirm mit den Filtern seiner Demo (section0–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,valuesje erfasster Woche undabsoluteMin/absoluteMax; die UI skaliert selbst (pointsbleibt 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 undmatch_id(viewistnull; die Aufstellung kommt aus demlineup-Read).matches(die Spiele des Tickers) mitattendance(Zuschauer) undweather(temperaturein °C,raindas Wetterbild 0–7 des Originals; Hallenturniernull), schon vor dem Anpfiff; ebenso jede Partie des angehaltenen Live-Anstoßs (aus der Spielgruppe).framesin 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 mitrank,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: frameliefert den vollständigen Stand bis dahin. Der angehaltene Live-Anstoß liefertstandingsebenso: 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, liefertread_live{live: true, status: "paused", minute, matches}: je Live-Spiel Stand, Manager je Seite und die bisherigen Ereignisse (goal,miss,yellow,second_yellow,red,injurymit Minute, Seite, Spieler, Vorlage);lineupsnennt je Seite die Startelf (odernull, wenn die Mannschaft ohne Spieler antritt); Wechsel zeigt derlineup-Read. Die vollständige Aufzeichnung folgt nach dem Abpfiff. Alle anderen Befehle antwortenlive_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
requestIdmit demselben Command liefert die gespeicherte Antwort (keine zweite Buchung); mit anderem Commandduplicate_request. Gespeichert sind die letzten 64 Antworten dieses Prozesses; nach einem Neustart schütztexpectedRevision. - Fehler:
invalid_command,invalid_payload,wrong_career,stale_revision(retryable: true),no_active_manager,manager_not_active,unknown_commandund 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 (Leihe 1–2), optional loan, optional bonuses (sieben gespeicherte Stufen: zuerst 0–20, dann 0–200) |
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). Abgelehnte Listung: listing_refused, vollständige Rücknahme. Geldfelder verlangen EUR/2 und ganze Euro ohne Überlauf. 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 |
am Schreibtisch des Bundestrainers das Länderspiel (Rückmeldung mit Bonus, wenn das Original ihn gewährt); 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). Spielt nur ein Mensch (oder ist er der letzte), endet das Spiel wie mit dem Ablauf der festgelegten Dauer: die Highscore-Tabelle wird fortgeschrieben und angezeigt (der Hook der Saisonwende, erst Aktualisierung, dann Anzeige), outcome: career_ended, ownershipChange mit archivedIdentity (Manager control: archived, status: resigned, Amtszeiten mit until und endReason: resigned), terminationReason: last_human_resigned; danach antwortet jeder Befehl career_ended. Beim Ablauf der Dauer sind die Manager retired, die Amtszeiten enden mit career_end. 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ß |
session.advance mit dryRun: true |
wie session.advance |
Probelauf: der Anstoß wird gespielt und vollständig zurückgenommen (outcome: rehearsed, Revision unverändert). Eine offene Rückfrage kommt wie sonst als decision_pending; bei auslaufendem Vertrag nennt message.args.demands die Forderungen für ein bis vier Jahre. Eine Verlängerung (renew) gilt mindestens zur Forderung im Augenblick des Ablaufs |
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. |
balance.commit |
view future, nichtleere edits wie im Read, acceptWarning bei Bilanzwarnung | übernimmt die mit vorhandenen Core-Funktionen rekonstruierte Zukunftsplanung; keine unmittelbare Cash-Buchung. Fehler invalid_payload, confirmation_required, balance_refused; veraltete Karriere/Manager/Revision wie üblich. |
news.update |
messageId, action read/unread/archive/trash/restore |
eine Nachricht des eigenen Postfachs: gelesen und Papierkorb sind Markierungen der Oberfläche (im Spielstand, news_marks je Manager; die Nachricht bleibt im Postfach des Originals, restore holt sie zurück), archive ist das „Behalten“ des Originals (eine behaltene Nachricht wird bei vollem Postfach nicht verdrängt), restore gibt sie wieder frei. Endgültiges Löschen bietet die Schnittstelle nicht an. Unverändert: no_change; Fehler unknown_message |
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).
Aus der Welt: nationId und crestAssetId der Teams (TeamRef) und photoAssetId der Spieler im Kader (Asset-Schlüssel wie asset:club/<n>/crest, die UI zeichnet sie); ohne Welt null. employments des Managers aus dem Almanach: je betreutem Team teamId, teamName, role (club/national), from, until (null solange es läuft). allowedCommands im meta.scope: die Befehle, die der Schreibtisch annimmt (am Bundestrainer-Schreibtisch nur session.advance, lineup.commit, tactics.commit, friendly.book, manager.resign.commit; nach Karriereende keine; ein laufender Live-Anstoß ist dort nicht abgebildet, dann gelten nur live.*). Noch nicht gefüllt: strengthChoice.
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.
-
desktop-widgets: reine Session-Desk-Projektion mit zehn optionalen Warnprädikaten, eigener Platz-/Stärkeangabe und optionalem bestätigtem Gegner. Fananzahl ist ausdrücklich kein Stimmungsprozent. Keine zusätzlichen Commands oder Persistenzfelder. DazurankCurve(Tabellenplätze des eigenen Vereins im Saisonverlauf) undrecent(die letzten sechs aufgezeichneten Spiele aus dem Almanach:formS/U/N,scoreaus eigener Sicht,opponent,home). -
indoor-standings: reiner Club-Read aus der vorhandenen Originalprojektion.teamId,tournaments,rows[{rank, points, team:{id,name}}](16 beziehungsweise leer vor dem ersten Turnier),footer,indoor,scoring: null | {value, places:[{rank,points}]}. Die Wertung sind Punkte, keine Geldbeträge; Slot-/Spriteformatierung bleibt aus dem Transport. Keine Qualifikations- oder Ziehungsmutatoren, keine zusätzlichen Commands. -
settings:leagueGroups[{row,competitionId,name}]bindet A–E an die fünf tatsächlichen deutschen Ligaindizes und ihre Sessionnamen (ID/Name beidenull, falls unbekannt). Anzeige und Suche verwenden dieselben Namen; keine POC-Namen als tatsächliche Weltbezeichnung. Daneben reine 180-Zellen-Projektion mitcode/raw/displayRaw/value/editable/min/max/step/reason, fünf Automatiken, vorhandenen Aufstellungsslots und Auswahl. Verfügbarkeitsbits/Spezialwerte bleiben getrennt von booleschen Werten; originale Schalter speichern 0 für An/1 für Aus,valueund Commandwerte sind semantisch 1 für An/0 für Aus. Neunte Spalte angezeigt halbiert, Rohparität erhalten.settings.commitübergibt sparseedits[{code,value}]undautomation[{id,enabled,formation?}]; alle Schritte durch bestehende Dispatcher, gesamte Änderung atomar, eine Revision beziehungsweise echter No-op. Nationale Trainingssperre und vorhandene Aufstellungsmasken bleiben bindend. Kein OBW-/OBS-Formatwechsel.
Managerverwaltung (nativer Einstieg)
manager-menu ist ein reiner Read mit managers, aktuellen clubs[{id,leagueId,playable}], canJoin/canResign und Gründen. ownerManagerId ist der Besitzer der Ansicht, auch nach dem Ende. activeManagerId ist dann null; die Menschen sind archiviert, passend zum Session-Read. Die fünf aktuellen deutschen Spielklassen und die bestehenden ursprünglichen Auswahlkontexte bestimmen die Beitrittsfähigkeit. Keine UI-Zuordnung über die anfängliche OBW-Liga eines inzwischen aufgestiegenen Vereins.
manager.join.commit: payload {confirmed:true, managers:[{name,club,portrait,portrait_style,strength_choice}]}. Nur neue Menschen übergeben; vorhandene Menschen sind keine bearbeitbaren Nutzdaten dieses Auftrags. Die Session leitet das Zielvolumen aus ihrer Menschenzahl ab, bewahrt ihre übrigen Startoptionen und durchläuft ihren vorhandenen Beitrittsentwurf atomar. Harter Grenzwert vier; Prüfung von Besitzer/Revision, aktueller deutscher Vereinszugehörigkeit, eindeutigen Vereinen/Porträts, Stil und Unicode-Namen. Eine Revision pro erfolgreichem Auftrag. Die UI bietet jeweils einen neuen Menschen an.
manager.resign.commit bleibt der bestehende bestätigte Ein-Mensch-Endpfad. Mehrspieler-KI-Übergabe bleibt ausdrücklich nicht unterstützt. Moderne Beitritte behalten den aktuellen Erstligaplatz statt der ursprünglichen Neuplatzierung (#29); Classic und Neuanlage unverändert, in DIFFERENCES.md markiert.
league-report: jede Tabellenzeile trägtzone(europe,promotion,relegationoder leer). Grundlage sind die Plätze der Saisonprognose (kLeagueEurope, in der ersten Liga vier) und die Abstiegsplätze (kLeagueRelegation); die Zone folgt dem Rang der gewählten Tabellenansicht.