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

80 lines
4.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. Aktueller Gesamtkatalog: 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.
Der Katalog umfasst jetzt 19 native und 18 offene Routen.