rinkplanner/docs/isu-rules.md
torsten 23543a0018 docs: GOE bewusst ausschließen
GOE vergibt der Richter nach der Ausführung (−5 bis +5, Kriterien wie Höhe,
Fluss, Landung). Es ist aus einem Plan nicht ableitbar; eine berechnete Zahl
würde eine Genauigkeit vortäuschen, die die App nicht hat.

- Roadmap: GOE von "Optional" nach "Bewusst nicht" mit Begründung.
- `docs/isu-rules.md`: gleiche Einordnung bei den nächsten Ausbaustufen.
- Die `V`-/Unterrotationsvarianten bleiben optional, jetzt ausdrücklich als
  Was-wäre-wenn — ihr Basiswert-Effekt ist deterministisch, die Eingabe
  bleibt eine Annahme.
2026-11-13 15:19:15 +01:00

14 KiB
Raw Blame History

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 Mehrsaison-Struktur (Saisonordner, Manifest, deklarative Policies, Invarianten, Saison-Upgrade-Prüfung) ist umgesetzt; Format und Pflege stehen in docs/isu-rules-structure.md. Dieses Dokument beschreibt, was in der Saison gilt, und wird bei jeder neuen Saison fortgeschrieben.

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

{
  "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:

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 19 5 Varianten-Kategorien; max. 2 Variationen und max. 2 Features pro Fuß; 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.

Drei Grenzen gelten zusätzlich (ISU 2788):

  • Variationen sind nach Grundposition getrennt (difficult_variation_sit, _camel, _layback, _upright, _other). Jede Kategorie zählt einmal pro Programm.
  • Höchstens zwei Variationen zählen pro Pirouette, auch wenn mehr angehakt sind.
  • Höchstens zwei Features pro Fuß zählen in einer Pirouette mit Fußwechsel. Dafür speichert das Segment den Fuß je Feature (element_feature_feet); die App fragt ihn nur ab, wenn mehr als zwei fußbezogene Features gewählt sind.

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_sit", "difficult_exit"]),
    {"difficult_variation_sit": "L"}
)
# result.level == 2, result.counted_features == 2

Das Segment speichert die Auswahl als element_features (PackedStringArray, jeder Code höchstens einmal) und optional den Fuß als element_feature_feet. 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), per_foot und Feature-Gruppen mit eigenem Deckel (groups). Die Programmprüfung wertet once_per_program aus, meldet ab dem zweiten Element eine Warnung und prüft Gruppen- sowie Fuß-Deckel; fehlt bei mehr als zwei fußbezogenen Features die Fußangabe, weist sie darauf hin.

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; der Programmtyp steht in Routine.program_type.

Jede Kategorie existiert zweimal – einmal für die Kür ("program_type": "free") und einmal für Artistic ("artistic", Feld scored: false). Die Tabellen unten gelten für die Kür; Artistic prüft nur Dauer und Begrenzungen (1–2 Sprünge, 1–2 Pirouetten, kein Axel in Bronze/Silver/Gold, keine Doppel/Dreifach, keine Kombinationen, 1:30 bzw. 2:00 ±10 s) und zeigt keine Punktschätzung.

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

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:

  1. Ordner 2027-28/ anlegen und manifest.json schreiben (season, valid_from, replaces, Dokumente mit Quelle). Fehlende Papiere als inherit_from eintragen, status bleibt dann partial.
  2. sov.json, levels.json und adult.json nach dem obigen Schema anlegen. Die drei Dateien dürfen zu verschiedenen Terminen entstehen.
  3. notes.md mit den Änderungen gegenüber der Vorsaison füllen.
  4. ./tools/test.sh (enthält ./tools/check_rules.sh).
  5. Sobald alle Papiere da sind: inherit_from durch file ersetzen, 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

  • V-/Unterrotations-Varianten als Was-wäre-wenn (der Basiswert-Effekt ist deterministisch, die Eingabe bleibt eine Annahme)
  • Vorschlagsliste im Inspector direkt aus suggest()

Bewusst nicht: GOE-Tabellen. GOE ist Richterermessen über die Ausführung (−5 bis +5) und aus dem Plan nicht ableitbar; die Punktschätzung nennt die Lücke statt sie zu füllen.