Files
Dreierpack-Manager/docs/new_ui/menu-qa.md
T

145 lines
8.2 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.
# 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.