feat: ISU-Level-Features und Level-Berechnung

- ElementFeature/ElementLevelRules mit Daten aus ISU Communication 2701
- 14 Pirouetten- und 4 Schrittsequenz-Features inkl. Pflicht- und
  Level-4-Regeln
- PathSegment.element_features mit Duplikaten fuer schwierige Variationen
- Feature-Menue und abgeleiteter Level-Hinweis im Element-Inspector,
  Auswahl undo-faehig
- 47 neue Level-Assertions, Whiteboard-Tests auf 228 erweitert (833 gesamt)
- Doku: isu-rules, Findings, Architektur und Roadmap aktualisiert
This commit is contained in:
torsten 2026-10-31 09:21:03 +01:00
parent 789fbc2826
commit 0613ffca3e
18 changed files with 1490 additions and 25 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-katalog.md`
(Session davor: `docs/findings-2026-10-30-element-marker.md`)
Letzte Session: `docs/findings-2026-10-31-isu-levels.md`
(Session davor: `docs/findings-2026-10-31-isu-katalog.md`)
## 1. Leitentscheidung
@ -62,6 +62,8 @@ Implementiert in `rinkplanner/src/core/rules/`:
| :--- | :--- |
| `ElementDefinition` | Elementfamilie (z. B. `CCoSp`) mit Typ, Name und Base Values je Level |
| `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 |
### Entscheidungen
@ -117,6 +119,15 @@ ins Level-Feld normalisiert. Unbekannte Kürzel oder Level liefern `-1` statt
einen stillen Standardwert. Das JSON wird über `include_filter="*.json"` in die
Exporte aufgenommen.
**D9 – Level-Features sind Daten, das Level bleibt eine Autorengröße.**
`ElementLevelRules` liest eine eigene saisonale JSON-Datei mit Feature-Sätzen
und Schwellen. Ausgewählte Features liegen als Codes am Segment
(`element_features`); Duplikate sind erlaubt, damit z. B. zwei schwierige
Variationen zwei Features zählen. Der Inspector berechnet daraus ein Level
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.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -161,6 +172,10 @@ Exporte aufgenommen.
Inspector übersteuert wird und in die Timeline eingeht. Der Inspector zeigt
außerdem den **Base Value** des eingegebenen Kürzels und Levels aus dem
Saisonkatalog; unbekannte Kürzel werden als „nicht im Katalog“ markiert.
Der Button **Features (n)** öffnet die Checkbox-Liste der Level-Features
(Pirouetten, Schrittsequenzen) und übernimmt die Auswahl undo-fähig. Ein
Hinweis zeigt Feature-Anzahl, abgeleitetes Level und eine Abweichung zum
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.
- **Section-Verwaltung:** Ein Panel rechts zeigt die chronologische
@ -313,13 +328,17 @@ Aktueller Stand:
- **Regelwerk:** 160 Assertions für Katalog-Metadaten, Saison/Quelle,
Sprung-/Pirouetten-/Sequenz-Base-Values, Level-Auflösung, Kürzel-Suffixe,
Case-Insensitivität, Vorschläge, Segment-Integration und fehlerhafte Kataloge.
- **Level-Features:** 47 Assertions für Feature-Metadaten, Schwellen,
schwierige Variationen, Level-4-Voraussetzungen, Pflichtfeatures bei
Schrittsequenzen, feste Level (`ChSq`), Feature-Validierung und die
Speicherung am Segment.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 208 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 228 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 und Base-Value-Hinweis, Verschieben,
Löschen), Section-Verwaltung,
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,
Navigationsmodus und den Maus-Drag-Pfad.

View file

@ -0,0 +1,105 @@
# Findings – Session: ISU-Level-Features (2026-10-31)
Ergänzung zu `docs/findings-2026-10-31-isu-katalog.md`.
Nach dem Base-Value-Katalog folgt die zweite ISU-Ausbaustufe: Level-Features
für Pirouetten und Schrittsequenzen samt Level-Berechnung und Auswahl im
Element-Inspector.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Feature-Daten | `isu_levels_2025_26.json` aus ISU Communication No. 2701 |
| Feature-Modell | `ElementFeature`, `ElementLevelRules` in `src/core/rules/` |
| Umfang | 14 Pirouetten-Features, 4 Schrittsequenz-Features |
| Level-Berechnung | 1 Feature → Level 1 … 4 Features → Level 4; Level-4-Voraussetzungen |
| Speicherung | `PathSegment.element_features` (Codes, Duplikate erlaubt) |
| Bedienung | Button „Features (n)“ mit Checkbox-Menü, Hinweis auf abgeleitetes Level |
| Tests | 833 Assertions gesamt, `./tools/test.sh` grün (neu: 47 Level-Tests) |
## Quelle und Regeln
- ISU Communication No. 2701, *Single & Pair Skating – Levels of Difficulty
and Guidelines for marking Grade of Execution and Program Components,
Season 2025/26* (ersetzt Communication 2623).
- Schwellen: 1 Feature → Level 1, 2 → Level 2, 3 → Level 3, 4 oder mehr →
Level 4; ohne Feature Base.
- **Pirouetten:** 14 Features. Schwierige Variationen zählen höchstens zweimal
pro Pirouette. Für Level 4 ist zusätzlich eines von sechs Features nötig:
schwieriger Positionswechsel, schwieriger Ausgang, klare Kantenänderung,
beide Richtungen, klare Temposteigerung oder schwieriger Flug-Eingang.
- **Schrittsequenzen:** 4 Features. Feature 1 (Vielfalt schwieriger Schritte
und Drehungen) ist Pflicht; ohne sie bleibt die Sequenz Base, auch wenn
andere Features gesetzt sind.
- **Choreografische Sequenz (`ChSq`):** fest Level 1, unabhängig von Features.
- **Sprünge:** nicht levelbar.
## Entscheidungen
- **Features sind Codes am Segment.** `element_features` ist eine
`PackedStringArray`; Duplikate sind erlaubt, damit zwei schwierige
Variationen als zwei Features zählen. Die Reihenfolge bleibt erhalten.
- **Typwechsel leert die Auswahl.** Features sind typabhängig; `set_element`
verwirft sie beim Wechsel des Elementtyps und beim Entfernen des Elements.
- **Das Level bleibt eine Autorengröße.** Die Berechnung erzeugt nur einen
Hinweis (`Features: 2 · Level 2 · gewählt: Level 4`). Der Inspector ändert
das gewählte Level nicht stillschweigend. So bleiben Altdaten und bewusste
Overrides sichtbar; die Validierung kann später Abweichungen melden.
- **Eigene JSON-Datei.** Level-Features stammen aus einer anderen
Communication als die Base Values und ändern sich unabhängig. Beide Dateien
tragen Saison, Quelle und Gültigkeitsdatum.
- **PopupMenu statt Unterdialog.** Der Button öffnet eine Checkbox-Liste am
Button. `hide_on_checkable_item_selection` ist aus, damit mehrere Features
ohne erneutes Öffnen gewählt werden können. Checkable PopupMenu-Einträge
toggeln sich in Godot nicht selbst; der Controller toggelt im
`id_pressed`-Handler.
- **Auswahl wird beim Schließen übernommen.** `popup_hide` sammelt die
markierten Einträge und ruft `set_selected_element_features`; die Änderung
ist undo-fähig und dirty-markierend.
## Bedienung
- Im Element-Inspector steht unter dem Base Value der Button `Features (n)`.
- Bei Sprüngen ist er deaktiviert und der Hinweis erklärt, dass Sprünge keine
Level-Features haben. Bei Sequenzen ohne Kürzel oder unbekanntem Kürzel
bleibt er ebenfalls deaktiviert.
- Das Menü zeigt alle Features des Typs; schwierige Variationen erscheinen
zweimal (`1/2`, `2/2`). Tooltips erklären die Features.
- „Auswahl zurücksetzen“ entfernt alle Haken.
- Der Hinweis darunter nennt Feature-Anzahl, abgeleitetes Level, eine
Abweichung zum gewählten Level und ggf. ignorierte Features.
- Fehlt bei einer Schrittsequenz das Pflichtfeature, steht dort
„Pflichtfeature fehlt: variety_of_turns“.
## Grenzen
1. **Programmweite Grenzen:** `once_per_program` ist in den Daten, wird aber
noch nicht ausgewertet. Features 2–9 und 11–14 zählen laut ISU nur beim
ersten Versuch im Programm.
2. **Maximal zwei Features pro Fuß:** Bei Pirouetten mit Fußwechsel ist die
Ausbeute pro Fuß begrenzt. Das Modell kennt keine Füße und kann das nicht
prüfen.
3. **Feature-Kombinationen:** Die Regel „Feature nicht zusammen mit einer
bereits verwendeten Variationsposition“ ist nicht modelliert.
4. **Adult-Abweichungen:** Die Datei enthält die regulären ISU-Regeln, keine
Adult-spezifischen Erleichterungen.
5. **GOE und Varianten:** GOE-Tabellen, `V`-, `q`-, `e`-, `!`-, `<`- und
`<<`-Varianten fehlen weiterhin.
## Tests
Neu: `tests/run_level_tests.gd` (47 Assertions)
- Metadaten, Saison, Quelle und Feature-Anzahl
- Schwellen 0–4 Features, Duplikate schwieriger Variationen, Ignorieren
überzähliger Variationen
- Level-4-Voraussetzung: vier Features ohne Spezialfeature bleiben Level 3
- Pflichtfeature der Schrittsequenz, `ChSq` fest Level 1, Sprünge ohne Level
- `validate_selection` für unbekannte, überzählige und fehlende Features
- Segment-Speicherung, Trimmen, Kappung, Leeren bei Typwechsel/Entfernen
Erweitert: `tests/run_whiteboard_tests.gd` (208 → 228 Assertions) prüft
Feature-Zuweisung, Hinweis, Menüaufbau, Toggle, Undo/Redo und Leeren.
Visuell geprüft über `tests/manual/capture_elements.gd ... features` bei
1400 × 876 und 1024 × 768.

View file

@ -1,9 +1,15 @@
# ISU-Regelwerk – Elementkatalog
# ISU-Regelwerk – Elementkatalog und Level-Features
Stand: 2026-10-31
Saison: **2025/26**
Quelle: ISU Communication No. 2707, *Single & Pair Skating – Scale of Values
valid as of July 1, 2025* (ersetzt Communication 2656)
Quellen:
- ISU Communication No. 2707, *Single & Pair Skating – Scale of Values
valid as of July 1, 2025* (ersetzt Communication 2656)
- ISU Communication No. 2701, *Single & Pair Skating – Levels of Difficulty
and Guidelines for marking Grade of Execution and Program Components,
Season 2025/26* (ersetzt Communication 2623)
## Zweck
@ -17,20 +23,25 @@ Aktuell abgedeckt:
- **16 Pirouettenfamilien** der Einzel- und Paarlauf-SoV
(einpositionig, mit Fußwechsel, Kombinationen, jeweils auch geflogen)
- **2 Sequenzen**: `StSq` (Base–4) und `ChSq` (nur Level 1)
- **Level-Features** für Pirouetten (14) und Schrittsequenzen (4) inklusive
Level-Berechnung nach Feature-Anzahl
Nicht abgedeckt (bewusst offen): GOE-Tabellen, reduzierte `V`-Varianten,
Unterrotations-/Fehlkanten-Suffixe (`<`, `<<`, `q`, `e`, `!`), Sprungkombinationen
und -folgen, Paarlauf-Hebungen/Twists/Throws, Eistanz-Elemente, Feature-Kriterien
und die daraus abgeleitete Level-Bestimmung.
und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
## Dateien
| Datei | Inhalt |
| :--- | :--- |
| `rinkplanner/src/core/rules/data/isu_sov_2025_26.json` | aktiver Katalog |
| `rinkplanner/src/core/rules/data/isu_sov_2025_26.json` | Katalog mit Base Values |
| `rinkplanner/src/core/rules/data/isu_levels_2025_26.json` | Level-Features und Schwellen |
| `rinkplanner/src/core/rules/element_catalog.gd` | Laden, Lookup, Vorschläge, Prüfung |
| `rinkplanner/src/core/rules/element_definition.gd` | eine Elementfamilie mit BV je Level |
| `rinkplanner/tests/run_rules_tests.gd` | Headless-Tests inkl. Stichproben |
| `rinkplanner/src/core/rules/element_level_rules.gd` | Feature-Lookup und Level-Berechnung |
| `rinkplanner/src/core/rules/element_feature.gd` | ein Level-Feature mit Zählgrenzen |
| `rinkplanner/tests/run_rules_tests.gd` | Katalog-Tests inkl. Stichproben |
| `rinkplanner/tests/run_level_tests.gd` | Feature- und Level-Tests |
## Datenformat
@ -95,6 +106,43 @@ catalog.suggest(PathSegment.ElementType.SPIN, "ccosp", 8)
- Der Base Value wird **nicht** am Segment gespeichert. Das Segment trägt nur
`element_code` und `element_level`; die Anzeige fragt den Katalog.
## Level-Features
Die Level-Regeln stehen in einer eigenen JSON-Datei, weil sie aus einer
anderen ISU-Communication stammen und sich unabhängig von den Base Values
ändern können. Pro Elementtyp gibt es Feature-Definitionen, Pflichtfeatures
und – bei Pirouetten – die Menge der Features, von denen mindestens eines für
Level 4 nötig ist.
| Elementtyp | Features | Besonderheit |
| :--- | :--- | :--- |
| Pirouette | 14 | Max. 2 schwierige Variationen pro Pirouette; Level 4 verlangt eines von 6 bestimmten Features |
| Schrittsequenz | 4 | Feature 1 (Vielfalt) ist Pflicht; ohne sie bleibt die Sequenz Base |
| `ChSq` | – | Fest Level 1 |
| Sprung | – | Nicht levelbar |
Die Schwelle ist für beide Typen gleich: 1 Feature → Level 1, 2 → Level 2,
3 → Level 3, 4 oder mehr → Level 4. Ohne Feature bleibt das Element Base.
`ElementLevelRules.calculate_level()` liefert neben dem Level auch die
gezählten, ignorierten und fehlenden Pflichtfeatures:
```gdscript
var rules := ElementLevelRules.load_default()
var result := rules.calculate_level(
PathSegment.ElementType.SPIN,
"CCoSp",
PackedStringArray(["difficult_variation", "difficult_exit"])
)
# result.level == 2, result.counted_features == 2
```
Das Segment speichert die Auswahl als `element_features`
(`PackedStringArray`). Duplikate sind erlaubt, damit zwei schwierige
Variationen als zwei Features zählen. Die Daten enthalten außerdem
`once_per_program` (Feature zählt nur beim ersten Versuch im Programm) und
`max_per_element`. Die Programmprüfung und die Begrenzung „max. zwei Features
pro Fuß“ sind noch nicht umgesetzt.
## Bedienung
Der Element-Inspector zeigt unter der Level-Auswahl `Base Value: 3,50`.
@ -102,6 +150,13 @@ Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2025/26“. Der
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Level; der Tooltip
nennt Saison und Quelle.
Darunter liegt der Button **Features (n)**. Er öffnet eine Checkbox-Liste mit
den Features des Elementtyps; die Auswahl wird beim Schließen übernommen und
ist undo-fähig. Ein Hinweis zeigt die gezählten Features, das daraus
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.
## Neue Saison einpflegen
1. Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
@ -110,16 +165,20 @@ nennt Saison und Quelle.
3. `ElementCatalog.DEFAULT_PATH` auf die neue Datei zeigen lassen.
4. Stichproben in `tests/run_rules_tests.gd` auf die neuen Werte anpassen
(mindestens ein Sprung, eine Pirouette, eine Sequenz).
5. `./tools/test.sh` ausführen.
6. Die alte Datei kann für Nachvollziehbarkeit im Repo bleiben; aktiv ist
immer genau eine Datei.
5. Neue Level-Communication (Levels of Difficulty) als
`isu_levels_2026_27.json` anlegen, `ElementLevelRules.DEFAULT_PATH`
umstellen und `tests/run_level_tests.gd` anpassen.
6. `./tools/test.sh` ausführen.
7. Die alte Datei kann für Nachvollziehbarkeit im Repo bleiben; aktiv ist
immer genau eine Datei pro Regelart.
Die JSON-Datei wird über `include_filter="*.json"` in allen Export-Presets
Die JSON-Dateien werden über `include_filter="*.json"` in allen Export-Presets
mit ausgeliefert.
## Nächste Ausbaustufen
- Level-/Feature-Prüfung (welche Features ergeben welches Level)
- Programmweite Feature-Grenzen (`once_per_program`, max. 2 Features pro Fuß)
- Abgleich zwischen gewähltem Level und Feature-Ergebnis in der Validierung
- GOE-Tabellen und `V`-/Unterrotations-Varianten
- Sprungkombinationen und -folgen als zusammengesetzte Elemente
- Programmvalidierung (erlaubte Elementanzahl, Wiederholungen, Adult-Regeln)

View file

@ -1,6 +1,6 @@
# Rinkplanner – Roadmap
Stand: 2026-10-31 (ISU-Katalog begonnen; Sync-Komfort und UI-Refactoring zurückgestellt)
Stand: 2026-10-31 (ISU-Katalog und Level-Features; 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`.
@ -116,8 +116,11 @@ Voraussetzung für Phase 1.
- [x] Regelversionen pflegbar halten (saisonale JSON-Datei mit Quelle und
Gültigkeitsdatum)
- [x] Base-Value-Hinweis im Element-Inspector
- [ ] Features und Kriterien für die Level-Vergabe
- [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ß)
- [ ] Optional: Kürzelvorschläge im Inspector aus `suggest()`
- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten
@ -143,11 +146,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 – der Katalog steht, als
Nächstes folgen Features und 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 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.
## Querschnittsaufgaben