# Wiederholbare Menü-QA gegen HTML
Die HTML-Version ist der verbindliche Gestaltungsstandard. Der Vergleich
begleitet fortlaufend die Portierung bis Anstoß. Eine Bildschirmaufnahme
allein bedeutet keine visuelle Abnahme.
## Arbeitsweise
1. Unveränderte HTML-Quelle lesen; Browserbilder, Geometrie, Schrift und
Interaktionszustände aufnehmen.
2. Native Ansicht mit Dummydaten hinter `DataSource` umsetzen.
Datenabweichungen ausdrücklich nennen und das Referenzlayout beibehalten.
3. Dedizierten QA-Agenten den tatsächlichen Renderer gegen HTML prüfen lassen:
drei Themes × 1280 × 720 und 1920 × 1080, einschließlich Buttons,
Dropdowns, langer Texte, Scrollen, Fokus und Abbrechen.
4. Befunde mit Eingabeskript und ladbarem UI-Demostand belegen. Korrekturen
gezielt nachprüfen; vollständige Interaktionsmatrix am Menü-Meilenstein.
5. Gesamtkatalog und offene Befunde fortschreiben. Fehlende Ports bleiben offen.
Das private Mockup-Repository enthält dafür
`tools/qa/native_mockup_compare.py` mit deutscher Anleitung.
`--scenes all` nimmt jede katalogisierte Ansicht bis Anstoß auf; fehlende
native Ports erhalten weiterhin eine HTML-Aufnahme. Native Fälle enthalten
PNG, DOM, Snapshot, Eingabeskript und ladbaren Demostand. Das Werkzeug ist
ein endlicher QA-Lauf. Der zusätzlich eingerichtete lokale Watcher startet
diesen Katalog nach stabilen Build- oder Referenzänderungen automatisch erneut.
Die Matrix trennt technische Aufnahme, Datenabgleich und visuelle Freigabe.
Reviewer, Zeitpunkt und fünf Prüfbereiche werden gespeichert. Unvollständige
Vergleiche bleiben `UNIMPLEMENTED` beziehungsweise `PENDING`. Protokolliert
werden außerdem Binärdatei-, Welt-, GUI- und Demostand-Hashes sowie Referenzrevision.
## Automatisierte Regression
`.github/workflows/modern-ui.yml` baut die aktivierte native UI unter Linux,
Windows und macOS. Fensterlose Tests mit synthetischen Daten prüfen unter
anderem Text-/Pfeilmitten, Dropdown-Schriftgrößen, Themes/Pixeldichten und das
Verwerfen von Eingaben. Private Ressourcen werden dort nicht vorausgesetzt.
CI ergänzt die tatsächlichen Renderer-/HTML-Vergleiche. Ein erfolgreicher
Build bestätigt keine visuelle Abnahme auf dem jeweiligen Betriebssystem.
Auf dem Entwicklungsserver läuft `openbmh-native-ui-qa.service` unabhängig
von einem aktiven Chat weiter. Er beobachtet fertiges Binary, ausgelieferte
Stylesheets, GUI-Index und HTML-Quelldateien; nach 60 Sekunden unverändertem
Stand erfasst er alle Menürouten in den drei Themes bei 1280 × 720. Er behält
die letzten drei eigenen abgeschlossenen Läufe. Identische Stände lösen keine
neuen Aufnahmen aus. Die größere Matrix und gezielte Bedienungsprüfungen
bleiben Teil der Agenten-Abnahme am Menü-Meilenstein.
Der Dienst erzeugt Bilder, Zustände, Logs und offene Reviewchecklisten.
Er erteilt keine automatische gestalterische Freigabe und behebt keine
erkannten Fehler eigenständig. Bedienung und Installationshinweise stehen
im privaten Mockup-Repository unter `tools/qa/README-watch-native.md`.
## Nachweise
Private Bilder und passende UI-Demostände liegen im Mockup-Repository unter
`docs/qa/native-rmlui-2026-10-23/`. Sie enthalten Weltinhalte und gehören
deshalb nicht ins öffentliche Quellcode-Repository. Öffentliche Zusammenfassung:
- [Nativer Stand](NATIVE_STATUS.md)
- [Typografie-Befunde](typography-qa.md)
- [Training](desktop/training/README.md) und [Taktik](desktop/tactics/README.md)
- [Berichte](desktop/reports/README.md): Tabellen/Stärken und zwei Spielübersichten
als gemeinsames Paket; eigenständiger HTML-/Renderervergleich einschließlich
20 Vereinen, Sortierung, Footerpickern und Vereins-/Spielerprofilen.
- [Verlegen](desktop/postpone/README.md),
[Freundschaftsspiele](desktop/friendlies/README.md) und
[Hallentabellen](desktop/indoor/README.md): ein gemeinsames Paket mit
18 Rendererläufen, 43 Bedienzuständen und gesondertem OS-Beenden-/
Speichern-Nachtest. Damals: 18 native und 18 offene Routen.
- [Almanach](desktop/almanac/README.md): Jahreskalender, Tagespartien und
Spielbericht als neues readonly Menü; alle Ergebnisphasen, Kader/Bank,
Ereignisse, alte Ansichten und unveränderte Revision/Dirty-Zustände geprüft.
Nach diesem Paket: 19 native und 18 offene Routen.
- [Bank](desktop/bank/README.md), [Bilanz](desktop/balance/README.md) und
[Verträge](desktop/contracts/README.md): gemeinsames Finanzpaket mit drei
Themes bei 720p/1080p. Bankhalle und fünf Dienste, alle acht Transaktionen,
Kredit-/Bestandsgrenzen, Entwürfe, doppelte Bestätigung und Abbruch geprüft.
Zwölf Bilanz-/Vertragsläufe liefern 96 erfolgreiche Zustandsprüfungen;
42 Text-/Layoutzustände zeigen keinen horizontalen Textüberlauf.
Die 20 ausgewählten Regressionstests bestehen nach Übernahme der parallel
eingetroffenen Engineänderungen. Screenshots, UI-Demostände und Eingabeskripte
liegen privat unter `docs/qa/finance-batch-2026-10-24/`.
Nach diesem Paket: **22 native und 15 noch offene Routen**.
Die Finanzprüfung umfasst echte Linux-/OpenGL-Aufnahmen. Windows-/macOS-
Laufzeitdarstellung wird dadurch nicht als abgenommen ausgegeben.
- [Umfeld](desktop/environment/README.md), [Werbung](desktop/advertising/README.md)
und [TOTO](desktop/toto/README.md): weiteres gemeinsames Paket mit drei
Themes bei 720p/1080p. Direkte Förderstufen, Angebotsannahme, Geldentwürfe,
TOTO-Spalten und letzter Schein wurden durch die native Ereignisverarbeitung
geprüft. TOTO: 138 erfolgreiche Zustandsprüfungen, 18 vermessene
Layoutzustände und gezielte Schlussaufnahmen der korrigierten Elemente.
Echte Checkpoints und Neustarts ergänzen die Browser-/Rendererprüfung.
Die 24 Regressionstests bestehen. Private Nachweise:
`docs/qa/club-batch-2026-10-24/`.
Nach diesem Paket: **25 native und 12 noch offene Routen**.
CSS-Hintergrundbilder werden in der HTML-QA zusätzlich vollständig dekodiert,
bevor Screenshots entstehen. Das verhindert falsche Meldungen über fehlende
oder abgeschnittene Atlaskacheln im Umfeld beziehungsweise in Werbung.
- [Aufstellung](desktop/lineup/README.md) und
[Transfermarkt](desktop/transfer/README.md): gemeinsames Kaderpaket vom
25. Oktober, HTML-Gold `23845730`, drei Themes bei 720p/1080p. Formationen,
Anweisungen, Schützen, Ziehen zwischen Startelf/Bank, Angebotsentwürfe,
Suchfilter, Abwerben und Auftragsgrenzen wurden tatsächlich bedient.
Echte Checkpoint-Neustarts erhalten den vollständigen Demozustand.
Ein unabhängiger 24er-Kaderfall ergänzt die tatsächlichen 20er-Kader.
Korrigiert sind Popup-Markierung/Textmitte, ausgewählte Rosterzeilen ohne
horizontalen Überlauf sowie das Zurücksetzen von Nutzerscrollen pro Frame.
Reine Navigation und Dialogabbruch lassen Quellrevision und Dirty-Zustand
unverändert; Transferaufträge buchen kein Geld und ändern keinen Kader.
Die 26 ausgewählten Regressionstests bestehen. Private Nachweise mit
Screenshots, Eingabeskripten und ladbaren UI-Demoständen:
`docs/qa/squad-batch-2026-10-25/`.
Aktueller Katalog: **27 native und 10 noch offene Routen**. Diese
Routenzahl bezeichnet keine vollständige visuelle Abnahme oder
Engine-Anbindung; Anstoß bleibt ohne Aktion.
Die anschließende Nutzerkorrektur der Aufstellung vergrößert das Spielfeld
proportional bis fast an den unteren Rand und entfernt die doppelte
Ersatzbankfläche. Die Kaderliste zeigt jetzt Startelf, Ersatzbank und „—“;
für die aktuelle deutsche Demo sind dies bei 20 Spielern 11/6/3 und bei
24 Spielern 11/6/7. Das HTML-Mockup wird dafür ebenfalls aktualisiert.
Der getrennte Nachweis unter `docs/qa/lineup-layout-2026-10-25/` hält die
neuen Maße, schmaleren Controls und Kaderaktionen fest. Die alten Bilder
des Kaderpakets werden als Vorher-Belege erhalten.
Die weitere Nutzerkorrektur gibt der Tabelle zwei Drittel und der
Aufstellung ein Drittel der Höhe. Die Namensspalte wächst von 390 auf
900 logische Pixel, während Zahlen- und Statusspalten kompakter bleiben.
20 Spieler passen vollständig, 24 bleiben scrollbar. Formationen im
2×2-Raster, proportional verkleinerte Sprites, Anweisungen und drei
nebeneinanderliegende Schützenfelder erhalten eigene Nachweise unter
`docs/qa/lineup-table-focus-2026-10-25/`; auch Daten B und die Sichtgrenzen
aller drei Schützenlisten gehören zum Vergleich.
Das Statistikpaket ergänzt [Erfolge](desktop/achievements/README.md),
[Spielerstatistiken](desktop/scorers/README.md),
[Fairplay](desktop/fairplay/README.md) und [Highscore](desktop/highscore/README.md).
Die 28 ausgewählten Regressionstests bestehen. Die nativen Prüfungen decken
alle vier Ansichten in drei Themes bei 720p/1080p ab, ergänzt durch
Seiten-/Kategoriegrenzen, Karten-Gleichstände, Länder-/Ligawahl,
Vereins-/Spielerprofile, Dialog-/Pickerabbruch und echte Checkpoint-Neustarts.
Alle Statistik- und Filteraktionen lassen Demomodell, Revision und
Spiel-Dirty-Zustand unverändert. Sichtbar geprüft und korrigiert sind
Textspans in Flexzellen, Wappen-/Namensabstände, eigene Footerproportionen,
Fairplay-Farben sowie Highscore-Header und Zahlenzentren.
Private Screenshots, UI-Demostände, Replays und Quell-/Runtimehashes:
`docs/qa/statistics-batch-2026-10-25/`.
Der Gesamtkatalog umfasst damit **31 native und 6 offene Routen**;
die allgemeine Ansicht „Statistiken“ bleibt ein eigenes späteres Paket.
Das [Stadionpaket](desktop/stadium/README.md) umfasst Innenansicht, acht
Blöcke A–H, Sitzplätze/Überdachung, acht Ausstattungsbereiche und deren
Stufenbilder sowie Stadiondaten. Peripherieausbau ist ausdrücklich vom
Nutzer zurückgestellt; im Panorama gibt es weder aktive Bauflächen noch
Ausbauaktionen. Bauaufträge sind lokale Demo-Vormerkungen mit eigenem
Ausbaubudget. Der Eintrittspreis bleibt mit Desktop und Finanzansicht
gemeinsam. Die Quellen-/Modelltests prüfen auch alte Demostände,
Clubwechsel, doppelte Aufträge und atomare Ablehnung ausgeschlossener
Peripherieanfragen. Private Folgebelege liegen unter
`docs/qa/stadium-batch-2026-10-25/`.
Der Katalog umfasst **32 native und 5 noch offene Routen**, zusätzlich zu
bewusst zurückgestellten Teilbereichen wie der Stadionperipherie.
Der Stadionabschluss besteht 29 Regressionstests. Die unabhängige native Zusatzprüfung besteht 27/27 Fälle, zusätzlich zu 26 Gold-Browser-Behaviors und dem Abgleich aller 28 GUI-Stufenreferenzen. Korrigiert wurden der innere Facility-Bildbeschnitt, die Kapazitätsbeschriftung und die Home/End-Zuordnung nach Mausfokus. Die funktionalen Nachweise enthalten getrennte ursprüngliche und korrigierte Runtimekohorten sowie echte Speicher-Neustarts.
Das Informationspaket ergänzt [Statistiken](desktop/statistics/README.md) und
[Nachrichten](desktop/news/README.md). Der HTML-Goldstand bleibt `ddd8cab7`;
222 Browserprüfungen dokumentieren die Referenzbedienung. Die nativen
Ansichten wurden in allen drei Themes bei 720p und 1080p mit echten
RmlUI-Ereignissen erfasst. 1.770 Zustandsprüfungen bestehen für sämtliche
Statistikbereiche, Länder-/Wettbewerbsfilter, Kurven, Profile und
Nachrichtenaktionen einschließlich Abbruch, Scrollen, Fokus, Undo,
Speichern und vollständigem Prozessneustart. Vierzehn gerichtete Prüfungen
ergänzen die tatsächliche Desktop-Widgetauswahl und eine Ultrawide-Pokalansicht.
Korrigiert wurden verschwindende intrinsische Flexbeschriftungen bei Analytics,
Spieler-/Vereinsnamen, WM-Jahreszahlen und Pokalsiegern; außerdem die fehlende
fett-kursive Wortmarkenschrift und die stabile englische Länderkennung
`nation:x-eng`. Der vorhandene Control-Test lädt nun auch beide neuen
Produktionsstylesheets und prüft ihre Beschriftungen in drei Themes bei
vier Pixeldichten. Die lokale Meilenstein-Suite besteht **31/31 Tests**.
Die Abschlusskontrolle umfasst alle 17 tatsächlichen Weltpokalbilder,
deren bytegleichen Bezug zu den freigegebenen Referenzen sowie gezielte
Nachprüfungen der Siegerbeschriftungen, des Tablet-Rahmens, des Undo-Symbols
und des Silver-Buttons. Alle 125 gerichteten Abschlussprüfungen bestehen.
Die unabhängigen Runtimekohorten behalten jeweils ihre tatsächlichen
Binary-/Stylesheet-Hashes. Der aktuelle Katalog umfasst **34 native und drei
noch nicht separat zugeordnete Routen**, zusätzlich zu offenen Teilbereichen
wie Einstellungen, Desktopdetails und zurückgestellter Stadionperipherie.
Die privaten Screenshots, ladbaren UI-Demostände und Eingabeskripte liegen
unter `bmh_4k_ui/docs/qa/information-batch-2026-10-25/`.
Die 31 lokalen Regressionstests und die Linux-/OpenGL-Bildkontrolle sind keine
Behauptung einer Windows-/macOS-Laufzeitabnahme. Die gemeinsame CI baut die
opt-in Oberfläche und ihre synthetischen Tests zusätzlich auf diesen Plattformen.
Das Einstellungspaket ergänzt vier Kategorien mit gemeinsamem Entwurf,
145 sichtbaren Optionen, Abschnittssuche und Automatikmaster. Die lokale
Meilenstein-Suite besteht **32/32 Tests**, einschließlich Migration,
atomarer Fehler und getrennter globaler Voreinstellungen. Die Schriftprüfung
lädt das neue Produktionsstylesheet und prüft zusätzlich die Einstellungs-
Dropdowns und ihre Popupschrift bei vier Pixeldichten in drei Themes.
Private Vorher-/Nachher-Aufnahmen, HTML-Katalog, UI-Demostände und tatsächliche
Eingabeskripte liegen unter `bmh_4k_ui/docs/qa/settings-batch-2026-10-25/`.
Die Runtimekohorten behalten ihre tatsächlichen Binär-/Stylesheet-Hashes;
Bildkontrollen laufen unter Linux/OpenGL. Das Paket schließt keine Engine-,
Audio- oder Windows-/macOS-Laufzeitabnahme ein.
Die Pakete Dateiverwaltung und Desktop/Widgets werden gemeinsam als Meilenstein
geprüft. Die lokale Suite besteht **34/34 Tests**. Zusätzliche öffentliche
Tests decken atomare Dateibibliotheken, Überschreibschutz, Pfadaliasse,
In-Memory-Laden, Bestätigung gespeicherter Revisionen, Widgetmetadaten,
Raster-/Fixierungsschutz und tatsächlich berechneten Galerie-Scrollbereich ab.
Die Schriftprüfung lädt beide Produktionsstylesheets und kontrolliert zusätzlich
Monatsname, Warnbeschriftungen und Begegnungsnamen in drei Themes/vier Dichten.
Die privaten Belege liegen unter
`bmh_4k_ui/docs/qa/desktop-files-batch-2026-10-25/`. Karriere- und Ansichtsdateien
bleiben UI-Demodaten. Die vertieften Dateitests enthalten tatsächliche
GUI-Eingaben und externe Änderungen eigener QA-Dateien zwischen Auswahl und
Bestätigung; es werden keine Produktzustände in den laufenden Prozess injiziert.
Separate Runtimekohorten bewahren ihre ursprünglichen Fingerprints.
Das Einstiegspaket ergänzt Hauptmenü und Mod-Bibliothek mit zwei Tabs,
Metadaten, drei Importentscheidungen, Namensprüfung, expliziter Aktivierung und
Neustartpersistenz. Der private Goldlauf besteht 82/82 Prüfungen; die begrenzte
native Modern-Bedienung samt zwei Neustarts besteht 78/78. Beim Vergleich der
Importdaten zählen entpackte Dateihashes; ein neu gepackter ZIP-Container darf
sich byteweise unterscheiden. Der ältere gegenteilige Harnessbefund bleibt
als korrigierte Prüferwartung erhalten.
Die sechs nativen Bildfälle dokumentieren drei Themes bei 720p und 1080p.
Frontfenster bleiben wie Gold bewusst dunkel, während Desktop-/Untermenüthemes
ihre eigenen Paletten behalten. Quellen und alte UI-Demostände werden nicht
verändert. Proprietäre Referenzen und Importbelege liegen nur privat unter
`bmh_4k_ui/docs/qa/front-mods-batch-2026-10-26/`.
Die lokale Suite besteht nach dem Einstiegspaket **35/35 Tests**. Der neue
Bibliothekstest verwendet vollständig synthetische Modern- und versiegelte
Classic-DE/EN-Pakete und prüft Aktivierung, Namenskonflikte, Auswahl-CAS,
Quelländerungen, Rollback und unveränderte Nutzerdaten. Classic-Importe werden
zusätzlich vom vorhandenen 0.2-Launcher erkannt. Die Schriftprobe kontrolliert
auch den Hauptmenütext und Modnamen bei vier Dichten in drei Themes.
Ein schmaler Streifen rechts vom Cover wurde im finalen Link durch korrekte
Coverbreite geschlossen; frühere Kohorten behalten ihre tatsächlichen Bilder.
## Grundeinstellungen und Managerwahl · 26. Oktober 2026
Das [Managerpaket](main-menu/entry/README.md) ergänzt getrennte Entwürfe,
suchbare Vereinswahl, Identitätsbestätigung und Add-/Full-Ansichten. Der
unabhängige Vergleich erfasst drei Themes und zwei Auflösungen mit realen
Maus-/Tastatureingaben. Ausländische Vereine bleiben bewusst gesperrt.
Ein gerichteter zusätzlicher Bedienlauf prüft das Abbrechen nach dem ersten
bereits bestätigten Entwurfsmanager gegen die unveränderte laufende Quelle,
Revision, Dirty-Marke, Arbeitsansicht und UI-Präferenzen. Ein weiterer Lauf
startet über die installierte Mod ohne zuvor geladene DemoSource.
Die neue synthetische Testsuite `modern_entry_ui_tests` prüft den atomaren
Start und die gemeinsame Managervalidierung. Private Quellen, Screenshots
und UI-Checkpoints liegen unter `docs/qa/entry-flow-batch-2026-10-26` im
Mockup-Repository. Die vorhandene Saisonvorbereitung wird nur durchlaufen;
eine neue Engine-Auslosung oder Matchabnahme wird nicht behauptet.
## Saisonvorbereitung und Fortsetzen · 26. Oktober 2026
Das [Saisonvorbereitungspaket](main-menu/opening/README.md) prüft den echten
Weg über drei Teilnehmerseiten, automatische Ziehung und Übersicht bis zum
Desktop. Die separate sechsfach erfasste Goldkohorte belegt das angewandte
Theme über tatsächliche Einstellungen, DOM und Preference. Ein URL-Parameter
allein wird nicht als Themebeleg verwendet. Die frühere Entry-Goldkohorte
hat dafür einen transparenten Nachtrag und getrennte korrigierte Themebilder.
Die native Prüfung umfasst gespeicherte IDs/Reihenfolge, Timer/Pause und
Sperre von Escape/Rechtsklick. Zusätzliche gerichtete Läufe prüfen normale
Neustartfortsetzung, den Vorrang expliziter Checkpoints sowie einen tatsächlichen
Autosicherungsfehler mit unverändertem Quellstand und explizitem Retry.
Der vorher reproduzierte Texturverlust der Standardansichts-Vorschau wird
vor/nach abgebrochener Managerwahl mit Quelle, Dirty-Marke, Layout und
pixelidentischer wiedergeöffneter Vorschau kontrolliert. Diese Protokolle
bleiben im privaten `docs/qa/opening-batch-2026-10-26`.
Am 26. Oktober ergänzt der kalibrierte Sprite-Studio-Export `82914ae8` das
[Stadionumfeld](desktop/stadium/README.md). Die bisherige Zurückstellung im
obigen historischen Stadionabschluss ist damit aufgehoben. Vierzehn Standorte
verwenden unsichtbare Trefferflächen und Untertitel, genau zwei Navigationsknöpfe,
strikt einzelne nächste Ausbaustufen sowie aktuelle Baustellen und fertige
Zukunftsvorschau. Dies bleibt ein Demoanbieter ohne Bauzeitfortschritt oder
Engineanbindung. Die neue Prüfung und ihre Grenzen stehen im Stadiondokument.