Das ISU-Regelwerk liegt jetzt je Saison in einem eigenen Ordner mit Manifest. Der Code fragt nach Dokumentarten (sov, levels, adult) statt nach Dateinamen; eine neue Saison braucht kein GDScript. - Manifest je Saison mit Quellen, valid_from und deklarativen Policies. Fehlt eine Policy, gilt sie in dieser Saison nicht – alte Saisons erben keine später erfundenen Regeln. - RulesLibrary findet die Saisons per Verzeichnis-Scan, löst Vererbung für zeitversetzt erscheinende Papiere auf und wählt als Voreinstellung die neueste vollständige Saison ab valid_from. - RulesAudit prüft den Invariantenkatalog A–F (Sprungreihenfolge, Level- Schwellen, Adult-Grenzen, Policies) und läuft über tools/check_rules.sh sowie in ./tools/test.sh. - Saison an der Kür (Schema 7): alte Küren werden gegen das Regelwerk ihrer eigenen Saison geprüft. Die Statusleiste zeigt und wechselt die Saison; ohne Zuordnung prüft die App nichts, statt still gegen die falsche Saison zu rechnen. - Validator läuft pro Regelpaket; ein Saison-Paar-Test sichert die dokumentierte Differenz zwischen 2025/26 und 2026/27 ab. - PDF-Kopf nennt die Saison, docs/manual.md erklärt die Zuordnung, docs/isu-rules-structure.md beschreibt Struktur und Migrationsplan. 2025/26 hat noch keine Adult-Regeln; das Manifest markiert das Dokument als missing, die Prüfung meldet die Kategorie als nicht anwendbar.
13 KiB
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.
Die geplante Mehrsaison-Struktur (Saisonordner, Manifest, deklarative
Policies, Saison-Upgrade-Prüfung) steht in docs/isu-rules-structure.md.
Sie ist noch nicht umgesetzt; bis zur Migration gilt dieses Dokument.
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
1Tbis4A - 17 Pirouettenfamilien inkl.
ChSp(Choreographic Spin) - 2 Sequenzen:
StSq(Base–4) undChSq(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
{
"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
}
}
]
}
codeist die Familie ohne Level-Suffix (3Lz,CCoSp,StSq).typeistjump,spinodersequenceund wird aufPathSegment.ElementTypeabgebildet.- Sprünge haben genau einen
base_value(Level 0). Pirouetten und Sequenzen nutzenbase_valuesmit"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:
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 stattCCoSp4+ Level 3. - Unbekannte Kürzel, falsche Typen und nicht vorhandene Level liefern
-1.0statt eines stillen Defaults. - Existiert ein Element nur auf einem Level (
ChSq1), löst ein bloßesChSqauf dieses eine Level auf. - Der Base Value wird nicht am Segment gespeichert. Das Segment trägt nur
element_codeundelement_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:
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:
- Basiswert: Summe der Base Values aller Elemente mit gültigem
Katalogwert, plus Wertungsliste pro Element (
CCoSp L4 — 4,20). - PCS-Annahme: Durchschnitt pro Komponente × 3 Komponenten × Kategorie-Faktor (z. B. Gold 2,67).
- 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
Die Saison ist ein Ordner unter rinkplanner/src/core/rules/data/. Die
verbindliche Struktur, das Manifest-Schema und der Invariantenkatalog stehen in
docs/isu-rules-structure.md. Kurzfassung:
- Ordner
2027-28/anlegen undmanifest.jsonschreiben (season,valid_from,replaces, Dokumente mit Quelle). Fehlende Papiere alsinherit_fromeintragen,statusbleibt dannpartial. sov.json,levels.jsonundadult.jsonnach dem obigen Schema anlegen. Die drei Dateien dürfen zu verschiedenen Terminen entstehen.notes.mdmit den Änderungen gegenüber der Vorsaison füllen../tools/test.sh(enthält./tools/check_rules.sh).- Sobald alle Papiere da sind:
inherit_fromdurchfileersetzen,status: complete.
GDScript muss dafür nicht angefasst werden; die App findet die Saison über das
Manifest. 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()