rinkplanner/docs/findings-2026-10-31-validierung.md
torsten 223a072f5d feat: Elementvalidierung mit Pruefdialog
- RoutineValidator und ValidationIssue gegen Katalog und Level-Regeln
- Prueft Kuerzel/Typ/Level, Feature-Auswahl, Level-Abgleich sowie
  ChSq- und Sprung-Sonderfaelle
- Programmweite once_per_program-Features als Warnung
- Pruefen-Button und Dialog in der Statusleiste, nicht blockierend
- 28 Validierungs-Assertions, Whiteboard-Tests auf 233 erweitert (866 gesamt)
- Doku: isu-rules, Findings, Architektur und Roadmap aktualisiert
2026-10-31 09:56:05 +01:00

4.1 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 + ValidationIssue in src/core/rules/
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 Fehlern/Warnungen
Verhalten Prüfung ist nicht blockierend; Speichern und Export bleiben möglich
Tests 866 Assertions gesamt, ./tools/test.sh grün (neu: 28 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 zeigt eine Zusammenfassung (n Fehler, m Warnungen) und darunter die Befunde mit farbigem Punkt, Schweregrad, Abschnitt, Element und Meldung.
  • Ein leeres Ergebnis wird positiv bestätigt: „Keine Befunde. Alle Elemente passen zu Katalog und Level-Regeln.“
  • 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 (28 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

Erweitert: tests/run_whiteboard_tests.gd (228 → 233 Assertions) prüft validate_routine(), den Prüfdialog mit Fehlertext und eine saubere Kür.

Visuell geprüft über tests/manual/capture_elements.gd ... validate bei 1400 × 876.