95 lines
4.1 KiB
Markdown
95 lines
4.1 KiB
Markdown
|
|
# 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.
|