# 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.