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

8.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. Damals: 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. Nach diesem Paket: 19 native und 18 offene Routen.

  • Bank, Bilanz und Verträge: 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, Werbung und TOTO: 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 und Transfermarkt: 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.