# 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.