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

13 KiB
Raw Blame History

Tabellen, Stärken, Ligaspiele und Übrige Spiele

Stand: 23. Oktober 2026. Dieses Paket überträgt vier zusammenhängende Desktopansichten in die native RmlUI. Gestaltungsreferenz ist das private, unveränderte HTML-Mockup bmh_4k_ui, Revision 494a25611de847f23bf714bfdab6708387f581a7, insbesondere desktop/report-menus.js, league-preview.js, table-window.css und menu-themes.css. Proprietäre Referenzbilder und Weltdaten gehören nicht in dieses öffentliche Dokument.

Die Ansichten verbinden echte Katalogdaten aus der geladenen OBW-Welt mit ausdrücklich fiktiven Berichtsergebnissen. Sie starten keine Karriere, führen keine Spiele aus und ändern weder Weltdatei noch Enginezustand.

Sichtbare Daten

Ansicht Darstellung und Herkunft
Tabellen Vereine und Wappen aus dem Katalog; Platz, Spiele, Siege, Unentschieden, Niederlagen, letzte acht Ergebnisse, Punkte, Tore und Tordifferenz aus der deterministischen Demoauswertung.
Stärken Tatsächliche Vereine und Kader; gerundete Mittelwerte vorhandener Stärkewerte für Tor, Abwehr, Mittelfeld, Sturm und gesamten Kader.
Ligaspiele Paarungen und fiktive Ergebnisse der gewählten Vorschau-Liga und Runde, mit echten Vereins-IDs, Namen und Wappen.
Übrige Spiele Meisterschaft wie Ligaspiele; weitere Wettbewerbe als begrenzte fiktive Vorschau. Nach durchlaufenem Demoauftakt kann der DFB-Pokal stattdessen die dort angezeigten Auftaktpaare ohne Ergebnis zeigen.

Vereinsanzahl und Reihenfolge stammen aus dem Katalog. Eine Liga mit 18 Vereinen hat 18 Tabellen-/Stärkezeilen und neun Begegnungen pro Runde; bei 20 Vereinen sind es 20 Zeilen und zehn Begegnungen. Es gibt keine fest verdrahtete 18er-Vereinsliste oder eine zweite Liste mit kopierten Namen. Der verwaltete Verein wird anhand seiner stabilen ID hervorgehoben.

Stärkekomponenten verwenden die OBW-Positionen gk, def, mid und fwd. Ein Spieler mit mehreren Positionen kann in mehreren Positionsgruppen berücksichtigt werden; die Gesamtstärke mittelt die nutzbaren Kaderwerte. Fehlende Positionen oder fehlende/verwertungsungeeignete Stärkedaten bleiben null und erscheinen als —. Es werden keine erfundenen Ersatzspieler oder scheinbaren Nullstärken eingesetzt. Eine tatsächlich gespeicherte Stärke von null bleibt dagegen ein vorhandener Wert.

Reproduzierbare Ergebnisse und Form

Die Vorschau bildet zwei Halbserien mit vertauschtem Heimrecht und stabiler Katalogreihenfolge. Die Anzahl der Runden folgt der Ligagröße: 18 Vereine ergeben 34, 20 Vereine 38 Runden. Ergebnisse entstehen durch festgelegte Ganzzahlarithmetik aus Runde, Vereinsindizes und Ligaindex, entsprechend dem HTML-Prototyp. Sie verbrauchen keinen Zufall der Engine. Gleicher Katalog und gleicher Vorschauzustand ergeben dieselben Ergebnisse.

Die Tabelle wertet die ersten 26 gespielten Vorschaurunden aus, soweit der fiktive Spielplan reicht. Die gewählte Runde des Begegnungsberichts ändert diese Tabellenauswertung nicht. Der Bericht kann auch andere Runden anzeigen; deren Zahlen sind ebenfalls Dummydaten und keine ausgetragenen oder simulierten Spiele.

S, U und N bezeichnen die letzten bis zu acht Ergebnisse innerhalb des gewählten Tabellenfilters. Für die Sortierung der Formspalte zählen Siege drei und Unentschieden einen Vorschaupunkt. Die Standardsortierung verwendet Punkte, Tordifferenz und erzielte Tore; weitere Gleichstände bleiben stabil. Die farbigen Platzmarkierungen folgen dem errechneten Platz und bleiben auch bei anderer Spaltensortierung dem jeweiligen Verein zugeordnet.

Die Qualifikationslegende übernimmt die vereinfachte HTML-Darstellung: in der ersten Liga Champions-League-Plätze 1–4, Europa League auf Platz 5, Conference League auf Platz 6 und die letzten drei Plätze als Abstieg. Darunter werden Aufstieg, gegebenenfalls Aufstiegsrelegation und Abstieg markiert; die vierte Stufe zeigt einen direkten Aufstiegsplatz. Das sind Darstellungsmarken der Demo, keine neuen Wettbewerbs-, Aufstiegs- oder Qualifikationsregeln für eine Engine. Sie erzeugen keine Teilnehmerlisten.

Gemeinsame Auswahl und Sortierung

Die vier Ansichten teilen einen reports-Zustand mit stabiler Liga-ID, Rundenindex, Tabellenfilter, Wettbewerb und getrennten Sortierungen für Tabellen und Stärken. Ein Ligawechsel bleibt deshalb beim Wechsel zwischen den Ansichten erhalten. Länder- und Ligaauswahl ändern die Vorschau, nicht Manageridentität oder verwalteten Verein. Erneutes Wählen desselben Landes setzt wie im HTML auf dessen erste Katalogliga zurück.

Die Tabellenfilter sind „Alle Spiele“, „Hinrunde“, „Rückrunde“, „Heim“ und „Auswärts“. Die Spaltenköpfe wechseln die Sortierrichtung; numerische Spalten beginnen bei neuer Auswahl absteigend, Platz und Vereinsname aufsteigend. „Pl. / Verein“ sortiert nach Platz, nicht nach Vereinsname. In der Stärkenansicht ist die Vereinsspalte nach Namen sortierbar. Gleiche Sortierwerte behalten ihre stabile Ausgangsreihenfolge; fehlende Stärkewerte stehen in beiden Richtungen hinter vorhandenen Werten.

„Gesamt“ setzt die Tabellenansicht auf die erste deutsche Liga, alle Spiele und Punkte absteigend zurück. Die Stärkensortierung und andere unabhängige Auswahlen bleiben erhalten. Der aktuelle Rundenindex wird auf den gültigen Bereich begrenzt, nicht pauschal wieder auf Runde 27 gesetzt.

Die Rundenpfeile laufen innerhalb der verfügbaren Vorschaurunden umlaufend. Für nicht zur Meisterschaft gehörende „Übrige Spiele“ übernimmt die Demo 34 Vorschaurunden und feste Beispielpaarzahlen je Wettbewerb. Die Vereine dieser Beispiele stammen aus der ersten deutschen Katalogliga; das ist keine echte internationale Teilnehmerauswahl. Gegenüber dem HTML werden Runden bei Liga-/Wettbewerbswechseln und bei der Anzeige eines anderen Kontexts ausdrücklich auf dessen Bereich begrenzt. Diese Absicherung ist eine bewusste Abweichung der UI-Vorschau, keine Terminregel des Spiels.

Footerpicker und Fokus

Die untere Bedienleiste enthält je nach Ansicht:

  • Tabellen: „Gesamt“, Spielefilter, Land und Liga.
  • Stärken: Land und Liga.
  • Ligaspiele: zwei Rundenpfeile, Land und Liga.
  • Übrige Spiele: zwei Rundenpfeile und Wettbewerb.

Die Berichtspicker sind native RmlUI-Menüs mit sichtbarer Markierung der aktuellen Option. Klick, Enter oder Leertaste öffnen beziehungsweise bestätigen. Auf-/Abwärtspfeil öffnen auch vom geschlossenen Auswahlknopf; im Menü navigieren Auf/Ab sowie Pos1/Ende. Das reine Fokussieren einer Option verändert die gespeicherte Auswahl noch nicht.

Escape oder Rechtsklick schließen zunächst die offene Auswahl. Tab schließt die Auswahlliste und setzt die normale Fokusfolge fort. Ein Klick außerhalb schließt die Liste, ohne das eigentliche Klickziel zu ersetzen. Nach einer Auswahl liegt der Fokus wieder auf dem zugehörigen Footerknopf; nach Sortierung, Reset oder Rundenschritt auf dem auslösenden Knopf. Details sperren Hintergrundaktionen. Abbruch, Auswahl, Fokusumlauf und Fokusrückgabe wurden mit echten RmlUI-Ereignissen geprüft.

Vereins-, Kader- und Spielerprofile

Vereinsknöpfe in allen vier Ansichten öffnen ein Vereinsprofil. Dort werden Wappen, Stadion, Kapazität, Stärke und Manager aus vorhandenen OBW-Daten beziehungsweise der Demo-Managerzuordnung angezeigt. Vorliegende Stadionbereiche können zur Kapazität summiert werden; fehlende Angaben bleiben sichtbar als —. Eine explizite Vereinsstärke und ein aus Kaderspielern gebildeter Mittelwert haben unterschiedliche Datenquellen und werden nicht als identische Kennzahl ausgegeben.

„Spieler“ führt zum tatsächlichen Kader dieses Vereins, in OBW-Kaderreihenfolge. Ein Spielerknopf öffnet dessen Profil mit aufgelöstem Foto beziehungsweise konfiguriertem Asset-Fallback, Positionen, Alter, Stärke, Verein und Vertrag. Das Alter wird bei vorhandenem Geburtsdatum zum Demodatum berechnet. Ein nur importiertes Referenzalter behält seinen bekannten Bezugszeitpunkt; es wird kein Geburtstag erfunden. Vertragsdauer bedeutet verbleibende vollständige Kalendermonate aus einem passenden vorhandenen Vertrag, keine Vertragsverhandlung oder Initialisierung eines Spielzustands.

Die Dialogfolge lautet Bericht → Verein → Kader → Spielerprofil. „Zurück“/„Schließen“, Escape oder Rechtsklick schließen die Detailauflage und stellen den ursprünglichen Berichtsfokus wieder her. Es gibt in diesem Paket keinen Vertrags-, Transfer- oder sonstigen Schreibpfad aus einem Profil. Lange Kader werden innerhalb des Dialogs gescrollt. Tab macht den fokussierten Spieler sichtbar; dasselbe gilt für Vereine in langen Begegnungslisten. Dies verbessert bewusst einen Tastaturfehler der HTML-Vorlage, in der verborgene Zeilen zwar fokussiert, aber nicht automatisch sichtbar werden.

DataSource, Checkpoints und Kalenderkopplung

DemoSource besitzt die getrennten Präsentationsdaten. demo_reports liefert die Auswertungen; Berichtsansichten, Picker und Detailansichten konsumieren sie. Aktionen werden auf einer Kopie validiert. Unbekannte IDs, unerlaubte Schlüssel, falsche Typen und Werte außerhalb der Grenzen werden ohne Veröffentlichung einer Teiländerung abgelehnt.

UI-Checkpoints speichern reports mit Tabellen-/Stärkensortierung, Filter, Liga, Wettbewerb und Runde. Geöffnete Picker oder Detaildialoge sind flüchtige Ansichtszustände; ein Datensnapshot ist kein Versprechen, diese Auflagen nach dem Laden automatisch wieder zu öffnen.

Alte UI-Demostände ohne reports erhalten dessen Defaults und übernehmen dabei die vorhandene Kalenderliga. Alte Stände ohne opening_created erhalten false, auch wenn ihr bisheriges opening-Feld bereits „complete“ lautet. Ungültige vorhandene Berichtsdaten werden nicht still durch Defaults ersetzt. Beim Laden vorhandener gültiger Berichtsdaten ist deren Liga für die gemeinsame Kalender-/Berichtsvorschau maßgeblich.

Ein Ligawechsel im Kalender aktualisiert auch die Berichtsliga und begrenzt deren Runde. Umgekehrt übernehmen Kalender und Berichte die in den Berichten ausgewählte Liga gemeinsam. Datumsauswahl und Manageridentität werden dadurch nicht ersetzt.

Der Abschluss des Demoauftakts meldet die Aktion opening = complete und setzt dabei opening_created auf true. Der alte gespeicherte Zeichenkettenwert allein ersetzt diese Abschlussmeldung nicht. Danach verwendet „Übrige Spiele → DFB-Pokal“ dieselben benachbarten Auftaktpaare aus höchstens 64 deutschen Ligavereinen, also höchstens 32 Begegnungen. Überschrift ist „1. Runde“, Ergebnisse bleiben null beziehungsweise „–“, und die Rundenpfeile sind deaktiviert. Das verbindet zwei Demoansichten; es ist weder eine echte Pokalauslosung noch eine neue Session- oder Spielregel.

Referenzgeometrie und Prüfstand

Die HTML-Referenz verwendet den logischen 3840×2160-Desktop mit einem 2720×2040-Fenster bei (560, 60), einer Titelleiste mit 108 und einer Footerbedienung mit 94 logischen Pixeln Höhe. Bei 1920×1080 entsprechen Fenster und Footer 1360×1020 beziehungsweise 47 physischen Pixeln Höhe. Tabellen- und Stärkenbreiten sowie Zeilenhöhen berücksichtigen die tatsächlichen 18 oder 20 Vereine. Bodytext, Tabellenkopf und Auswahlknöpfe orientieren sich an 36, 30 und 32 logischen Pixeln; die Spieltagsüberschrift an 46. Die Themes Midnight, Silver und Matchday verwenden die gemeinsame Menügestaltung. Geometrische Zielwerte sind keine Behauptung pixelgleicher Rasterung zwischen Browser und RmlUI.

Synthetische Providertests prüfen unter anderem 18-/20-Team-Spielpläne, Hin-/Rückspiel und Heimrecht, Punkte-/Torerhaltung, Filterzerlegung, Sortierung, fehlende Positionswerte, atomare Ablehnung, Reset, Clamping und die begrenzten Auftaktpaare. Der isolierte Linux-Komponententest und alle 17 ausgewählten Integrations-/ Regressionstests bestehen auf dem zusammengeführten Stand.

Die unabhängige Menüprüfung erfasst 48 Fälle: vier Ansichten × drei Themes × zwei Größen × 18/20 Vereine. 113 native Bedienungszustände und 94 Browserreferenzzustände decken unter anderem Sortierrichtungen, Filter, Rücksetzen, Ligawechsel, Rundenumlauf und Wettbewerbe ab. Die Detailprüfung umfasst zusätzlich 22 Zustandsprüfungen und drei finale Sichtprüfungen. Gemessene Textboxen passen in ihre Zellen und stehen vertikal mittig; die Bruchteilsverteilung der 20er-Zeilen weicht um weniger als einen physischen Pixel von Chromiums automatischem Tabellenlayout ab.

Private Screenshots, Eingabeskripte, Binärhashes und UI-Demostände liegen in bmh_4k_ui/docs/qa/reports-batch-2026-10-23/. Der OS-Neustart unterbrach den Build; neun fehlende Matrixfälle und die finalen Aufnahmen wurden danach ergänzt. Die beiden Fokuskorrekturen wurden gezielt nachgeprüft. Diese Nachweise betreffen Linux/OpenGL und die beschriebenen Daten; sie sind keine vollständige Windows-/macOS-Laufzeitabnahme oder Freigabe aller Menüs.

Die gemeinsame Paarungsanordnung ersetzt seit 24. Oktober die weit auseinanderliegenden Mannschaftsseiten: Heimname und Heimwappen rechtsbündig zur schmalen Ergebnisspalte, danach Auswärtswappen und Auswärtsname linksbündig.