178 lines
10 KiB
Markdown
178 lines
10 KiB
Markdown
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
||
# Nativer Live-Ticker als UI-Demo (by Codex)
|
||
|
||
Der Anstoß-Einstieg der nativen Modern-Demo öffnet ausschließlich den Textticker.
|
||
Eine grafische Spielansicht gehört nicht zu diesem Paket. Die Fläche bleibt im
|
||
vorhandenen 3840×2160-Canvas proportional 16:9; die drei Skins verwenden dieselbe
|
||
Geometrie. Links stehen eine bis vier eindeutige menschliche Partien und ein
|
||
geteilter Ticker. Rechts wechseln unabhängige Managerpfeile zwischen Team,
|
||
Taktik, Gegner, Live-Tabelle und Statistik. Es gibt keine Schiedsrichterbox,
|
||
Manager-Tableiste oben oder leere Eingriffsbox.
|
||
|
||
Diese Ansicht spielt eine endliche, vorgegebene **UI-Demoaufzeichnung** ab. Ihre
|
||
Ergebnisse, Spielereignisse, Statistik und Tabellenstände sind deklarierte
|
||
Fixtures. Die sichtbare Kennzeichnung bleibt beim Abspielen und im Bericht
|
||
vorhanden. Weltidentitäten, Namen und vorhandene Spielerattribute stammen aus
|
||
dem schreibgeschützten Katalog; unbekannte Attribute bleiben unbekannt. Die
|
||
Ansicht konstruiert weder GameState noch Runtime, liest keinen Spiel-RNG und
|
||
führt aus einem Timer keine Spielaktion aus. Es entsteht keine zweite
|
||
Match-Engine.
|
||
|
||
## Provider und Identität
|
||
|
||
`DataSource::read_live(const Json&) const` liefert standardmäßig
|
||
`{ok:false,error:"live_unavailable"}`. Eine spätere autoritative Sessionanbindung
|
||
muss diesen Read ausdrücklich implementieren. Der aktuelle `DemoSource`
|
||
überschreibt ihn allein mit dem reinen Provider `query_demo_live`.
|
||
|
||
```json
|
||
{"kind":"fixture","revision":7}
|
||
```
|
||
|
||
Das Ergebnis enthält `ok`, `schema:"openbmh-live-fixture@1"`,
|
||
`source:"ui-demo-fixture"`, `fixture_id`, `source_revision`, `world`, `date`,
|
||
`role`, `surface`, `duration`, `field_count`, `owners`, `matches` und `frames`.
|
||
Die Source-Revision bezeichnet den gelesenen Ausgangszustand; sie ist weder
|
||
Ereignissequenz noch Managerauswahl. Die Fixture-ID ist unabhängig von der
|
||
rechts gewählten Person. Match-IDs enthalten Welt, Datum, Bereich, Fläche und
|
||
beide Teamidentitäten; Owner-IDs verwenden die stabile Porträtidentität. Zwei
|
||
menschliche Gegner erscheinen in derselben Partie mit zwei Owner-Referenzen.
|
||
Jede Partie und jedes Ereignis hat eine eigene ID.
|
||
|
||
```json
|
||
{"kind":"frame","sequence":3,"fixture_id":"ui-live:…","revision":7}
|
||
```
|
||
|
||
Dieser Read liefert genau einen vorgegebenen Snapshot mit `sequence`, `minute`,
|
||
`phase`, Matchwerten und dem bis dahin sichtbaren Ereignisprefix. Wiederholte
|
||
Reads sind identisch und verändern weder Sourcezustand/-revision noch
|
||
Dirty-Baseline, Weltdateien oder Kalender. Fremde Queryfelder, ungültige
|
||
Sequenzen und veraltete Revisionen/Fixture-IDs werden ausdrücklich abgewiesen.
|
||
Ein fehlender Provider wird nicht durch geratene Ergebnisse ersetzt.
|
||
|
||
Die Aufzeichnung enthält Anpfiff, Heimführung, Verwarnung, Halbzeit, Wiederanpfiff,
|
||
Ausgleich, Torchance, erneute Heimführung und Abpfiff. Sie endet nach exakt
|
||
90 Minuten auf Rasen und 40 Minuten in der Halle. Diese Werte beschreiben die
|
||
Fixture; sie sind keine hinzugefügten Regeln einer Matchsimulation. Ein kurzer
|
||
Ergebnis-/Berichtsbildschirm zeigt danach den festgelegten Verlauf, ohne Datum,
|
||
Wertung, Konten, Nachrichten oder Saisonfortschritt zu publizieren.
|
||
|
||
## Kader- und Bereichsprojektion
|
||
|
||
Aktive Personen, Team und Fläche kommen aus `demo_career_context`. Nur die
|
||
aktive Nationalrolle stellt Deutschland und den zugehörigen menschlichen Owner
|
||
dar; Vereinsfinanzen und eine Vereins-Ligatabelle werden dort nicht eingeblendet.
|
||
Die bisherige native Nationaldemo benutzt ausdrücklich die Vereinsaufstellung
|
||
als **Demokaderbasis**, nicht als behauptete Nationalkaderberufung. `Caps` und
|
||
internationale Tore werden nur bei entsprechenden Katalogattributen angezeigt;
|
||
andernfalls steht `—`, nie eine aus Vereinsstatistiken geratene Zahl.
|
||
|
||
Für jeden Verein liest der Provider dessen aktuelle Präsentationsaufstellung
|
||
und Taktik: beim aktiven Owner direkt, bei inaktiven aus `career_views[club]`.
|
||
Unbesuchte Vereine bekommen ausschließlich reine Aufstellungs-/Taktikdefaults,
|
||
ohne `Source.apply`. So übernimmt die rechte Ansicht nicht versehentlich den
|
||
Kader oder die Änderungen des ersten Managers.
|
||
|
||
Hallenfelder bleiben getrennt: `on_field_limit=6`, `rotation_rows=min(11,
|
||
roster_size)`, `roster_size` ist die tatsächliche Spielerzahl und
|
||
`roster_limit=null`, weil hier keine allgemeine harte Kadergrenze belegt wird.
|
||
Die Ansicht gruppiert sechs Aktive, bis zu fünf Partner des ersten 11er-Plans
|
||
und weitere vorhandene Reserven. Die komplette echte Kaderliste bleibt lesbar;
|
||
interne elf Strukturpunkte machen keine zusätzlichen Feldspieler. Rasen hat
|
||
elf aktive Positionen und ebenfalls alle vorhandenen Reserven. Der Provider
|
||
leitet daraus keine neue Auswechsel- oder Kaderregel ab.
|
||
|
||
Die Live-Tabelle nutzt echte Teamidentitäten, aber ausschließlich vorgegebene
|
||
Demozahlen, sichtbar als solche gekennzeichnet. Alle Owner derselben
|
||
Katalogkonkurrenz lesen dabei denselben Tabellensnapshot; nur die eigene
|
||
Zeilenmarkierung wechselt. Sie rekonstruiert keine
|
||
Ligahistorie. Kleine Kataloge liefern weniger Zeilen, höchstens 18 werden in der
|
||
Demo-Tabelle dargestellt. Das Nationaldemo-Länderspiel besitzt keine Ligatabelle.
|
||
|
||
## Reine Wiedergabe und Eingabe
|
||
|
||
`LivePlayback` hält eine lokale Kopie der validierten Aufzeichnung. `next()`
|
||
zeigt deren nächsten Snapshot; `elapse(milliseconds)` darf bei Speed 1–4 nur
|
||
vorhandene Snapshots enthüllen. Speed 0 ist Pause. Ein verzögertes Fenster
|
||
überspringt keinen unbeschränkten Rückstau. Reads, Managerwahl und Tabwechsel
|
||
führen keine Ereignisse aus und schreiben keine Savefelder.
|
||
|
||
Der dezente senkrechte Regler hat seine Pausenstellung unten. Weil RmlUI-Werte
|
||
nach unten wachsen, speichert allein das native Widget den invertierten
|
||
Positionswert `4-speed`; API, Snapshot, Beschriftung und ARIA-Wert verwenden die
|
||
logische Geschwindigkeit 0–4. Home setzt Pause, End die höchste Stufe,
|
||
Pfeil-hoch/-runter ändern die Stufe. `P` und der Abspielen-/Pausebutton bedienen
|
||
dieselbe Wiedergabe. Der Regler wird während eines Pointerdrags nicht durch einen
|
||
Timerrender ersetzt.
|
||
|
||
Die rechte Ownerauswahl verändert weder Sequenz noch den links gewählten Match-
|
||
oder Tickerfilter und erhält die Scrollposition des gemeinsamen Tickers. Für ein
|
||
Einzelspiel gibt es eigene linke Partiepfeile. Beide Auswahlachsen sind getrennt.
|
||
Tab/Escape und Kontextrechtsklick bleiben auf Liveansicht oder offenem Dialog
|
||
begrenzt; eine offene gemeinsame Optionsliste behält ihre eigene erste Priorität.
|
||
|
||
## Wechsel- und Taktikvorschau
|
||
|
||
Aufstellung/Wechsel und Taktik verwenden die vorhandenen reinen Edithelper an
|
||
einem **lokalen Ownerentwurf**. Die Dialoge benennen ihre Demogrenze. Eine
|
||
Übernahme zeigt nur diese Vorschau; sie sendet kein erfolgreiches Enginekommando,
|
||
ändert keine Source-Revision und beeinflusst die feste Ereignisfolge nicht.
|
||
Abbrechen verwirft den Entwurf. Die Halle bietet auch weitere vorhandene
|
||
Reserven an und erfindet keine zusätzliche Austauschgrenze.
|
||
|
||
Beim Öffnen eines Dialogs pausiert die Wiedergabe; nach Schließen kann nur die
|
||
vorherige Wiedergabestufe weiterlaufen. Wechselnde Sourceidentität, Welt oder
|
||
Revision pausieren einen alten Mitschnitt. Ein erneuter Anstoß liest dann eine
|
||
neue Aufzeichnung. Weltwechsel löschen die lokale Wiedergabe und Entwürfe.
|
||
Ein normaler Desktop-Rückweg pausiert und kann denselben unveränderten Mitschnitt
|
||
später wieder öffnen. Kein Playbackzustand wird in einem Karrierecheckpoint
|
||
oder Original-OBW gespeichert.
|
||
|
||
## Dateien und Prüfung
|
||
|
||
- `demo_live.hpp/.cpp`: reiner Provider, Validierung und finite Playbackklasse.
|
||
- `live_state.inc`, `live_screens.inc`, `live_controls.inc`: lokale Appansicht und
|
||
Maus-/Tastatureingaben; `assets/modern/live.rcss`: Layout und drei Skins.
|
||
- `modern_live_ui_tests`: synthetischer Katalog mit mehreren Menschen, Quellen-
|
||
invarianten, identischen Reads, Matchdedupe, Ownerwechsel ohne Seek, reiner
|
||
Pause, 40/90-Abschluss, Scopeguards und lokalen Kaderreferenzen.
|
||
|
||
Mit `modern_live_ui_tests --write-fixtures <neuerOrdner>` können reproduzierbare,
|
||
synthetische Weltdaten und gültige native Democheckpoints für GUI-Tests erzeugt
|
||
werden. Sie enthalten keine Originaldaten. Die abschließende Linux-/SDL-/RmlUI-Kohorte besteht zehn normal beendete
|
||
Prozesse mit **1.811 von 1.811 Prüfungen**: alle drei Skins bei 1080 und 720,
|
||
geteilte menschliche Partie, tatsächlicher National-/Hallenwechsel über den
|
||
Managerhub und ein 3840×2160-Lauf. Geprüft sind echte Maus-/Tastatur-/Mausrad-
|
||
Eingaben, gesetzte Themepräferenz, Textflächen, Zweispaltigkeit, native
|
||
Optionsauswahl der letzten echten Reserve, Vorschauabbruch/-übernahme,
|
||
Home/End/P, unveränderte Source-/Revisions-/Dirty-Werte und Bericht/Rückweg.
|
||
|
||
Ein separater echter SDL/X11-Lauf mit physischem Down→Move→Halten→mehrere
|
||
Moves→Up besteht 18/18 Prüfungen. In derselben gehaltenen Geste werden Stufen 4,
|
||
2 und 0 erreicht; auch über einen fälligen Replayframe hinaus bleibt die Sequenz
|
||
bis Pointer-up unverändert. Erst nach Ende der Geste darf das lokale Markup
|
||
ersetzt werden; der Regler erhält dann seinen Tastaturfokus zurück. Es gibt
|
||
keinen globalen Mouse-Capture-Workaround.
|
||
|
||
Die fünf betroffenen CTest-Gruppen `modern_live_ui_tests`,
|
||
`modern_career_ui_tests`, `modern_lineup_ui_tests`, `modern_opening_ui_tests`
|
||
und `modern_ui_core_tests` sind grün. Die finalen nativen Theme-/Scope-PNGs
|
||
wurden tatsächlich gesichtet. Private GUI-Ressourcen und Bildschirmbelege
|
||
bleiben außerhalb dieses öffentlichen Repositories. Windows und macOS sind
|
||
nicht interaktiv geprüft; dies ist kein Engine- oder Plattformrelease.
|
||
|
||
Der wiederholbare native Eingabelauf liegt in
|
||
`tools/modern_ui/live_demo_qa.py`. Beispiel mit selbst erzeugten Fixtures:
|
||
|
||
```sh
|
||
modern_live_ui_tests --write-fixtures /tmp/live-fixtures
|
||
python3 tools/modern_ui/live_demo_qa.py \
|
||
--binary /path/to/build/OpenBMH --fixtures /tmp/live-fixtures \
|
||
--gui-assets /path/to/own/gui --output /tmp/live-evidence
|
||
```
|
||
|
||
Der Treiber erfindet keine Livezustände: Klick, Taste, Mausrad und Wartezeit
|
||
laufen durch die normalen RmlUI-/SDL-Pfade. Die JSON-/DOM-/Geometrieproben und
|
||
PNG-Ausgaben bleiben am angegebenen Ziel. Für den eigenen Xvfb werden ein
|
||
installiertes `Xvfb` oder alternativ `--display` benötigt.
|