rinkplanner/docs/isu-rules.md
torsten 789fbc2826 feat: ISU-Elementkatalog mit Base Values für 2025/26
- 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
2026-10-31 09:01:47 +01:00

4.7 KiB
Raw Blame History

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 1T bis 4A
  • 16 Pirouettenfamilien der Einzel- und Paarlauf-SoV (einpositionig, mit Fußwechsel, Kombinationen, jeweils auch geflogen)
  • 2 Sequenzen: StSq (Base–4) und ChSq (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
      }
    }
  ]
}
  • 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:

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 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.

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

  1. Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem obigen Schema anlegen, z. B. isu_sov_2026_27.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. ./tools/test.sh ausführen.
  6. 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()