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
This commit is contained in:
torsten 2026-10-31 09:56:05 +01:00
parent 0613ffca3e
commit 223a072f5d
17 changed files with 1017 additions and 15 deletions

View file

@ -3,8 +3,8 @@
Stand: 2026-10-31
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-31-isu-levels.md`
(Session davor: `docs/findings-2026-10-31-isu-katalog.md`)
Letzte Session: `docs/findings-2026-10-31-validierung.md`
(Session davor: `docs/findings-2026-10-31-isu-levels.md`)
## 1. Leitentscheidung
@ -64,6 +64,8 @@ Implementiert in `rinkplanner/src/core/rules/`:
| `ElementCatalog` | saisonaler JSON-Katalog, Lookup nach Kürzel/Level, Vorschläge, Prüfung |
| `ElementFeature` | Level-Feature mit Zählgrenze und Programm-Flag |
| `ElementLevelRules` | saisonale Feature-Sätze, Pflichtfeatures und Level-Berechnung |
| `RoutineValidator` | prüft Elementdaten gegen Katalog und Level-Regeln |
| `ValidationIssue` | Befund mit Schweregrad, Meldung und Abschnitts-/Segmentbezug |
### Entscheidungen
@ -128,6 +130,16 @@ und zeigt es an, ersetzt aber das manuell gewählte `element_level` nicht
stillschweigend. So bleiben Altdaten und bewusste Overrides sichtbar, und die
spätere Validierung kann Abweichungen melden.
**D10 – Validierung liefert Befunde statt eines Ja/Nein.**
`RoutineValidator` prüft Elementdaten gegen Katalog und Level-Regeln und
liefert `ValidationIssue`-Objekte mit Schweregrad (Fehler/Warnung), Meldung
und Abschnitts-/Segmentbezug. Die Prüfung ist bewusst getrennt von
`Routine.validate()`: Das Modell prüft Struktur und Pfade, der Validator
prüft fachliche Elementdaten. Die Oberfläche zeigt die Befunde in einem
Dialog; sie blockiert Speichern oder Export nicht. Noch nicht abgedeckt sind
Programmtypen, Elementanzahl, Wiederholungs-/Kombinationsregeln und die
Begrenzung auf zwei Features pro Fuß.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -178,6 +190,10 @@ spätere Validierung kann Abweichungen melden.
gewählten Level; das gewählte Level bleibt autoritativ.
Die Timing-Details (Dauer/Tempo/Profil) werden beim Setzen und für
Punktmarker ausgeblendet, damit die Leiste auch im Landscape kompakt bleibt.
- **Prüfung:** Der Button „Prüfen“ in der Statusleiste validiert alle
Elementsegmente gegen Katalog und Level-Regeln. Der Dialog listet Fehler
und Warnungen mit Abschnitt und Element; ein leeres Ergebnis wird positiv
bestätigt. Speichern und Export bleiben möglich.
- **Section-Verwaltung:** Ein Panel rechts zeigt die chronologische
Abschnittsliste. Neue Sections werden angelegt, umbenannt, gelöscht und
hoch-/runtergeschoben; `sequence_order` wird nach jeder Änderung
@ -332,15 +348,18 @@ Aktueller Stand:
schwierige Variationen, Level-4-Voraussetzungen, Pflichtfeatures bei
Schrittsequenzen, feste Level (`ChSq`), Feature-Validierung und die
Speicherung am Segment.
- **Validierung:** 28 Assertions für unbekannte Kürzel, Typ-Mismatches,
nicht verfügbare Level, Sprung-/ChSq-Sonderfälle, Feature-Fehler,
Pflichtfeatures, Level-Abweichungen und programmweite Einmal-Features.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 228 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 233 Assertions für Controller-Verdrahtung, Segmenterzeugung,
Linien-/Bogenpfade, Klemmen an der Bande, Auswahl, Griff- und
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Element-Marker (Setzen,
Typwechsel, Inspector inkl. Standzeit, Base-Value- und Feature-Hinweis,
Feature-Menü, Verschieben, Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State,
Speichern/Laden, Schema-Prüfung, Dirty-State, Prüfdialog,
Navigationsmodus und den Maus-Drag-Pfad.
- **History:** 53 Assertions für Undo/Redo von Segmenten, Kanten, Labels, Sections,
Zeichengesten und Griff-Bearbeitung, Toolbar-Buttons, Erhalt der Ansicht

View file

@ -0,0 +1,94 @@
# 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.

View file

@ -157,6 +157,23 @@ abgeleitete Level und – bei Abweichung – das manuell gewählte Level, z. B.
`Features: 2 · Level 2 · gewählt: Level 4`. Das gewählte Level bleibt
autoritativ; die Feature-Prüfung ersetzt es nicht stillschweigend.
## Prüfung
`RoutineValidator` prüft alle Elementsegmente gegen Katalog und Level-Regeln
und liefert `ValidationIssue`-Befunde mit Schweregrad, Meldung und Bezug zu
Abschnitt und Segment. Geprüft werden:
- unbekannte Kürzel und Kürzel mit falschem Elementtyp
- nicht verfügbare Level, Sprung-Level ungleich 0 und das feste Level von `ChSq`
- unbekannte Features, zu häufige Features und fehlende Pflichtfeatures
- Abweichungen zwischen Feature-Ergebnis und gewähltem Level
- Features, die laut Daten nur einmal pro Programm zählen
Der Button **Prüfen** in der Statusleiste öffnet die Befunde in einem Dialog.
Die Prüfung blockiert Speichern und Export nicht. Noch nicht geprüft werden
Programmtyp, erlaubte Elementanzahl, Wiederholungs- und Kombinationsregeln
sowie die Begrenzung auf zwei Features pro Fuß.
## Neue Saison einpflegen
1. Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
@ -177,9 +194,10 @@ mit ausgeliefert.
## Nächste Ausbaustufen
- Programmweite Feature-Grenzen (`once_per_program`, max. 2 Features pro Fuß)
- Abgleich zwischen gewähltem Level und Feature-Ergebnis in der Validierung
- Max. zwei Features pro Fuß und Feature-Positionsregeln
- Programmtypen, erlaubte Elementanzahl sowie Wiederholungs- und
Kombinationsregeln
- GOE-Tabellen und `V`-/Unterrotations-Varianten
- Sprungkombinationen und -folgen als zusammengesetzte Elemente
- Programmvalidierung (erlaubte Elementanzahl, Wiederholungen, Adult-Regeln)
- Adult-spezifische Programmregeln
- Vorschlagsliste im Inspector direkt aus `suggest()`

View file

@ -1,6 +1,6 @@
# Rinkplanner – Roadmap
Stand: 2026-10-31 (ISU-Katalog und Level-Features; Sync-Komfort und UI-Refactoring zurückgestellt)
Stand: 2026-10-31 (ISU-Katalog, Level-Features und Elementvalidierung; Sync-Komfort und UI-Refactoring zurückgestellt)
Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen
nur bewusst und nach Rücksprache. Erkenntnisse der letzten Session:
`docs/findings-2026-10-30-element-marker.md`.
@ -119,8 +119,11 @@ Voraussetzung für Phase 1.
- [x] Features und Kriterien für die Level-Vergabe
– Pirouetten (14 Features) und Schrittsequenzen (4 Features),
Level-Berechnung und Auswahl im Inspector; Details in `docs/isu-rules.md`
- [ ] Validierung von Elementen und Kombinationen
- [ ] Programmweite Feature-Grenzen (`once_per_program`, max. 2 pro Fuß)
- [x] Validierung von Elementen (Katalog, Level, Features, Level-Abgleich)
mit Prüfdialog in der Statusleiste
- [x] Programmweite Einmal-Features (`once_per_program`) als Warnung
- [ ] Max. zwei Features pro Fuß und Feature-Positionsregeln
- [ ] Kombinations-, Wiederholungs- und Programmtyp-Regeln
- [ ] Optional: Kürzelvorschläge im Inspector aus `suggest()`
- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten
@ -146,11 +149,11 @@ fachlichen Validierung angefasst.
Übernahme des Feedbacks der Tester
Die Reihenfolge ist bewusst: native Builds, Datenaustausch und Element-Marker
sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – Katalog und
Level-Features stehen, als Nächstes folgt die Validierung. Sync-Komfort und
UI-Refactoring sind zurückgestellt, weil der bestehende Stand für Tests genügt
und die endgültige Sync-Architektur (PHP-Webserver) sowie das UI-Feedback der
Tester ohnehin noch ausstehen.
sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – Katalog, Level-Features
und Elementvalidierung stehen; als Nächstes folgen Programmregeln und
Kombinationen. Sync-Komfort und UI-Refactoring sind zurückgestellt, weil der
bestehende Stand für Tests genügt und die endgültige Sync-Architektur
(PHP-Webserver) sowie das UI-Feedback der Tester ohnehin noch ausstehen.
## Querschnittsaufgaben