5.9 KiB
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.