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

94 lines
4.1 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` + `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.