- ElementDefinition/ElementCatalog in src/core/rules mit JSON-Daten - 24 Sprünge, 16 Pirouetten und 2 Sequenzen aus ISU Communication 2707 - Lookup nach Familie/Level, kanonischen Suffixen und Anzeigenamen - Level-Suffixe werden beim Übernehmen ins Level-Feld normalisiert - Base-Value-Hinweis samt Quellen-Tooltip im Element-Inspector - 160 neue Regelwerk-Assertions; Whiteboard-Tests erweitert (766 gesamt) - JSON über include_filter in allen Export-Presets - Docs: isu-rules.md, Findings, Architektur und Roadmap aktualisiert
4.7 KiB
ISU-Regelwerk – Elementkatalog
Stand: 2026-10-31 Saison: 2025/26 Quelle: ISU Communication No. 2707, Single & Pair Skating – Scale of Values valid as of July 1, 2025 (ersetzt Communication 2656)
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 - 16 Pirouettenfamilien der Einzel- und Paarlauf-SoV (einpositionig, mit Fußwechsel, Kombinationen, jeweils auch geflogen)
- 2 Sequenzen:
StSq(Base–4) undChSq(nur Level 1)
Nicht abgedeckt (bewusst offen): GOE-Tabellen, reduzierte V-Varianten,
Unterrotations-/Fehlkanten-Suffixe (<, <<, q, e, !), Sprungkombinationen
und -folgen, Paarlauf-Hebungen/Twists/Throws, Eistanz-Elemente, Feature-Kriterien
und die daraus abgeleitete Level-Bestimmung.
Dateien
| Datei | Inhalt |
|---|---|
rinkplanner/src/core/rules/data/isu_sov_2025_26.json |
aktiver Katalog |
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/tests/run_rules_tests.gd |
Headless-Tests inkl. Stichproben |
Datenformat
{
"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
}
}
]
}
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) # 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 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.
Bedienung
Der Element-Inspector zeigt unter der Level-Auswahl Base Value: 3,50.
Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2025/26“. Der
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Level; der Tooltip
nennt Saison und Quelle.
Neue Saison einpflegen
- Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
obigen Schema anlegen, z. B.
isu_sov_2026_27.json. season,valid_fromundsourceaktualisieren.ElementCatalog.DEFAULT_PATHauf die neue Datei zeigen lassen.- Stichproben in
tests/run_rules_tests.gdauf die neuen Werte anpassen (mindestens ein Sprung, eine Pirouette, eine Sequenz). ./tools/test.shausführen.- Die alte Datei kann für Nachvollziehbarkeit im Repo bleiben; aktiv ist immer genau eine Datei.
Die JSON-Datei wird über include_filter="*.json" in allen Export-Presets
mit ausgeliefert.
Nächste Ausbaustufen
- Level-/Feature-Prüfung (welche Features ergeben welches Level)
- GOE-Tabellen und
V-/Unterrotations-Varianten - Sprungkombinationen und -folgen als zusammengesetzte Elemente
- Programmvalidierung (erlaubte Elementanzahl, Wiederholungen, Adult-Regeln)
- Vorschlagsliste im Inspector direkt aus
suggest()