# ISU-Regelwerk – Elementkatalog und Level-Features Stand: 2026-10-31 Saison: **2025/26** 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 Der Katalog liefert die Base Values (BV) zu Elementkürzeln und Leveln. Er ist bewusst reine Daten und vom Whiteboard entkoppelt: Eine neue Saison ersetzt eine JSON-Datei, nicht den Modell- oder Controller-Code. Aktuell abgedeckt: - **24 Sprünge** von `1T` bis `4A` - **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 sowie Eistanz-Elemente. ## Dateien | Datei | Inhalt | | :--- | :--- | | `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/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 ```json { "schema_version": 1, "season": "2025/26", "discipline": "Single & Pair Skating", "valid_from": "2025-07-01", "source": "ISU Communication No. 2707, ...", "elements": [ { "code": "3Lz", "name": "Triple Lutz", "type": "jump", "base_value": 5.90 }, { "code": "CCoSp", "name": "Change foot combination spin", "type": "spin", "base_values": { "B": 1.70, "1": 2.00, "2": 2.50, "3": 3.00, "4": 3.50 } } ] } ``` - `code` ist die **Familie** ohne Level-Suffix (`3Lz`, `CCoSp`, `StSq`). - `type` ist `jump`, `spin` oder `sequence` und wird auf `PathSegment.ElementType` abgebildet. - Sprünge haben genau einen `base_value` (Level 0). Pirouetten und Sequenzen nutzen `base_values` mit `"B"` für Base und `"1"`–`"4"` für die Level. - Werte sind Dezimalzahlen mit Punkt; die UI zeigt sie mit Komma. ## Lookup-Regeln `ElementCatalog` bietet: ```gdscript var catalog := ElementCatalog.load_default() catalog.find("CCoSp") # ElementDefinition oder null catalog.get_base_value("CCoSp", 4) # 3.50 catalog.get_base_value("CCoSp4", -1) # 3.50 (Level aus Suffix) catalog.get_base_value("3Lz", 2) # 5.90 (Sprunglevel wird ignoriert) catalog.get_base_value("3X") # -1.0 catalog.get_segment_base_value(segment) # BV eines getaggten Segments catalog.suggest(PathSegment.ElementType.SPIN, "ccosp", 8) ``` - Lookup ist getrimmt und case-insensitiv. - Kanonische Codes mit Suffix (`CCoSp4`, `StSqB`) werden akzeptiert; ein Suffix im Kürzel hat Vorrang vor der Level-Auswahl. - Der Controller trennt beim Übernehmen ein Level-Suffix vom Kürzel ab und setzt das Level-Feld. Gespeichert wird immer die Familie, z. B. `CCoSp` + Level 4 statt `CCoSp4` + Level 3. - Unbekannte Kürzel, falsche Typen und nicht vorhandene Level liefern `-1.0` statt eines stillen Defaults. - Existiert ein Element nur auf einem Level (`ChSq1`), löst ein bloßes `ChSq` auf dieses eine Level auf. - 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. Für Katalog-Elemente setzt der Controller den Level automatisch aus dem Feature-Ergebnis. Sprünge sind fest Base, `ChSq` fest Level 1. Unbekannte Freitext-Codes behalten einen manuellen Level als Fallback. 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 bietet für das Kürzel eine Auswahlbox mit den Familien des gewählten Elementtyps, z. B. `CCoSp — Change foot combination spin`. Für Kombinationen und Varianten, die der Katalog nicht strukturiert abbildet (`3Lz+2T`, `3Lzq`, `CCoSpV`), gibt es den Eintrag **„Freitext / Kombination …“**; er blendet das bisherige Textfeld ein. Beim Übernehmen werden Level-Suffixe weiterhin ins Level-Feld normalisiert. Der Inspector zeigt unter der Level-Auswahl `Base Value: 3,50`. Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2025/26“. Der Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Features; der Tooltip nennt Saison und Quelle. Darunter liegt der Button **Features (n)**. Er wird aktiv, sobald Typ und Kürzel im Katalog stehen. Er öffnet eine Checkbox-Liste mit den Features des Elementtyps; die Auswahl bleibt bis zum Übernehmen pending und ist dann Teil desselben Undo-Schritts. Der Level-Regler ist bei Katalog-Elementen read-only und folgt der Feature-Auswahl: 0 Features → Base, 1 → Level 1 … 4 → Level 4. Der Hinweis zeigt z. B. `Features: 2 · Level 2`. ## 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. Der Kopf nennt den Umfang (`Geprüft: 4 Elemente in 1 Abschnitt (Saison 2025/26)`), darunter listet die Prüfliste jede Kategorie mit `bestanden/geprüft` und Befundzahl: - Kürzel im Katalog - Elementtyp passt - Level gültig - ChSq-Level - Feature-Auswahl gültig - Pflichtfeatures - Level aus Features - Einmal pro Programm Nicht anwendbare Kategorien nennen den Grund, z. B. „nicht anwendbar (kein ChSq)“ oder „nicht anwendbar (keine Features gesetzt)“. Erst danach folgen die konkreten Befunde. Die Prüfung blockiert Speichern und Export nicht. ### Punktwert Der Prüfdialog zeigt zusätzlich eine **Basiswert-Schätzung**: - Summe der Base Values aller Elemente mit gültigem Katalogwert - Anzahl gewerteter und nicht gewerteter Elemente - Wertungsliste pro Element (`CCoSp L4 — 3,50`, `ChStSq — —`) Die Schätzung enthält **keine** GOE, keinen 1,1-Faktor für die zweite Programmhälfte, keine Programmkomponenten und keine Abzüge. Freitext- und Kombinationselemente ohne Katalogwert werden als nicht gewertet markiert. Der angezeigte Wert ist damit ein technischer Basiswert, keine Gesamtpunktzahl. 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 obigen Schema anlegen, z. B. `isu_sov_2026_27.json`. 2. `season`, `valid_from` und `source` aktualisieren. 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. 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-Dateien werden über `include_filter="*.json"` in allen Export-Presets mit ausgeliefert. ## Nächste Ausbaustufen - 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 - Adult-spezifische Programmregeln - Vorschlagsliste im Inspector direkt aus `suggest()`