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
This commit is contained in:
parent
d1a6faa53e
commit
789fbc2826
17 changed files with 1577 additions and 34 deletions
126
docs/isu-rules.md
Normal file
126
docs/isu-rules.md
Normal file
|
|
@ -0,0 +1,126 @@
|
|||
# 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
|
||||
|
||||
```json
|
||||
{
|
||||
"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:
|
||||
|
||||
```gdscript
|
||||
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()`
|
||||
Loading…
Add table
Add a link
Reference in a new issue