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

4.2 KiB
Raw Blame History

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

  • Typografie-Befunde

  • Training und Taktik

  • Berichte: Tabellen/Stärken und zwei Spielübersichten als gemeinsames Paket; eigenständiger HTML-/Renderervergleich einschließlich 20 Vereinen, Sortierung, Footerpickern und Vereins-/Spielerprofilen.

  • Verlegen, Freundschaftsspiele und Hallentabellen: 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: 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.