Files
Dreierpack-Manager/docs/new_ui/desktop/live/README.md
T

225 lines
12 KiB
Markdown
Raw 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.
<!-- 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.
## Zuschauer und Wetter vor dem Start
Jede eindeutige Partie zeigt bereits bei Sequenz 0 ihre Zuschauerzahl und das
Wetter. Die Zeile bleibt während der Wiedergabe sichtbar; die Halle zeigt „Halle“
statt Außenwetter. Zwei gegnerische menschliche Manager teilen dieselbe Partie
und damit dieselben Bedingungen. Die Werte werden auch in den Nachspielbericht
übernommen; eine Übersicht zählt jede Partie nur einmal.
Die optionalen Felder auf jedem `openbmh-live-fixture@1.matches[]`-Eintrag sind:
```json
{"attendance": 26400, "weather": {"temperature": 18, "rain": 0}}
```
`attendance` ist eine nichtnegative Ganzzahl (bis INT32_MAX), `temperature`
eine vorzeichenbehaftete Celsius-Ganzzahl (-128…127). `rain` ist der originale
Wetterbild-Code 0…7, kein Prozentwert: sonnig, heiter, wolkig, bedeckt, Regen,
Regen, Schnee, Schnee. Es werden keine Wetterwerte aus der Temperatur abgeleitet.
Fehlende oder `null`-Werte bleiben unbekannt; 0 Zuschauer und 0 °C bleiben
sichtbar. Alte Aufnahmen ohne diese Felder sind weiterhin gültig. Die mitgelieferte
UI-Demo enthält explizite Beispieldaten, ohne RNG, Uhr, Revision oder Karriere zu
verändern. Ein autoritativer Anbieter liefert die tatsächlichen Bedingungen.
## Unabhängige lokale Navigation
Managerpfeile und die fünf Detailreiter ersetzen nur den Inhalt rechts. Die
Meldungsliste, Paarungen, Uhr und der Geschwindigkeitsregler bleiben dabei als
RmlUI-Elemente bestehen. Ein Ereignisfilter ersetzt nur die Meldungen links;
Managerauswahl und rechter Scrollbereich bleiben erhalten. Ein erneuter Klick
auf den bereits gewählten Reiter oder Filter löst keinen Inhaltsaufbau aus.
Pause und Geschwindigkeitswahl aktualisieren ihre Beschriftungen direkt.
Die Änderungen werden nach der Ereignisverarbeitung angewendet, damit keine
noch verwendeten Ziele während ihres Click-Callbacks entfernt werden. Neue
Aufzeichnungsbilder, Bereichswechsel und Dialoge verwenden weiterhin den
vollständigen Renderpfad. Fehlende Teilbereiche fallen auf diesen Pfad zurück.
Die Navigation verändert weder Aufzeichnung noch Quelle oder Revisionsschutz.
Das Eingabeskript-Snapshot nennt unter `live_view.ui_updates` die tatsächlichen
Dokument-, Detail- und Tickeraktualisierungen. Diese Zähler prüfen, dass bei
lokaler Navigation kein vollständiger Dokumentaufbau stattfindet; sie sind
keine FPS-, Latenz- oder Hardwaremessung. Private Vorher-/Nachher-Bilder,
Fokus-/Scrolltests und ladbare Demostände liegen unter
`bmh_4k_ui/docs/qa/live-retained-2026-10-27/`.