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:
torsten 2026-10-31 09:01:47 +01:00
parent d1a6faa53e
commit 789fbc2826
17 changed files with 1577 additions and 34 deletions

View file

@ -1,10 +1,10 @@
# Rinkplanner – Architektur & Entscheidungen (Phase 1)
Stand: 2026-10-30
Stand: 2026-10-31
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-30-element-marker.md`
(Session davor: `docs/findings-2026-10-30.md`)
Letzte Session: `docs/findings-2026-10-31-isu-katalog.md`
(Session davor: `docs/findings-2026-10-30-element-marker.md`)
## 1. Leitentscheidung
@ -26,8 +26,8 @@ wird nicht weiterentwickelt. Phase 2 konsumiert später dasselbe Datenmodell
├── project.godot
├── src/
│ ├── core/model/ # reine Daten-Resources
│ └── core/rules/ # ISU-Regeln (folgt)
├── whiteboard/ # Phase 1: view / ctrl / io (folgt)
│ ├── core/rules/ # ISU-Katalog (JSON + Lookup)
│ └── whiteboard/ # Phase 1: view / ctrl / io
├── scenes/ # dünne Szenen, die Views zusammensetzen
├── assets/
├── tests/ # headless GDScript-Tests
@ -56,6 +56,13 @@ Implementiert in `rinkplanner/src/core/model/`:
| `PathSegment` | durchgehender Pfad mit Richtung, Kante, Dauer, Element-Marker und Label |
| `RinkDimensions` | Maße, Koordinaten, Punkte-/Kurvenprüfung |
Implementiert in `rinkplanner/src/core/rules/`:
| Klasse | Verantwortung |
| :--- | :--- |
| `ElementDefinition` | Elementfamilie (z. B. `CCoSp`) mit Typ, Name und Base Values je Level |
| `ElementCatalog` | saisonaler JSON-Katalog, Lookup nach Kürzel/Level, Vorschläge, Prüfung |
### Entscheidungen
**D1 – Segment statt Section als Träger von Richtung und Kante.**
@ -98,6 +105,18 @@ gehört in den Controller, nicht ins Modell.
`validate() -> PackedStringArray` ist die primäre API; `is_valid()` ist nur
eine Abkürzung. So kann die UI Fehler konkret anzeigen.
**D8 – Das ISU-Regelwerk ist saisonal externalisiert.**
Der Elementkatalog liegt als JSON unter `src/core/rules/data/` und trägt
Saison, Quelle und Gültigkeitsdatum. `ElementCatalog` liest ihn zur Laufzeit
und löst Kürzel plus Level zu Base Values auf. Segmente speichern nur
`element_code` und `element_level`, keine abgeleiteten Punkte; dadurch bleibt
eine neue SoV eine reine Datenaustausch-Aufgabe. Kürzel werden
case-insensitiv und auch als kanonischer Code mit Level-Suffix (`CCoSp4`,
`StSqB`) gefunden; ein Suffix im Kürzel hat Vorrang und wird beim Übernehmen
ins Level-Feld normalisiert. Unbekannte Kürzel oder Level liefern `-1` statt
einen stillen Standardwert. Das JSON wird über `include_filter="*.json"` in die
Exporte aufgenommen.
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -139,9 +158,11 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
Bereiche entstehen, indem ein gezeichnetes Segment über den Inspector
getaggt wird. Punktmarker haben eine **Standzeit** (`element_duration_seconds`)
mit Typ-Defaults (Sprung 0,7 s, Pirouette 8 s, Sequenz 0 s), die im
Inspector übersteuert wird und in die Timeline eingeht. Die Timing-Details
(Dauer/Tempo/Profil) werden beim Setzen und für Punktmarker ausgeblendet,
damit die Leiste auch im Landscape kompakt bleibt.
Inspector übersteuert wird und in die Timeline eingeht. Der Inspector zeigt
außerdem den **Base Value** des eingegebenen Kürzels und Levels aus dem
Saisonkatalog; unbekannte Kürzel werden als „nicht im Katalog“ markiert.
Die Timing-Details (Dauer/Tempo/Profil) werden beim Setzen und für
Punktmarker ausgeblendet, damit die Leiste auch im Landscape kompakt bleibt.
- **Section-Verwaltung:** Ein Panel rechts zeigt die chronologische
Abschnittsliste. Neue Sections werden angelegt, umbenannt, gelöscht und
hoch-/runtergeschoben; `sequence_order` wird nach jeder Änderung
@ -289,12 +310,16 @@ Aktueller Stand:
- **Model:** 81 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, Element-Marker samt Kürzel-/Level-/Dauer-Grenzen,
Schema-Version, Section-Aggregation und Routine-Validierung.
- **Regelwerk:** 160 Assertions für Katalog-Metadaten, Saison/Quelle,
Sprung-/Pirouetten-/Sequenz-Base-Values, Level-Auflösung, Kürzel-Suffixe,
Case-Insensitivität, Vorschläge, Segment-Integration und fehlerhafte Kataloge.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 201 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 208 Assertions für Controller-Verdrahtung, Segmenterzeugung,
Linien-/Bogenpfade, Klemmen an der Bande, Auswahl, Griff- und
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Element-Marker (Setzen,
Typwechsel, Inspector inkl. Standzeit, Verschieben, Löschen), Section-Verwaltung,
Typwechsel, Inspector inkl. Standzeit und Base-Value-Hinweis, Verschieben,
Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State,
Navigationsmodus und den Maus-Drag-Pfad.

View file

@ -0,0 +1,90 @@
# 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.

126
docs/isu-rules.md Normal file
View 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()`

View file

@ -1,6 +1,6 @@
# Rinkplanner – Roadmap
Stand: 2026-10-31 (PoC: Sync-Komfort und UI-Refactoring zurückgestellt)
Stand: 2026-10-31 (ISU-Katalog begonnen; Sync-Komfort und UI-Refactoring zurückgestellt)
Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen
nur bewusst und nach Rücksprache. Erkenntnisse der letzten Session:
`docs/findings-2026-10-30-element-marker.md`.
@ -107,12 +107,19 @@ Voraussetzung für Phase 1.
- [x] Tests für Marker-Modell, Interaktion und Export erweitern
- [ ] Optional: Elementkatalog mit Kürzelvorschlägen (Teil des ISU-Regelwerks)
### Nächste Session: ISU-Regelwerk
### In Arbeit: ISU-Regelwerk
- [ ] Elementkatalog als strukturierte Daten (JSON/Resources)
- [ ] Base Values, Level und Features
- [x] Elementkatalog als strukturierte Daten (JSON/Resources)
– Saison 2025/26 mit 24 Sprüngen, 16 Pirouetten und 2 Sequenzen;
Format und Pflege in `docs/isu-rules.md`
- [x] Base Values und Level je Elementfamilie
- [x] Regelversionen pflegbar halten (saisonale JSON-Datei mit Quelle und
Gültigkeitsdatum)
- [x] Base-Value-Hinweis im Element-Inspector
- [ ] Features und Kriterien für die Level-Vergabe
- [ ] Validierung von Elementen und Kombinationen
- [ ] Regelversionen pflegbar halten
- [ ] Optional: Kürzelvorschläge im Inspector aus `suggest()`
- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten
### Danach: Weitere fachliche Erweiterungen
@ -136,10 +143,11 @@ fachlichen Validierung angefasst.
Übernahme des Feedbacks der Tester
Die Reihenfolge ist bewusst: native Builds, Datenaustausch und Element-Marker
sind erledigt. Im PoC folgt jetzt die vollständige ISU-Logik; Sync-Komfort und
UI-Refactoring sind zurückgestellt, weil der bestehende Stand für Tests genügt
und die endgültige Sync-Architektur (PHP-Webserver) sowie das UI-Feedback der
Tester ohnehin noch ausstehen.
sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – der Katalog steht, als
Nächstes folgen Features und Validierung. Sync-Komfort und UI-Refactoring sind
zurückgestellt, weil der bestehende Stand für Tests genügt und die endgültige
Sync-Architektur (PHP-Webserver) sowie das UI-Feedback der Tester ohnehin noch
ausstehen.
## Querschnittsaufgaben