2026-10-31 09:21:03 +01:00
|
|
|
|
# ISU-Regelwerk – Elementkatalog und Level-Features
|
2026-10-31 09:01:47 +01:00
|
|
|
|
|
|
|
|
|
|
Stand: 2026-10-31
|
|
|
|
|
|
Saison: **2025/26**
|
2026-10-31 09:21:03 +01:00
|
|
|
|
|
|
|
|
|
|
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)
|
2026-10-31 09:01:47 +01:00
|
|
|
|
|
|
|
|
|
|
## 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)
|
2026-10-31 09:21:03 +01:00
|
|
|
|
- **Level-Features** für Pirouetten (14) und Schrittsequenzen (4) inklusive
|
|
|
|
|
|
Level-Berechnung nach Feature-Anzahl
|
2026-10-31 09:01:47 +01:00
|
|
|
|
|
|
|
|
|
|
Nicht abgedeckt (bewusst offen): GOE-Tabellen, reduzierte `V`-Varianten,
|
|
|
|
|
|
Unterrotations-/Fehlkanten-Suffixe (`<`, `<<`, `q`, `e`, `!`), Sprungkombinationen
|
2026-10-31 09:21:03 +01:00
|
|
|
|
und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
|
2026-10-31 09:01:47 +01:00
|
|
|
|
|
|
|
|
|
|
## Dateien
|
|
|
|
|
|
|
|
|
|
|
|
| Datei | Inhalt |
|
|
|
|
|
|
| :--- | :--- |
|
2026-10-31 09:21:03 +01:00
|
|
|
|
| `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 |
|
2026-10-31 09:01:47 +01:00
|
|
|
|
| `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 |
|
2026-10-31 09:21:03 +01:00
|
|
|
|
| `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 |
|
2026-10-31 09:01:47 +01:00
|
|
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
|
|
|
2026-10-31 09:21:03 +01:00
|
|
|
|
## 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
|
2026-10-31 10:42:55 +01:00
|
|
|
|
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.
|
2026-10-31 09:21:03 +01:00
|
|
|
|
|
2026-10-31 09:01:47 +01:00
|
|
|
|
## Bedienung
|
|
|
|
|
|
|
2026-10-31 10:30:47 +01:00
|
|
|
|
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`.
|
2026-10-31 09:01:47 +01:00
|
|
|
|
Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2025/26“. Der
|
2026-10-31 10:42:55 +01:00
|
|
|
|
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Features; der
|
|
|
|
|
|
Tooltip nennt Saison und Quelle.
|
2026-10-31 09:01:47 +01:00
|
|
|
|
|
2026-10-31 10:49:03 +01:00
|
|
|
|
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`.
|
2026-10-31 09:21:03 +01:00
|
|
|
|
|
2026-10-31 09:56:05 +01:00
|
|
|
|
## 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.
|
2026-10-31 10:18:24 +01:00
|
|
|
|
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
|
|
|
|
|
|
|
2026-10-31 10:20:22 +01:00
|
|
|
|
Nicht anwendbare Kategorien nennen den Grund, z. B. „nicht anwendbar (kein
|
|
|
|
|
|
ChSq)“ oder „nicht anwendbar (keine Features gesetzt)“. Erst danach folgen
|
2026-10-31 10:55:27 +01:00
|
|
|
|
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
|
2026-10-31 09:56:05 +01:00
|
|
|
|
Programmtyp, erlaubte Elementanzahl, Wiederholungs- und Kombinationsregeln
|
|
|
|
|
|
sowie die Begrenzung auf zwei Features pro Fuß.
|
|
|
|
|
|
|
2026-10-31 09:01:47 +01:00
|
|
|
|
## 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).
|
2026-10-31 09:21:03 +01:00
|
|
|
|
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
|
2026-10-31 09:01:47 +01:00
|
|
|
|
mit ausgeliefert.
|
|
|
|
|
|
|
|
|
|
|
|
## Nächste Ausbaustufen
|
|
|
|
|
|
|
2026-10-31 09:56:05 +01:00
|
|
|
|
- Max. zwei Features pro Fuß und Feature-Positionsregeln
|
|
|
|
|
|
- Programmtypen, erlaubte Elementanzahl sowie Wiederholungs- und
|
|
|
|
|
|
Kombinationsregeln
|
2026-10-31 09:01:47 +01:00
|
|
|
|
- GOE-Tabellen und `V`-/Unterrotations-Varianten
|
|
|
|
|
|
- Sprungkombinationen und -folgen als zusammengesetzte Elemente
|
2026-10-31 09:56:05 +01:00
|
|
|
|
- Adult-spezifische Programmregeln
|
2026-10-31 09:01:47 +01:00
|
|
|
|
- Vorschlagsliste im Inspector direkt aus `suggest()`
|