rinkplanner/docs/findings-2026-10-31-isu-levels.md
torsten c3677bf3e1 docs: Doku-Drift zu Features und GOE bereinigen
- once_per_program ist im RoutineValidator umgesetzt
- letzte Session und Stand auf 2026-11-01 aktualisiert
- GOE und Varianten in der Roadmap vorerst zurueckgestellt
2026-11-01 09:45:35 +01:00

108 lines
5.5 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: 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.
- **Der Level folgt aus den Features.** Die Feature-Auswahl setzt
`element_level` für Katalog-Elemente automatisch; der Level-Regler ist dann
read-only. Sprünge sind fest Base, `ChSq` fest Level 1. Unbekannte
Freitext-Codes behalten einen manuellen Level als Fallback. (Ursprünglich
war der Level rein manuell; die Automatik kam im Folgeschritt.)
- **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 und wird
inzwischen vom `RoutineValidator` ausgewertet (Warnung ab dem zweiten
Element, Stand 2026-11-01). 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. GOE ist seit 2026-11-01 vorerst
zurückgestellt.
## Tests
Neu: `tests/run_level_tests.gd` (47 Assertions; inzwischen 51)
- 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.