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

2.6 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, kein unbeaufsichtigter Dauerprozess. Folgende Menü-Meilensteine verwenden denselben Katalog 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.

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: