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

4.9 KiB
Raw Blame History

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.