Files

94 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](toto.md) |
| `{kind: "sponsor"}` | Exklusiv-Sponsor aus einem Trainingslager: offenes Angebot und vorgemerkter Vertrag, siehe [Trainingslager](trainingslager.md#exklusiv-sponsor) |
| `{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](statistik.md) |
`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.