Files
Dreierpack-Manager/docs/new_engine/ui-abfragen.md
T

6.6 KiB
Raw Blame History

Abfragen für die neue Oberfläche (M6)

Vereinbarter Ablauf: Die neue Oberfläche wird je Menü an die Modern-Engine angebunden. Jedes Menü bekommt feste Abfragen (und später Aktionen), die die Engine baut und hier dokumentiert; Codex stellt Menü für Menü vom Demo auf die Abfrage um. Die Demo bleibt nutzbar.

Reihenfolge: Zuerst wird die GUI mit Demodaten fertig gebaut. Danach legt Codex je Menü fest, welche Daten es braucht, und die Engine liefert die passende Abfrage. Später soll alles auf ein durchgehendes JSON-Format umgestellt werden; die Antworten verwenden deshalb schon jetzt überall dieselben Teilobjekte, damit sie sich zu einem gemeinsamen JSON-Zustand zusammensetzen lassen.

Vertrag

  • Einstieg: ModernSession::read(request), Anfrage und Antwort sind JSON (cli::Json). Die Antwort ist {ok: true, …} oder {ok: false, error}.
  • Nur lesend: keine Zufallszahlen, keine Änderung am Spiel, keine neue Revision.
  • Abfragen für den Manager am Schreibtisch (ActiveManager).
  • Gemeinsame Teilobjekte (in allen Antworten gleich):
    • club: {id, name, short} (Welt-ID, UTF-8)
    • player: {id, name} (stabile Spieler-ID, Vor- und Nachname)
    • league: {index, id, name}
    • Datum ISO YYYY-MM-DD, Saison "2026/27", Geld in Euro als ganze Zahl.

Grundabfragen (Stand 24.10.2026)

Anfrage Antwort
{kind: "status"} manager {index, name}, club (oder null, z. B. am Bundestrainer-Schreibtisch), league, place, date, season, money
{kind: "leagues"} leagues: [{index, id, name, clubs, matchdays, played}]
{kind: "table", league} league, played, rows: [{rank, club, played, won, drawn, lost, goals_for, goals_against, points}] (aktueller Stand, mit Punktabzug)
{kind: "fixtures", league, matchday?} league, matchday, matches: [{id, home, away, result: [h, a] | null, status: open | played | postponed | rescheduled | unavailable}]; ohne matchday der nächste; nur played enthält Torzahlen
{kind: "toto"} Tippschein des Spieltags und eigene Spalten, siehe Toto
{kind: "sponsor"} Exklusiv-Sponsor aus einem Trainingslager: offenes Angebot und vorgemerkter Vertrag, siehe Trainingslager
{kind: "squad", club?} club, players: [{slot, player, nation, position (gk/def/mid/fwd), age, technique, condition, form, strength, skills {teamplay, speed, shooting, passing, tackling, free_kick, corner}, lineup (start/bench/none), injured_weeks, banned_weeks}]; ohne club der eigene Verein, sonst Welt-ID oder Laufzeitindex
competitions, winners, player_stats siehe Spielstatistik

league darf der Ligaindex (0–8) oder die Liga-ID der Welt sein. Fehler: invalid_request, invalid_manager, invalid_league, invalid_matchday, invalid_club, unavailable.

Code: src/modern/content/projections.hpp/.cpp. Prüfen: MODERN_STATS=1 modern_season_sim <welt.obw> 20 0 1 zeigt Beispielanfragen und Antworten.

Nächste Schritte

  • Je Menü der fertigen GUI: Codex nennt die benötigten Felder (am einfachsten als Beispiel-JSON aus der Demo), die Engine baut die Abfrage, beide Seiten testen gegen dasselbe Beispiel.
  • Aktionen (ModernSession::apply) nach demselben Muster, mit Revision wie bei den bestehenden Desk-Aktionen.

Aktive Pokalansichten für RmlUI

ui_read {kind: "other-index"} liefert mit Snapshot-Hülle views und defaultViewId. Jede Ansicht enthält id, name, competition, page, entry, rounds, currentRound, knockout, twoLegs. Der Katalog folgt ActiveSelectors und den Gruppen-/Phasenlinks der vorhandenen Core-Projektion.

ui_read {kind: "other-fixtures", viewId, round?} liefert diese Metadaten sowie viewId, round, heading, available, reason, matches. name bezeichnet hier den Wettbewerb; Gruppen-/Phasenzusätze stehen in der Überschrift und im ausführlichen Pickernamen des Index. Ohne round gilt die aktuelle Core-Runde; explizite Runden beginnen bei 1. Jede Paarung hat id, home, away, status, result, phase, secondLeg, secondLegPhase, secondLegVisible, date, homeHasSquad, awayHasSquad. Nur played enthält result: [Heimtore, Auswärtstore]. open und scheduled enthalten null; letztere können ein ISO-Datum haben. secondLeg verwendet dieselben angezeigten Seiten, obwohl die gespeicherte zweite Partie vertauscht liegt. phase ist der gespeicherte Pokalmarker (0 normal, 1 Verlängerung, 2 Elfmeterschießen), kein rekonstruierter Phasen-Teilstand. available: false enthält keine Paarungen; reason ist round_pending oder stage_pending. Ungültige Ansichten/Runden und fehlende Core-Daten werden abgewiesen.

Spielerstatistiken und Fairplay

ui_read {kind: "player-rankings", leagueId, scope: 0|1} liefert kind, requestLeagueId, tatsächliche leagueId, scope, season, team und categories (Tore, Vorlagen, Gelb, Rot). Jede Liste enthält nur positive Werte und wird vom Engine-Provider sortiert, einschließlich Gleichstandsplätzen. Zeilen: rank, player {id,name}, club {id,name}, appearances, goals, assists, yellow, second_yellow, red, value, photoAssetId, currentTeam. currentTeam ist eine aktuelle Teamreferenz oder null; club bezeichnet den Verein des letzten ausgewerteten Einsatzes. scope 1 zählt nur Beiträge für den eigenen Verein und verwendet dessen Liga; requestLeagueId bewahrt die UI-Ligavorliebe.

ui_read {kind: "fairplay"} liefert die laufende Saison und erste deutsche Liga, weights {yellow:1,red:4}, recordedMatches und rows mit rank, team {id,name}, yellow, red, points. Rot zählt Rot plus Gelb-Rot; Gelb zählt ausdrücklich aufgezeichnete Gelbereignisse. Alle aktuellen Vereine sind enthalten. Die Gewichtung ist eine Anzeigeauswertung, keine Disziplinarregel.

Beide Reads sind rein und revisionsgebunden. Es gibt keinen Demoersatz bei leeren Kategorien und keine erfundenen Fotos/Profilwerte. OBW und Editor bleiben unverändert.

Saisonvorbereitung nach Neuanlage

ui_read {kind: "opening"} liefert enabled, showEntrants, entrants mit uefa/champions/winners (je Teamreferenzen), order (abwechselnd Heim/ Auswärts der tatsächlichen DFB-Erstrundenpaarungen) und passende fixtureIds. Die übliche Snapshot-Hülle bindet an Karriere, Welt, Manager und Revision. Quelle sind die aktiven Europapokal-Listen der Engine und die vorhandene Pokalprojektion; Original-Pixel-Platzierungstabellen werden nicht benötigt. Die Abfrage initialisiert oder würfelt nichts. Die native UI verwendet sie direkt nach Neuanlage; ein späteres Laden erzeugt keine weitere Karriere.