- 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
4.9 KiB
4.9 KiB
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.RoutineValidatorprü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_idundsegment_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_programaus den Level-Daten wird programmweit ausgewertet: Das erste Vorkommen merkt sich das Segment, weitere Vorkommen erzeugen eine Warnung mit Verweis auf das erste Segment. ChSqund Sprünge als Sonderfälle.ChSqmuss 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
ChSqmit 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_programin mehreren Elementen
Oberfläche
- Der Button Prüfen sitzt links neben „Segment löschen“ in der Statusleiste.
- Der Dialog
Kür prüfennennt 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
- Programmtyp und Elementanzahl: Es gibt noch kein Modell für Kurzprogramm/Kür, Adult-Level oder erlaubte Elementanzahl.
- Wiederholungen und Kombinationen: Sprungkombinationen und -folgen sind Freitext; Wiederholungsregeln werden nicht geprüft.
- Max. zwei Features pro Fuß: Das Modell kennt keine Füße, die Begrenzung bleibt offen.
- Feature-Positionsregeln: „Feature nicht zusammen mit einer bereits verwendeten Variationsposition“ ist nicht modelliert.
- 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.