rinkplanner/docs/isu-rules.md
torsten e4fd74ea6e 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
2026-10-31 11:21:18 +01:00

287 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)
## 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 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
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: 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
- 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
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 — 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
Kombinationselemente ohne Katalogwert werden als nicht gewertet markiert.
Der angezeigte Wert ist damit ein technischer Basiswert, keine
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
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_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
- 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
- Vorschlagsliste im Inspector direkt aus `suggest()`