- 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
90 lines
4.2 KiB
Markdown
90 lines
4.2 KiB
Markdown
# 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.
|