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

52 lines
2.6 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, 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:
- [Nativer Stand](NATIVE_STATUS.md)
- [Typografie-Befunde](typography-qa.md)
- [Training](desktop/training/README.md) und [Taktik](desktop/tactics/README.md)