136 lines
8.3 KiB
Markdown
136 lines
8.3 KiB
Markdown
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
||
# Statistiken
|
||
|
||
Referenz: privater HTML-Goldstand `ddd8cab7` vom 25.10.2026,
|
||
`desktop/report-menus.js` (`stats`, `winners`, `statsBody`) sowie
|
||
`table-window.css`, `trophies.css` und die drei Menüthemen. Die native
|
||
Umsetzung verwendet RmlUI im gemeinsamen Fenster mit 2720 × 2040 logischen
|
||
Pixeln. Das öffentliche Repository enthält keine Referenzbilder oder
|
||
proprietären Datenbestände.
|
||
|
||
Der Einstieg zeigt **Sieger → National → Deutschland**. Die Hauptauswahl
|
||
enthält Möglichkeiten, Transferhistorie, Analytics, Ewige Tabelle,
|
||
WM-Statistiken, Saisonfinanzen, Serien u. Rekorde, Sieger und
|
||
Minuten-Statistik. Nationale Sieger zeigen zwölf Saisons und drei Wettbewerbe
|
||
für Deutschland, Spanien, Italien, Frankreich oder England. International
|
||
bleiben Champions League, Pokalsieger und UEFA-Cup erhalten; Hallenmasters
|
||
zeigt Sieger und Finalist. Die Ewige Tabelle übernimmt sämtliche Vereine der
|
||
höchsten Liga des gewählten Landes, einschließlich einer zwanzigsten Zeile.
|
||
|
||
Analytics zeigt sechs einzeln schaltbare Kurven mit je 24 Punkten. REL./ABS.
|
||
wechselt zwischen beiden Darstellungen. Die WM-Auswahl bietet Sieger,
|
||
Gruppen, Torschützen, Finalrunde, Tabelle und Historie. Die Minutenansicht
|
||
zeigt vier Ereignisse über 18 Fünfminutenintervalle mit den Farbmarkierungen
|
||
des Goldstands. Dropdowns verwenden die gemeinsamen nativen Berichtspicker
|
||
mit Maus, Pfeiltasten, Pos1/Ende, Eingabe, Escape und Fokuswiederherstellung.
|
||
Vereine und Spieler öffnen die vorhandenen Profile. Ein Pokal öffnet sein
|
||
Vollbild-Siegerbild vor dem abgedunkelten Stadion, wenn der
|
||
Welt- oder GUI-Katalog das passende Bild bereitstellt. Escape, Rechtsklick und Weiter
|
||
schließen das Bild und stellen den Fokus auf dem auslösenden Pokal wieder her.
|
||
|
||
Alle Zahlen und historischen Ergebnisse sind ausdrücklich fiktive,
|
||
deterministische Darstellungsdaten nach dem HTML-Muster. Vereins-, Spieler-
|
||
und Länderreferenzen stammen aus dem tatsächlich geöffneten OBW-Katalog.
|
||
Managername und Bezugsdatum werden aus dem aktuellen vollständigen Snapshot
|
||
gelesen; Saisonvergleiche enden bei der letzten abgeschlossenen Saison.
|
||
Fehlende Identitäten erzeugen keine Ersatzvereine oder Ersatzspieler.
|
||
|
||
Die Datenquelle bietet ausschließlich `read_statistics(request)`. Filter,
|
||
Kurvenschalter, Scrollpositionen und Bilddialoge gehören zum lokalen
|
||
Ansichtszustand. Es gibt weder einen Statistik-Schreibbefehl noch einen
|
||
Zugriff auf Engine, GameState oder Zufallsströme. Snapshot, gespeicherte
|
||
Demo-Daten, Revisionsnummer und Dirty-Flag bleiben bei diesen Lesezugriffen
|
||
unverändert. Die vorhandenen [Engine-Statistikabfragen](../../../new_engine/statistik.md)
|
||
für Wettbewerbe, Titelträger und Spielerwerte werden damit noch nicht aufgerufen.
|
||
Der spätere Session-Adapter muss diese Daten in die Ansicht übersetzen;
|
||
weitere Auswertungen benötigen entsprechende Projektionen.
|
||
|
||
`modern_statistics_ui_tests` prüft alle neun Bereiche, sämtliche WM-Ansichten,
|
||
Land-/Wettbewerbsfilter, die vollständige Zwanzigerliga, stabile Identitäten,
|
||
Kurvendaten, ungültige Anfragen, leere Welten und die unveränderliche
|
||
Datenquellengrenze. Native Bild- und Interaktionsprüfung wird separat im
|
||
privaten QA-Lauf dokumentiert; ein bestandener Projektionstest allein ist
|
||
keine visuelle Abnahme.
|
||
|
||
Die englische Fußballnation darf die stabile OBW-Kennung `nation:x-eng`
|
||
anstelle von `nation:en` führen. Länderwahl, ewige Tabelle und WM-Darstellung
|
||
verwenden dieselbe Auflösung; die Titel heißen weiterhin Premier League,
|
||
FA Cup und League Cup. Der Katalog und seine IDs werden nicht verändert.
|
||
Ein synthetischer Regressionstest deckt diese importierte Kennung und die
|
||
vollständige zwanzigste englische Mannschaft ab.
|
||
|
||
Die Demo bevorzugt vorhandene logische Weltbilder unter
|
||
`asset:comp/<Rolle>/trophy`. Die Darstellung akzeptiert außerdem ausdrücklich
|
||
gelieferte Asset-Schlüssel und den generischen Weltpokal als Ersatz. Die
|
||
abgestimmten GUI-Studien dienen nur als Vorschauersatz, falls die Welt die
|
||
entsprechende Demorolle nicht enthält. Der spätere Session-Adapter liefert die
|
||
wettbewerbsspezifischen Referenzen der tatsächlichen Historie. Auflösung und
|
||
Seitenverhältnis bleiben vom Datensatz bestimmt; das OBW wird nicht bearbeitet.
|
||
|
||
## Anbindung an die laufende Modern-Karriere
|
||
|
||
Der Engine-Einstieg verwendet denselben Presenter mit dem Session-Read
|
||
`{kind: "statistics", query: {...}}`. Die Abfrage delegiert an die vorhandene
|
||
`ModernSession::read_statistics_screen`; die UI berechnet keine zweite
|
||
Spielstatistik. Filter: `section` (0–8), `category` (0/1/5), `country` (0–5),
|
||
`winner_country` (stabile Nation-ID), `absolute` und sechs `curves`-Schalter.
|
||
Der Read trägt den üblichen Welt-/Karriere-/Manager-/Revisionskontext.
|
||
|
||
Die vorhandenen Almanachauswertungen liefern ewige Tabelle, Nationalturniere,
|
||
Serien/Rekorde, Sieger und Minutenintervalle. Transferhistorie und Analytics
|
||
kommen aus den vorhandenen gespeicherten Managerzeilen. Fehlt eine belegte
|
||
Historie, bleibt die Auswahl bedienbar und zeigt eine Leeranzeige. Insbesondere
|
||
werden Titelchancen, fehlende Saisonfinanzen oder nicht aufgezeichnete
|
||
Turniergruppen nicht mit POC-Werten gefüllt.
|
||
|
||
Die Graphprojektion erhält die originalen Ganzzahlmesswerte. Sie normalisiert
|
||
sie nur in das vorhandene moderne SVG-Koordinatensystem; die erste Kurve
|
||
(Tabellenplatz) läuft von oben nach unten, die übrigen von unten nach oben.
|
||
Absolute Darstellung verwendet die vom Read gelieferten Grenzen, relative die
|
||
Grenzen der jeweiligen Messreihe. Konstante Messreihen liegen mittig, Werte
|
||
außerhalb der absoluten Skala werden visuell begrenzt. Die sechs Farben gehören
|
||
zur GUI-Palette. Keine Zufallswerte und keine zurückgeschriebenen Messwerte.
|
||
|
||
Vereinslinks verwenden stabile IDs aus der Aufzeichnung und führen zum
|
||
vorhandenen Vereins-/aktuellen Kaderprofil. Archivspielernamen bleiben aus der
|
||
Aufzeichnung; ein historisches Profil zeigt unbekannte heutige Werte ausdrücklich
|
||
als „—“. Ein Pokal öffnet nur dann ein Siegerbild, wenn die Historie tatsächlich
|
||
einen Sieger und dessen Saison nennt. Das Bild stammt aus dem Weltpaket bzw.
|
||
dem bereits vorhandenen GUI-Ersatz, ohne Änderung am Datensatz.
|
||
|
||
### Verifizierte Wettbewerbszuordnung (#21)
|
||
|
||
Die tatsächliche Pokaltabelle ordnet UEFA-Cup/Champions League/Pokalsieger den
|
||
Indizes 1/2/3 zu; der Almanach speichert jeweils Index+1. Die ältere
|
||
Statistikauswertung hatte die europäischen Titelträger zyklisch vertauscht.
|
||
Die Zuordnung verwendet jetzt die richtigen Typen 3/4/2. Der deutsche Supercup
|
||
(Index8, Typ9) ist als dritte Titelspalte vorhanden; ausländische Meisterschaften
|
||
verwenden ihre vorhandenen jeweiligen Pokalrollen. Es werden keine zusätzlich
|
||
nicht simulierten ausländischen Pokalwettbewerbe erfunden.
|
||
|
||
Der Gegenfall benutzt unterschiedliche synthetische Sieger pro Pokal; vor dem
|
||
Fix scheitert er an der Champions-League-Spalte. Eine über die echte Session
|
||
bis nach dem Saisonwechsel gespielte Karriere bestätigt die Zuordnung gegenüber
|
||
dem unabhängigen vorhandenen `read_statistics({kind:"winners"})`-Read.
|
||
Die tatsächliche Titelvergabe und die gespeicherten Archivbytes bleiben gleich.
|
||
|
||
### Native Prüfung des Enginepakets (29.10.2026)
|
||
|
||
58 synthetische Regressionstests, 284 Haupt-GUI-Prüfungen, 44 zusätzliche
|
||
Profil-/Leerstandprüfungen und 1.600 Geometrie-/Schriftprüfungen bestanden.
|
||
Drei Themes in 1080p, zusätzlich Silver in 720p; alle neun Sektionen, alle
|
||
Länder, nationale/internationale/Hallen-Sieger, echte Kurvenumschaltung,
|
||
Pokalbild und Vereins-/Spielerabsprünge. Die Schriftgröße der Dropdownoptionen
|
||
entspricht der Buttonbeschriftung; Tabellen-, Legenden- und Auswahltexte liegen
|
||
in ihren Flächen und sind vertikal ausgerichtet.
|
||
|
||
Eine über die echte Session bis nach dem ersten Saisonwechsel gespielte
|
||
Karriere liefert Abschlusstabellen und Titel. 30 wiederholbare API-Abfragen,
|
||
drei fehlerhafte Filter und acht unabhängige Siegervergleiche sind geprüft.
|
||
Vorher/Nachher für #21, Rohantworten, native Screenshots und passende OBS liegen
|
||
privat unter `bmh_4k_ui/docs/qa/engine-statistics-2026-10-29/`. Reine Ansichten,
|
||
Filter und Save verändern weder den nativen Spielzustand noch RNG-/Archivbytes.
|
||
Der explizite Demo-Einstieg bleibt separat und wurde nativ nachgeprüft.
|
||
Linux x64/SDL2/OpenGL ausgeführt; native Windows-/macOS-Ausführung offen.
|
||
Anstoß bleibt gesperrt. Keine Änderungen an Classic, Match- oder Saisonregeln.
|