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
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue