# 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 | 897 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 → 238 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.