52 lines
2.6 KiB
Markdown
52 lines
2.6 KiB
Markdown
# 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)
|