Port native Training and Tactics from the HTML reference (by Codex)
This commit is contained in:
1 parent
c737c17870
commit
79bf38aa78
18 files changed
+952
-12
No files matched your search
@@ -0,0 +1,51 @@
|
||||
# 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)
|
||||
Reference in new issue
Block a user