rinkplanner/docs/findings-2026-10-31-isu-levels.md
torsten 1f5834752e feat: Level automatisch aus Features
- Katalog-Pirouetten und -Sequenzen setzen element_level aus dem
  Feature-Ergebnis
- Spruenge fest Base, ChSq fest Level 1
- Level-Regler bei Katalog-Elementen read-only
- Unbekannte Freitext-Codes behalten den manuellen Level
- Undo umfasst Feature- und Levelaenderung gemeinsam
- Whiteboard-Tests auf 253 Assertions erweitert (912 gesamt)
- Doku und Findings aktualisiert
2026-10-31 10:42:55 +01:00

5.4 KiB
Raw Blame History

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