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

90 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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