Files
Dreierpack-Manager/docs/new_ui/integration/QA.md
T

71 lines
4.0 KiB
Markdown

<!-- SPDX-License-Identifier: GPL-3.0-only -->
# Begrenzte QA dieses Datenvertrags
Ausgeführt in der Nacht 26./27. Oktober 2026 auf den synthetischen Dateien dieses Pakets:
**85 Prüfungen bestanden, keine fehlgeschlagen.** Einzelbelege stehen in
[qa-results.json](qa-results.json). Python 3.13 mit `jsonschema` validiert den
Draft-2020-12-Schemakopf, alle 53 Fixtures und ausgewählte zusätzliche
Semantikbedingungen. Alle 32 vorgeschlagenen Readmodel-Arten besitzen mindestens
ein Beispiel; die 47 Menüeinträge referenzieren bekannte Readmodel-Arten.
Reproduzierbare Befehle vom Repositoryroot:
```sh
python3 docs/new_ui/integration/tools/generate_schema.py
python3 docs/new_ui/integration/tools/generate_examples.py
python3 docs/new_ui/integration/tools/validate_contract.py
```
Die zwei Generatoren wurden erneut ausgeführt; ihre 56 Schema-/Index-/Fixture-
JSON-Dateien waren bytegleich. Die QA-Resultate selbst enthalten keine Uhrzeit
oder privaten Laufzeitpfad und sind ebenfalls nachvollziehbar.
## Geprüfte Stichproben
- Form und Pflichtfelder aller Beispieldaten, ISO-Datum, Plaintext statt
Markup-Feldern, numerisch genaue Money-/Revisionstrings und Skalierungsgrenzen.
- Vier aktive Personen mit unterschiedlicher Teamkontrolle, Owner-/Welt-/
Revisionsabweichungen, Archividentität, KI-Übergabe und Ende beim letzten
Menschen. Geprüft wird die Konsistenz der **DTO-Beispiele**, kein Engine-Ende.
- Bekanntes ET-Ergebnis, separates direktes National-Shootout, sechs Indoor-
Feldspieler/elf Kaderlimit, Team ohne Kader und bewusst unbekannte ET-Phase
eines alten Shootoutrecords. Tor- und Kickzählung bleiben getrennt.
- Monotone Ereignisfolge, eindeutige Events, Akteure in bekannten Aufstellungen,
Starter/Bank/Kadergröße und richtige Unterscheidung von unbekannt und echter 0.
- Konsistente Quotenzerlegung, Owner/Revision, feste Pagingrevision, stabile
Korrekturidentität, kein selbstreferenzieller Korrekturverlauf.
- Protokoll-/Datenfehler werden durch gezielt beschädigte Kopien abgeprüft:
ungültiges Datum, Bruchteilscent, int64-/uint64-Überlauf, falsche Präzision,
falscher ET-Endstand, Shootouttore im Spielstand, doppelte/umgeordnete Events,
11er-Indoorfeld, falsche Kadergröße, fremder Akteur, doppelte Kontrolle,
widersprüchliches GameEnd, falsche Korrektur-ID/Zyklus, Quoten- und Cursorfehler
sowie inkonsistente Start-Manageranzahl und eine auf ein fremdes Fixture
gebundene TOTO-Vorhersage.
## Was diese QA ausdrücklich nicht beweist
Es wurde keine Engine ausgeführt, kein C++-Adapter gebaut, kein OBS verändert,
kein Originaldatensatz gelesen und keine native oder HTML-Bildabnahme gemacht.
Die 33 Commandentwürfe sind als Schema aufgeführt; nur eine begrenzte Auswahl
von Payload-/Kontextbeispielen wurde geprüft, nicht sämtliche fachlichen
Transitionsregeln. Die Bool-/Mengenkonsistenz des Handover-Beispiels ist keine
Implementierung von Aufgeben. Der Einsatzmengencheck ist eine Referenzforderung,
kein Beweis einer schon korrigierten Indoor-Engineprojektion.
Die geplante Presse-Registry, Templatevarianten und persistente Dedupe nach
Löschen bleiben Prüfaufgabe des separaten News-/Sessionpakets. Hier werden ihre
Event-/Artikel-DTOs und DE/EN-Snapshotformen validiert; eine triviale gleiche-ID-
Mengenprobe wird bewusst nicht als Persistenznachweis ausgegeben.
Die offenen Entscheidungen in [OPEN_DECISIONS.md](OPEN_DECISIONS.md) bleiben
auch bei grüner Schema-QA offen. Vor echter Anbindung sind Read-RNG-/Revision-
Unveränderlichkeit, atomare Fehler, Live-Resync, Save-/Neustartpersistenz und
Kontextmatrizen an den tatsächlich implementierten Sessiondiensten zu testen.
Zusätzlich wurde der tatsächlich gelesene private HTML-Helper `submenus.money(n)`
mit rein synthetischen Argumenten im vorhandenen JavaScript-Laufzeitsystem
aufgerufen: `money(15)` ergibt `15 €`, `money(1500)` ergibt `1.500 €`.
Das bestätigt die bestehende Whole-Euro-Formattergrenze; es ist kein Browser-
oder Engineintegrationstest und wird nicht zu den 85 öffentlichen DTO-Prüfungen
hinzugezählt. Quellhash und Resultat bleiben im privaten Übergabebeleg.