- once_per_program ist im RoutineValidator umgesetzt - letzte Session und Stand auf 2026-11-01 aktualisiert - GOE und Varianten in der Roadmap vorerst zurueckgestellt
289 lines
13 KiB
Markdown
289 lines
13 KiB
Markdown
# ISU-Regelwerk – Elementkatalog, Level-Features und Adult-Kategorien
|
||
|
||
Stand: 2026-10-31
|
||
Saison: **2026/27** (Oberstdorf 2027)
|
||
|
||
Quellen:
|
||
|
||
- 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 2026/27* (ersetzt 2701)
|
||
- ISU International Adult Figure Skating Competitions 2026/27 –
|
||
Technical Announcement (für Oberstdorf 2027)
|
||
|
||
Anleitung und Annahmen für die Bedienung: `docs/manual.md`.
|
||
|
||
## 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`
|
||
- **17 Pirouettenfamilien** inkl. `ChSp` (Choreographic Spin)
|
||
- **2 Sequenzen**: `StSq` (Base–4) und `ChSq` (nur Level 1)
|
||
- **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
|
||
und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
|
||
|
||
## Dateien
|
||
|
||
| Datei | Inhalt |
|
||
| :--- | :--- |
|
||
| `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": "2026/27",
|
||
"discipline": "Single & Pair Skating",
|
||
"valid_from": "2026-07-01",
|
||
"source": "ISU Communication No. 2786, ...",
|
||
"elements": [
|
||
{
|
||
"code": "3Lz",
|
||
"name": "Triple Lutz",
|
||
"type": "jump",
|
||
"base_value": 5.90
|
||
},
|
||
{
|
||
"code": "CCoSp",
|
||
"name": "Change foot combination spin",
|
||
"type": "spin",
|
||
"base_values": {
|
||
"B": 2.00, "1": 2.40, "2": 3.00, "3": 3.60, "4": 4.20
|
||
}
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
- `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) # 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
|
||
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 | 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
|
||
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` 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 wertet `once_per_program` aus und
|
||
meldet ab dem zweiten Element eine Warnung. Die Begrenzung „max. zwei
|
||
Features pro Fuß“ und die Feature-Positionsregeln 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
|
||
des gewählten Elementtyps, z. B. `CCoSp — Change foot combination spin`. Für
|
||
Kombinationen und Varianten, die der Katalog nicht strukturiert abbildet
|
||
(`3Lzq`, `CCoSpV`, Altdaten), gibt es den Eintrag **„Freitext / Kombination …“**;
|
||
neue Sprungkombinationen werden dagegen strukturiert über erste Sprung plus
|
||
bis zu zwei weitere gewählt.
|
||
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: 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.
|
||
|
||
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 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
|
||
- Sprungfolgen ohne Axel als zweiten oder dritten Sprung
|
||
- 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 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
|
||
- Level gültig
|
||
- ChSq-Level
|
||
- Feature-Auswahl gültig
|
||
- Pflichtfeatures
|
||
- Level aus Features
|
||
- Einmal pro Programm
|
||
- Kategorie: Sprunganzahl, erlaubte Sprünge, Pirouetten, Sequenzen,
|
||
Level-Grenzen, Pflichtelemente, Dauer, Wiederholungen, Kombinationen
|
||
|
||
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 eine **Punktschätzung** aus drei Teilen:
|
||
|
||
1. **Basiswert:** Summe der Base Values aller Elemente mit gültigem
|
||
Katalogwert, plus Wertungsliste pro Element (`CCoSp L4 — 4,20`).
|
||
2. **PCS-Annahme:** Durchschnitt pro Komponente × 3 Komponenten ×
|
||
Kategorie-Faktor (z. B. Gold 2,67).
|
||
3. **Sturzabzug:** Anzahl Stürze × Kategorie-Abzug (Gold 1,0; Silver/Bronze
|
||
0,5).
|
||
|
||
Die Annahmen sind über **ⓘ Annahmen ändern** direkt im Dialog einstellbar
|
||
(PCS-Durchschnitt 0–10, Stürze 0–20) und werden mit der Kür gespeichert.
|
||
GOE ist weiterhin nicht enthalten; Freitext- und nicht katalogisierte
|
||
Kombinationselemente ohne Katalogwert werden als nicht gewertet markiert. Der Wert bleibt eine grobe
|
||
Schätzung, keine offizielle Punktzahl.
|
||
|
||
Der Link **ⓘ Was ist enthalten?** klappt die Grenzen der Basiswert-Summe auf;
|
||
ein zweiter Klick blendet sie wieder aus.
|
||
|
||
## Neue Saison einpflegen
|
||
|
||
1. Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
|
||
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_2027_28.json` anlegen, `ElementLevelRules.DEFAULT_PATH`
|
||
umstellen und `tests/run_level_tests.gd` anpassen.
|
||
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
|
||
mit ausgeliefert.
|
||
|
||
## Nächste Ausbaustufen
|
||
|
||
- Max. zwei Features pro Fuß und Feature-Positionsregeln
|
||
- GOE-Tabellen und `V`-/Unterrotations-Varianten
|
||
- Vorschlagsliste im Inspector direkt aus `suggest()`
|