rinkplanner/docs/findings-2026-10-31-validierung.md
torsten 9cb880fca0 feat: Kuerzelauswahl im Element-Inspector
- Katalog-Dropdown mit Anzeigenamen je Elementtyp
- Freitext-Fallback fuer Kombinationen und Varianten
- Suffix-Codes und feste Level werden beim Oeffnen uebernommen
- Typwechsel erhaelt nicht passende Codes als Freitext
- Whiteboard-Tests auf 241 Assertions erweitert (900 gesamt)
- Doku, Findings und Roadmap aktualisiert
2026-10-31 10:30:47 +01:00

106 lines
4.9 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.

# Findings – Session: Elementvalidierung (2026-10-31)
Ergänzung zu `docs/findings-2026-10-31-isu-levels.md`.
Nach Katalog und Level-Features folgt die dritte ISU-Ausbaustufe: eine
strukturierte Prüfung der Elementdaten gegen das geladene Regelwerk.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Prüfmodell | `RoutineValidator`, `ValidationReport`, `ValidationCheck`, `ValidationIssue` |
| Prüfumfang | Kürzel, Typ, Level, Feature-Auswahl, Level-Abgleich, Einmal-Features |
| Befunde | Schweregrad, deutsche Meldung, Abschnitts- und Segmentbezug |
| Oberfläche | Button „Prüfen“ in der Statusleiste, Dialog mit Prüfliste und Befunden |
| Prüfstatistik | Je Kategorie geprüft/bestanden plus Element- und Abschnittszahl |
| Verhalten | Prüfung ist nicht blockierend; Speichern und Export bleiben möglich |
| Tests | 900 Assertions gesamt, `./tools/test.sh` grün (neu: 54 Validierung) |
## Entscheidungen
- **Getrennt von `Routine.validate()`.** Das Modell prüft weiterhin Struktur,
Pfade und Rink-Grenzen. `RoutineValidator` prüft fachliche Elementdaten
gegen Katalog und Level-Regeln. So bleibt das Modell unabhängig von
saisonalen Daten.
- **Befunde statt Ja/Nein.** Jeder Befund trägt `severity`, `message`,
`section_id` und `segment_id`. Die UI kann Fehler und Warnungen
unterscheiden und auf die Quelle zeigen.
- **Deutsche, Nutzer-nahe Meldungen.** Die Meldungen nennen Kürzel, Level
und ggf. das erste Segment, z. B. „Kürzel „ChStSq“ ist nicht im Katalog
2025/26.“
- **Nicht blockierend.** Die Prüfung ist ein Hinweis, keine Speichersperre.
Unvollständige Kür während der Arbeit bleiben speicherbar.
- **Einmal-Features als Warnung.** `once_per_program` aus den Level-Daten
wird programmweit ausgewertet: Das erste Vorkommen merkt sich das Segment,
weitere Vorkommen erzeugen eine Warnung mit Verweis auf das erste Segment.
- **`ChSq` und Sprünge als Sonderfälle.** `ChSq` muss das feste Level 1
tragen; Sprünge mit Level ungleich 0 und mit Features werden gewarnt.
## Geprüfte Fälle
- Kürzel nicht im Katalog
- Kürzel gehört zu einem anderen Elementtyp
- Level ist für die Elementfamilie nicht verfügbar
- `ChSq` mit falschem Level
- Sprung mit Level ungleich 0
- Sprung mit Level-Features
- Element ohne Kürzel (Warnung)
- unbekanntes Feature
- Feature zu oft gewählt (z. B. drei schwierige Variationen)
- Pflichtfeature einer Schrittsequenz fehlt
- Feature-Ergebnis weicht vom gewählten Level ab
- Feature mit `once_per_program` in mehreren Elementen
## Oberfläche
- Der Button **Prüfen** sitzt links neben „Segment löschen“ in der
Statusleiste.
- Der Dialog `Kür prüfen` nennt im Kopf den Umfang: `Geprüft: 4 Elemente in
1 Abschnitt (Saison 2025/26)`.
- Darunter steht eine Prüfliste mit einer Zeile pro Kategorie:
Kürzel im Katalog, Elementtyp passt, Level gültig, ChSq-Level,
Feature-Auswahl gültig, Pflichtfeatures, Level aus Features und
Einmal pro Programm. Jede Zeile zeigt `bestanden/geprüft`, Befundzahlen
und ein ✓/✗/–.
- Nicht anwendbare Kategorien nennen den Grund, z. B. „nicht anwendbar
(kein ChSq)“ oder „nicht anwendbar (keine Features gesetzt)“. Das bedeutet
nicht, dass die Prüfung fehlt: Sie hat für diese Kür einfach keine
passenden Daten.
- Danach folgen die Befunde mit farbigem Punkt, Schweregrad, Abschnitt,
Element und Meldung.
- Ein leeres Ergebnis wird positiv bestätigt: „Keine Befunde.“
- Die Dialoggröße wird auf die Viewport-Größe begrenzt, damit sie auch in
kleinen Fenstern und im Headless-Test positionierbar bleibt.
## Grenzen
1. **Programmtyp und Elementanzahl:** Es gibt noch kein Modell für
Kurzprogramm/Kür, Adult-Level oder erlaubte Elementanzahl.
2. **Wiederholungen und Kombinationen:** Sprungkombinationen und -folgen sind
Freitext; Wiederholungsregeln werden nicht geprüft.
3. **Max. zwei Features pro Fuß:** Das Modell kennt keine Füße, die
Begrenzung bleibt offen.
4. **Feature-Positionsregeln:** „Feature nicht zusammen mit einer bereits
verwendeten Variationsposition“ ist nicht modelliert.
5. **Adult-Abweichungen:** Geprüft wird das reguläre ISU-Regelwerk 2025/26.
## Tests
Neu: `tests/run_validation_tests.gd` (54 Assertions)
- saubere Kür ohne Befunde
- unbekanntes Kürzel, Typ-Mismatch, nicht verfügbares Level
- Sprung-Level/-Features, festes `ChSq`-Level
- fehlendes Kürzel
- unbekanntes/überzähliges Feature, fehlendes Pflichtfeature
- Level-Abweichung
- programmweites Einmal-Feature mit Verweis auf das erste Segment
- fehlendes Regelwerk
- Prüfstatistik je Kategorie (geprüft/bestanden/Befunde, übersprungene Checks)
Erweitert: `tests/run_whiteboard_tests.gd` (228 → 241 Assertions) prüft
`validate_routine()`, den Prüfdialog mit Prüfliste, Umfang, Befunden und
Begründungen für nicht anwendbare Prüfungen sowie eine saubere Kür.
Visuell geprüft über `tests/manual/capture_elements.gd ... validate` bei
1400 × 876.