feat: ISU 2026/27 und Adult-Kategorien

- SoV 2026/27 (Communication 2786) und Levels 2026/27 (2788)
- 15 Pirouetten- und 5 Sequenz-Features, Windmills, neues ChSp1
- Adult-Kategorien Gold/Silver/Bronze plus Masters/Elite aus dem
  IAFSC-Announcement 2026/27
- Kategorie-Auswahl in der Statusleiste und Kategorie-Validierung
  (Sprunganzahl, erlaubte Sprünge, Level-Caps, Pflichtelemente)
- 60 Adult-Assertions; gesamt 1012 Assertions gruen
- Doku, Findings und Roadmap aktualisiert
This commit is contained in:
torsten 2026-10-31 11:21:18 +01:00
parent 531a057168
commit e4fd74ea6e
25 changed files with 1930 additions and 119 deletions

View file

@ -1,15 +1,17 @@
# ISU-Regelwerk – Elementkatalog und Level-Features
# ISU-Regelwerk – Elementkatalog, Level-Features und Adult-Kategorien
Stand: 2026-10-31
Saison: **2025/26**
Saison: **2026/27** (Oberstdorf 2027)
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
- ISU Communication No. 2786, *Single & Pair Skating – Scale of Values and
Program Components Factors valid as of July 1, 2026* (ersetzt 2707)
- ISU Communication No. 2788, *Single & Pair Skating – Levels of Difficulty
and Guidelines for marking Grade of Execution and Program Components,
Season 2025/26* (ersetzt Communication 2623)
Season 2026/27* (ersetzt 2701)
- ISU International Adult Figure Skating Competitions 2026/27 –
Technical Announcement (für Oberstdorf 2027)
## Zweck
@ -20,11 +22,10 @@ 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)
- **17 Pirouettenfamilien** inkl. `ChSp` (Choreographic Spin)
- **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
- **Level-Features** für Pirouetten (15) und Schrittsequenzen (5)
- **Adult-Kategorien** Bronze, Silver, Gold, Masters, Masters Elite
Nicht abgedeckt (bewusst offen): GOE-Tabellen, reduzierte `V`-Varianten,
Unterrotations-/Fehlkanten-Suffixe (`<`, `<<`, `q`, `e`, `!`), Sprungkombinationen
@ -34,24 +35,27 @@ und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
| 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/data/isu_sov_2026_27.json` | Katalog mit Base Values |
| `rinkplanner/src/core/rules/data/isu_levels_2026_27.json` | Level-Features und Schwellen |
| `rinkplanner/src/core/rules/data/isu_adult_2026_27.json` | Adult-Kategorien und Limits |
| `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/src/core/rules/adult_category_rules.gd` | Adult-Kategorien, Limits und Sprungerlaubnis |
| `rinkplanner/tests/run_rules_tests.gd` | Katalog-Tests inkl. Stichproben |
| `rinkplanner/tests/run_level_tests.gd` | Feature- und Level-Tests |
| `rinkplanner/tests/run_adult_tests.gd` | Adult-Kategorie-Tests |
## Datenformat
```json
{
"schema_version": 1,
"season": "2025/26",
"season": "2026/27",
"discipline": "Single & Pair Skating",
"valid_from": "2025-07-01",
"source": "ISU Communication No. 2707, ...",
"valid_from": "2026-07-01",
"source": "ISU Communication No. 2786, ...",
"elements": [
{
"code": "3Lz",
@ -64,7 +68,7 @@ und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
"name": "Change foot combination spin",
"type": "spin",
"base_values": {
"B": 1.70, "1": 2.00, "2": 2.50, "3": 3.00, "4": 3.50
"B": 2.00, "1": 2.40, "2": 3.00, "3": 3.60, "4": 4.20
}
}
]
@ -85,8 +89,8 @@ und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
```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("CCoSp", 4) # 4.20
catalog.get_base_value("CCoSp4", -1) # 4.20 (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
@ -116,11 +120,16 @@ 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 |
| Pirouette | 15 | Max. 2 schwierige Variationen; Level 4 verlangt eines von 6 Features inkl. Windmills |
| Schrittsequenz | 5 | Feature 1 (Vielfalt) ist Pflicht; ohne sie bleibt die Sequenz Base |
| `ChSq` / `ChSp` | – | Fest Level 1 |
| Sprung | – | Nicht levelbar |
Für Level 4 bei Pirouetten muss zusätzlich eines dieser Features gezählt
werden: schwieriger Ausgang, klare Kantenänderung, beide Richtungen, klare
Temposteigerung, schwieriger Flug-Eingang oder **Windmills**. Der frühere
„schwierige Positionswechsel“ ist kein Pflichtfeature mehr.
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
@ -140,12 +149,37 @@ 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
Base, `ChSq` und `ChSp` 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.
## Adult-Kategorien
Die Adult-Regeln liegen als eigene Datei aus dem IAFSC Technical Announcement
2026/27. Das Announcement hat bei Konflikten Vorrang vor den allgemeinen
ISU-Regeln. Die Kategorie wird über `Routine.adult_category` an der Kür
gespeichert und in der Statusleiste gewählt.
| | Gold | Silver | Bronze |
| :--- | :--- | :--- | :--- |
| Dauer | 2:50 ±10 s | 2:00 ±10 s | 1:40 ±10 s |
| Sprünge | max. 5 | max. 4 | max. 4 |
| Erlaubt | Einfach/Double, ohne 2F/2Lz/2A/Triple | nur Einfach inkl. 1A | nur Einfach ohne Axel |
| Pirouetten | max. 3, inkl. `ChSp` | max. 2 | max. 2 |
| Sequenz | 1 Schrittsequenz | 1 Choreo-Sequenz | 1 Choreo-Sequenz |
| Level-Cap | Spins 3 / Sequenz 2 | 2 / 2 | 1 / 1 |
| PCS-Faktor | 2,67 | 2,00 | 2,00 |
| Sturzabzug | 1,0 | 0,5 außerhalb Elemente | 0,5 außerhalb Elemente |
Masters und Masters Elite sind ebenfalls in den Daten. Der Validator prüft
Sprunganzahl, erlaubte Rotationen (inkl. Axel-Verbot), Pirouetten- und
Sequenzanzahl, Level-Caps und Pflichtelemente wie `ChSp` oder Axel. Die
Befunde erscheinen als Warnungen im Prüfdialog; Speichern und Export bleiben
möglich.
## Bedienung
Der Element-Inspector bietet für das Kürzel eine Auswahlbox mit den Familien
@ -155,8 +189,8 @@ Kombinationen und Varianten, die der Katalog nicht strukturiert abbildet
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
Der Inspector zeigt unter der Level-Auswahl `Base Value: 4,20`.
Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2026/27“. Der
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Features; der
Tooltip nennt Saison und Quelle.
@ -174,15 +208,18 @@ 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`
- nicht verfügbare Level, Sprung-Level ungleich 0 und die festen Level von
`ChSq`/`ChSp`
- 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
- bei gewählter Adult-Kategorie: Sprunganzahl, erlaubte Sprünge,
Pirouetten-/Sequenzanzahl, Level-Caps und Pflichtelemente
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:
Der Kopf nennt Umfang und Kategorie (`Geprüft: 4 Elemente in 1 Abschnitt
(Saison 2026/27)`, `Kategorie: Gold · 2:50 ±10 s`), darunter listet die
Prüfliste jede Kategorie mit `bestanden/geprüft` und Befundzahl:
- Kürzel im Katalog
- Elementtyp passt
@ -192,6 +229,8 @@ Der Kopf nennt den Umfang (`Geprüft: 4 Elemente in 1 Abschnitt (Saison
- Pflichtfeatures
- Level aus Features
- Einmal pro Programm
- Kategorie: Sprunganzahl, erlaubte Sprünge, Pirouetten, Sequenzen,
Level-Grenzen, Pflichtelemente
Nicht anwendbare Kategorien nennen den Grund, z. B. „nicht anwendbar (kein
ChSq)“ oder „nicht anwendbar (keine Features gesetzt)“. Erst danach folgen
@ -203,7 +242,7 @@ 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 — —`)
- Wertungsliste pro Element (`CCoSp L4 — 4,20`, `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
@ -213,22 +252,25 @@ Gesamtpunktzahl.
Der Link **ⓘ Was ist enthalten?** klappt diese Grenzen direkt im Prüfdialog
auf; ein zweiter Klick blendet sie wieder aus. Noch nicht geprüft werden
Programmtyp, erlaubte Elementanzahl, Wiederholungs- und Kombinationsregeln
sowie die Begrenzung auf zwei Features pro Fuß.
Dauer, 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`.
obigen Schema anlegen, z. B. `isu_sov_2027_28.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`
`isu_levels_2027_28.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
6. Adult-Announcement der Saison als `isu_adult_2027_28.json` anlegen,
`AdultCategoryRules.DEFAULT_PATH` umstellen und
`tests/run_adult_tests.gd` anpassen.
7. `./tools/test.sh` ausführen.
8. 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
@ -237,9 +279,9 @@ mit ausgeliefert.
## Nächste Ausbaustufen
- Max. zwei Features pro Fuß und Feature-Positionsregeln
- Programmtypen, erlaubte Elementanzahl sowie Wiederholungs- und
Kombinationsregeln
- Wiederholungs- und Kombinationsregeln
- Dauerprüfung gegen die Kategorie-Zeit
- PCS und Sturzabzüge in der Punktschätzung
- GOE-Tabellen und `V`-/Unterrotations-Varianten
- Sprungkombinationen und -folgen als zusammengesetzte Elemente
- Adult-spezifische Programmregeln
- Vorschlagsliste im Inspector direkt aus `suggest()`