rinkplanner/docs/findings-2026-10-31-isu-katalog.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.2 KiB
Raw Blame History

Findings – Session: ISU-Elementkatalog (2026-10-31)

Ergänzung zu docs/findings-2026-10-30-element-marker.md. Diese Session hat den ersten Schritt des ISU-Regelwerks umgesetzt: einen saisonalen Elementkatalog mit Base Values und Leveln, inklusive Anbindung an den Element-Inspector.

Ergebnis

Ziel Ergebnis
Katalogmodell ElementDefinition + ElementCatalog in src/core/rules/
Daten isu_sov_2025_26.json: 24 Sprünge, 16 Pirouetten, 2 Sequenzen
Quelle ISU Communication No. 2707, gültig ab 2025-07-01
Lookup Familie + Level, kanonische Suffixe, case-insensitiv, -1 bei Unbekanntem
UI Base-Value-Hinweis im Element-Inspector inkl. Quellen-Tooltip
Tests 766 Assertions gesamt, ./tools/test.sh grün (neu: 160 Regelwerk)

Entscheidungen

  • Daten statt Code: Der Katalog ist JSON mit schema_version, season, valid_from und source. Eine neue Saison ersetzt die Datei; Modell und Canvas bleiben unverändert.
  • Familie plus Level: Ein Eintrag beschreibt die Familie (CCoSp) und trägt die Base Values für Base–4. Sprünge sind nicht levelbar und haben genau einen Wert. Ein Level-Suffix im eingegebenen Kürzel (CCoSp4) wird beim Übernehmen abgetrennt und ins Level-Feld übernommen; gespeichert wird die Familie.
  • Keine abgeleiteten Werte am Segment: PathSegment speichert weiterhin nur element_code und element_level. Der Base Value wird bei Bedarf aufgelöst, damit SoV-Updates alte Kürdaten nicht verfälschen.
  • Strenge Lookups: Unbekannte Kürzel/Level liefern -1.0, damit die UI den Unterschied zwischen „0 Punkte“ und „nicht im Katalog“ zeigen kann.
  • Ein-Level-Fallback: ChSq existiert nur als ChSq1; ein bloßes ChSq löst deshalb auf dieses eine Level auf. Das ist die einzige bewusste Ausnahme.
  • Export: Alle Presets führen *.json über include_filter mit, weil der Katalog per FileAccess und nicht als importierte Ressource geladen wird.

Umfang der Daten

  • Sprünge 1T–4A inklusive 3A (im PDF mit kyrillischem А; beim Erzeugen normalisiert).
  • Pirouetten: USp, LSp, CSp, SSp, FUSp, FLSp, FCSp, FSSp, CUSp, FCUSp, CLSp, FCLSp, CoSp, FCoSp, CCoSp, FCCoSp.
  • Sequenzen: StSq (Base–4), ChSq (Level 1).

Bewusst nicht enthalten: GOE-Tabellen, V-Varianten, q/e/!/</<<- Suffixe, Kombinationen/Folgen, Paarlauf- und Eistanz-Elemente, Features und Level-Bestimmung.

Bedienung

  • Der Element-Inspector zeigt Base Value: 3,50 unter der Level-Auswahl.
  • Der Hinweis folgt Typ, Kürzel und Level; bei unbekannten Kürzeln steht „Kürzel nicht im Katalog 2025/26“.
  • Der Tooltip nennt Saison und Quelle.
  • Der Hinweis ElementHint hat jetzt eine feste Mindestbreite (480 px). Ohne sie berechnete das autowrap-Label seine Höhe bei Breite 1 und trieb den Dialog auf mehrere tausend Pixel; der Dialog bleibt nun bei 520 × 506 und zeigt seine Buttons.

Tests

Neu: tests/run_rules_tests.gd (160 Assertions)

  • Metadaten: Saison, Quelle, Gültigkeitsdatum, 42 Familien, eindeutige Codes
  • Stichproben aller Elementgruppen (u. a. 3Lz, 3A, 4A, CCoSp4, StSq3, ChSq1)
  • Level-Auflösung, Suffix-Erkennung, Case-Insensitivität, Typfilter
  • Vorschläge nach Kürzel und Anzeigename
  • Segment-Integration inkl. Typ-Mismatch
  • Fehlerfälle: fehlende Datei, unbekannter Typ, ungültiger Level-Key, Duplikat

Erweitert: tests/run_whiteboard_tests.gd (201 → 208 Assertions) prüft, dass der Controller den Katalog lädt, Level-Suffixe normalisiert und der Inspector 2,50, 3,50 bzw. den „nicht im Katalog“-Hinweis zeigt.

Offene Punkte

  1. Features und Level: Der Katalog kennt Level, aber nicht die Kriterien, die zu einem Level führen.
  2. Varianten: GOE, V, Unterrotation und Fehlkante fehlen; Kürzel bleiben dafür Freitext.
  3. Zusammengesetzte Elemente: Sprungkombinationen und -folgen werden noch nicht strukturiert abgebildet.
  4. Adult-Regeln: Die Adult-Kürzelnormen (erlaubte Elemente, Wiederholungen, Zeitlimits) sind nicht Teil des Katalogs.
  5. Vorschläge in der UI: suggest() ist vorhanden, aber der Inspector zeigt noch keine Autovervollständigung.