feat: strukturierte Sprungkombinationen

- PathSegment mit jump_kind und combination_jumps (max. 3 Sprünge)
- Base Value summiert strukturierte Kombinations-/Folgeteile
- Element-Dialog mit Art, zweitem und drittem Sprung; Level/Features
  bei Spruengen ausgeblendet
- Validator nutzt strukturierte Teile fuer Wiederholungen und Kombinationen
- Legacy-Freitext bleibt als Fallback lesbar
- 93 Model-, 169 Rules-, 70 Adult- und 288 Whiteboard-Assertions
  (1051 gesamt)
- Doku, Anleitung und Findings aktualisiert
This commit is contained in:
torsten 2026-10-31 11:55:18 +01:00
parent e1f543cb66
commit 8f1cf1bf44
16 changed files with 766 additions and 46 deletions

View file

@ -3,8 +3,8 @@
Stand: 2026-10-31
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-31-adult-2026-27.md`
(Session davor: `docs/findings-2026-10-31-basiswert.md`)
Letzte Session: `docs/findings-2026-10-31-sprungkombinationen.md`
(Session davor: `docs/findings-2026-10-31-adult-2026-27.md`)
## 1. Leitentscheidung
@ -53,7 +53,7 @@ Implementiert in `rinkplanner/src/core/model/`:
| :--- | :--- |
| `Routine` | Wurzelaggregat, Validierung, Gesamtdauer/-länge, Section-Lookup, Adult-Kategorie |
| `RoutineSection` | chronologischer Block, Ghosting-Einheit, Segmentliste |
| `PathSegment` | durchgehender Pfad mit Richtung, Kante, Dauer, Element-Marker und Label |
| `PathSegment` | Pfad mit Richtung, Kante, Dauer, Element-Marker, Sprungkombination und Label |
| `RinkDimensions` | Maße, Koordinaten, Punkte-/Kurvenprüfung |
Implementiert in `rinkplanner/src/core/rules/`:
@ -148,8 +148,7 @@ Die Prüfung ist bewusst getrennt von `Routine.validate()`:
Das Modell prüft Struktur und Pfade, der Validator prüft fachliche
Elementdaten. Die Oberfläche zeigt die Prüfliste und die Befunde in einem
Dialog; sie blockiert Speichern oder Export nicht. Noch nicht abgedeckt sind
Wiederholungs-/Kombinationsregeln, Dauerprüfung und die Begrenzung auf zwei
Features pro Fuß.
die Begrenzung auf zwei Features pro Fuß und Feature-Positionsregeln.
**D11 – Adult-Kategorien sind eigene saisonale Daten.**
`AdultCategoryRules` liest das IAFSC-Technical-Announcement als eigene
@ -160,6 +159,15 @@ und Kombinationsgrenzen. Das Announcement hat bei Konflikten Vorrang vor den
allgemeinen ISU-Regeln; deshalb bleiben Kategorie und Saison getrennte
Datenquellen.
**D12 – Sprungkombinationen sind strukturiert.**
`PathSegment.element_code` bleibt der erste Sprung; `combination_jumps` hält
bis zu zwei weitere Sprünge, `jump_kind` unterscheidet Einzelsprung,
Kombination und Folge. Der Base Value wird aus den Teilen summiert, die
Wiederholungs- und Kombinationsprüfung arbeitet auf denselben Teilen. Alte
Freitext-Kürzel wie `3Lz+2T` werden weiterhin als Fallback geparst; neue
Elemente nutzen die strukturierte Auswahl im Element-Dialog. Der Export
verwendet die zusammengesetzte Caption (`3Lz+2T`, `3Lz+2A+SEQ`).
## 4. View- und Controller-Grenzen
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
@ -377,10 +385,10 @@ Headless, ohne Editor und ohne Display:
Aktueller Stand:
- **Model:** 81 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
- **Model:** 93 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:** 166 Assertions für Katalog-Metadaten, Saison/Quelle,
- **Regelwerk:** 169 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.
- **Level-Features:** 51 Assertions für Feature-Metadaten, Schwellen,
@ -393,14 +401,15 @@ Aktueller Stand:
Prüfstatistik je Kategorie und die Basiswert-Summe.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Adult-Kategorien:** 67 Assertions für Metadaten, Gold/Silver/Bronze,
- **Adult-Kategorien:** 70 Assertions für Metadaten, Gold/Silver/Bronze,
Sprungerlaubnis, Level-Caps, Pflichtelemente, Wiederholungen, Kombinationen,
Dauer und unbekannte Kategorien.
- **Whiteboard:** 281 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 288 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. Kürzelauswahl, Standzeit, Base-Value- und
Feature-Hinweis, Feature-Menü, Verschieben, Löschen), Section-Verwaltung,
Feature-Hinweis, Feature-Menü, strukturierte Sprungkombinationen,
Verschieben, Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State, Prüfdialog mit
Punktschätzung und inline änderbaren Annahmen,

View file

@ -20,7 +20,7 @@ und Bronze.
| Wiederholungen | max. 2-mal pro gelistetem Sprung, inkl. Kombinations-Teile |
| Kombinationen | Anzahl, Folgen und max. Sprünge pro Kombination |
| Punktschätzung | Basiswert + PCS-Annahme + Sturzabzug |
| Tests | 1025 Assertions gesamt, `./tools/test.sh` grün |
| Tests | 1051 Assertions gesamt, `./tools/test.sh` grün |
## Datenupdate 2026/27
@ -109,8 +109,11 @@ Die Befunde sind Warnungen; Speichern und Export bleiben möglich.
- **Kombinationen/Folgen:** Anzahl, Folgenanzahl und maximale Sprünge pro
Kombination werden geprüft. Beispiel Gold: max. 2 Kombinationen oder
1 Kombination + 1 Folge, max. 3 Sprünge pro Kombination.
- **Freitext:** Kombinationen wie `3Lz+2T` werden für diese Prüfungen
geparst; eine strukturierte Kombinationsmodellierung folgt später.
- **Strukturiert:** `element_code` ist der erste Sprung,
`combination_jumps` enthält bis zu zwei weitere, `jump_kind` unterscheidet
Einzelsprung, Kombination und Folge. Base Value, Wiederholungen und
Kombinationsgrenzen arbeiten auf diesen Teilen. Alte Freitext-Codes bleiben
als Fallback lesbar.
## Punktschätzung
@ -144,12 +147,13 @@ Geschätzte Summe: 49,55
- **Katalog:** 166 Assertions (43 Familien, 2026/27-Werte, `ChSp`).
- **Level-Features:** 51 Assertions (15/5 Features, Windmills, Level-4-Liste).
- **Validierung:** 63 Assertions (Basiswerte 2026/27).
- **Adult:** 67 Assertions (Metadaten, Kategorien, Sprungerlaubnis,
Gold-Limits, gültige Gold-Kür, Wiederholungen, Kombinationen, Dauer und
unbekannte Kategorie).
- **Whiteboard:** 281 Assertions (Kategorie-Auswahl, Prüfdialog, Gold-Befunde,
Punktschätzung, inline änderbare Annahmen und Hilfe-Dialog).
- **Gesamt:** 1025 Assertions.
- **Adult:** 70 Assertions (Metadaten, Kategorien, Sprungerlaubnis,
Gold-Limits, gültige Gold-Kür, Wiederholungen, Kombinationen, Dauer,
strukturierte Kombinationen und unbekannte Kategorie).
- **Whiteboard:** 288 Assertions (Kategorie-Auswahl, Prüfdialog, Gold-Befunde,
Punktschätzung, inline änderbare Annahmen, Hilfe-Dialog und strukturierte
Sprungkombination).
- **Gesamt:** 1051 Assertions.
Visuell geprüft bei 1400 × 876 und 1024 × 768: Kategorie-Dropdown, Kopfzeile
`Kategorie: Gold · 2:50 ±10 s`, Basiswert und Gold-Befunde.

View file

@ -0,0 +1,83 @@
# Findings – Session: Strukturierte Sprungkombinationen (2026-10-31)
Ergänzung zu `docs/findings-2026-10-31-adult-2026-27.md`.
Sprungkombinationen waren bisher Freitext (`3Lz+2T`) und wurden für Prüfungen
geparst. Jetzt sind sie Teil des Modells und der Bedienung.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Modell | `element_code` = erster Sprung, `combination_jumps` = bis zu 2 weitere |
| Art | `jump_kind`: Einzelsprung, Kombination, Folge |
| Base Value | Summe der Base Values aller Kombinationsteile |
| Caption | `3Lz+2T`, Folge mit `+SEQ` |
| Bedienung | Sprungkombination im Element-Dialog |
| Prüfung | Wiederholungen/Kombinationen auf strukturierten Teilen |
| Legacy | Freitext-Codes bleiben als Fallback lesbar |
| Tests | 1051 Assertions gesamt, `./tools/test.sh` grün |
## Modell
`PathSegment` hat zusätzlich:
- `jump_kind` (`SOLO`, `COMBINATION`, `SEQUENCE`)
- `combination_jumps: PackedStringArray` (max. zwei zusätzliche Sprünge)
- `get_jump_parts()` liefert ersten Sprung plus Zusätze
- `set_jump_combination(kind, extras)` bereinigt und begrenzt die Teile
- `get_element_caption()` baut die zusammengesetzte Anzeige
Typwechsel oder Entfernen des Elements leert die Kombinationsfelder. Die
Validierung prüft:
- Kombination/Folge braucht mindestens einen weiteren Sprung
- Einzelsprung darf keine Zusätze haben
- maximal 3 Sprünge insgesamt
- leere oder nicht getrimmte Teilcodes sind Fehler
## Base Value und Prüfung
`ElementCatalog.get_segment_base_value()` summiert bei Sprüngen die Teile:
- `3Lz+2T` = 5,90 + 1,30 = 7,20
- `3Lz+2A+2T` = 5,90 + 3,30 + 1,30 = 10,50
Der Validator nutzt dieselben strukturierten Teile für:
- erlaubte Sprungtypen der Adult-Kategorie
- Wiederholungen (max. 2-mal pro gelistetem Sprung)
- Kombinations-/Folgenanzahl
- maximale Sprünge pro Kombination
Alte Freitext-Codes werden weiterhin geparst, damit bestehende Kürdateien
nicht brechen.
## Bedienung
Im Element-Dialog erscheint für Sprünge der Bereich **Sprungkombination**:
- Art: Einzelsprung, Kombination, Folge (SEQ)
- Zweiter und dritter Sprung als Auswahlboxen
- Bei Einzelsprung sind die Zusatzfelder ausgeblendet
- Base-Value-Hinweis aktualisiert sich live
- Level-/Feature-Regler sind bei Sprüngen ausgeblendet
Der Dialog passt bei 1024 × 768; bei Sprüngen werden die nicht relevanten
Level-/Feature-Bereiche ausgeblendet.
## Tests
- **Model:** 93 Assertions (Kombination, Folge, Grenzen, Typwechsel).
- **Regelwerk:** 169 Assertions (strukturierte und Legacy-Base-Values).
- **Adult:** 70 Assertions (strukturierte Wiederholungen/Kombinationen).
- **Whiteboard:** 288 Assertions (Dialog, Base-Value-Summe, Undo).
- **Gesamt:** 1051 Assertions.
Visuell geprüft bei 1400 × 876 und 1024 × 768 mit `3Lz+2T` und Base Value
7,20.
## Offen
- Migration alter Freitext-Kombinationen in die strukturierte Form
- Strukturierte Sprungfolgen mit automatischer Axel-Prüfung
- Kombinationen in Export und Timeline noch stärker als Einheit darstellen

View file

@ -187,7 +187,9 @@ möglich.
Der Element-Inspector bietet für das Kürzel eine Auswahlbox mit den Familien
des gewählten Elementtyps, z. B. `CCoSp — Change foot combination spin`. Für
Kombinationen und Varianten, die der Katalog nicht strukturiert abbildet
(`3Lz+2T`, `3Lzq`, `CCoSpV`), gibt es den Eintrag **„Freitext / Kombination …“**;
(`3Lzq`, `CCoSpV`, Altdaten), gibt es den Eintrag **„Freitext / Kombination …“**;
neue Sprungkombinationen werden dagegen strukturiert über erste Sprung plus
bis zu zwei weitere gewählt.
er blendet das bisherige Textfeld ein. Beim Übernehmen werden Level-Suffixe
weiterhin ins Level-Feld normalisiert.
@ -251,8 +253,8 @@ Der Prüfdialog zeigt eine **Punktschätzung** aus drei Teilen:
Die Annahmen sind über **ⓘ Annahmen ändern** direkt im Dialog einstellbar
(PCS-Durchschnitt 0–10, Stürze 0–20) und werden mit der Kür gespeichert.
GOE ist weiterhin nicht enthalten; Freitext- und Kombinationselemente ohne
Katalogwert werden als nicht gewertet markiert. Der Wert bleibt eine grobe
GOE ist weiterhin nicht enthalten; Freitext- und nicht katalogisierte
Kombinationselemente ohne Katalogwert werden als nicht gewertet markiert. Der Wert bleibt eine grobe
Schätzung, keine offizielle Punktzahl.
Der Link **ⓘ Was ist enthalten?** klappt die Grenzen der Basiswert-Summe auf;
@ -282,6 +284,6 @@ mit ausgeliefert.
## Nächste Ausbaustufen
- Max. zwei Features pro Fuß und Feature-Positionsregeln
- Strukturierte Sprungkombinationen/-folgen statt Freitext-Parsing
- Altdaten-Migration von Freitext-Kombinationen in die strukturierte Form
- GOE-Tabellen und `V`-/Unterrotations-Varianten
- Vorschlagsliste im Inspector direkt aus `suggest()`

View file

@ -32,6 +32,23 @@ Der Katalog wird jährlich ersetzt. Die Daten liegen unter
`rinkplanner/src/core/rules/data/` und tragen Saison, Quelle und
Gültigkeitsdatum.
## Sprungkombinationen
Sprungkombinationen und -folgen sind strukturiert:
- Das **Kürzel** ist der erste Sprung, z. B. `3Lz`.
- Über **Sprungkombination** im Element-Dialog werden Art und weitere Sprünge
gewählt:
- **Einzelsprung** – keine weiteren Sprünge
- **Kombination** – bis zu zwei weitere Sprünge, z. B. `3Lz+2T`
- **Folge (SEQ)** – bis zu zwei weitere Sprünge, Anzeige mit `+SEQ`
- Die Base Values der einzelnen Sprünge werden summiert.
- Wiederholungen und Kombinationsgrenzen werden anhand der strukturierten
Teile geprüft, nicht mehr aus dem Kürzeltext geraten.
- Alte Freitext-Kürzel wie `3Lz+2T` werden weiterhin als Fallback gelesen und
für Prüfung und Base Value geparst. Neu angelegte Elemente sollten die
strukturierte Auswahl verwenden.
## Level aus Features
Für Pirouetten und Schrittsequenzen gilt:
@ -139,8 +156,8 @@ Durchschnitt sollte zum aktuellen Leistungsstand passen, nicht zum Wunschziel.
## Grenzen
- Features und PCS sind Eingaben, keine Messungen aus der Zeichnung.
- Kombinationen werden für Prüfungen aus Freitext wie `3Lz+2T` geparst, noch
nicht strukturell modelliert.
- Alte Freitext-Kombinationen werden noch geparst; neue Elemente nutzen die
strukturierte Auswahl im Element-Dialog.
- Max. zwei Features pro Fuß und Feature-Positionsregeln sind offen.
- Adult-spezifische Sonderfälle außerhalb des Announcements 2026/27 sind
nicht abgebildet.

View file

@ -133,7 +133,8 @@ Voraussetzung für Phase 1.
- [ ] Max. zwei Features pro Fuß und Feature-Positionsregeln
- [x] Wiederholungsregeln (max. 2-mal pro gelistetem Sprung)
- [x] Kombinationsgrenzen (Anzahl, Folgen, max. Sprünge pro Kombination)
- [ ] Strukturierte Sprungkombinationen/-folgen statt Freitext-Parsing
- [x] Strukturierte Sprungkombinationen/-folgen (erster Sprung + bis zu zwei weitere)
- [ ] Altdaten-Migration von Freitext-Kombinationen in die strukturierte Form
- [x] Dauerprüfung gegen die Kategorie-Zeit
- [x] PCS und Sturzabzüge in der Punktschätzung (mit Annahmen)
- [x] In-App-Hilfe „Hilfe & Annahmen“ und `docs/manual.md`
@ -164,8 +165,8 @@ fachlichen Validierung angefasst.
Die Reihenfolge ist bewusst: native Builds, Datenaustausch und Element-Marker
sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – Katalog 2026/27,
Level-Features, Elementvalidierung, Adult-Kategorien, Dauer und
Wiederholungs-/Kombinationsgrenzen stehen; als Nächstes folgen strukturierte
Kombinationen, Feature-Grenzen pro Fuß und GOE. Sync-Komfort und
Wiederholungs-/Kombinationsgrenzen stehen; als Nächstes folgen
Feature-Grenzen pro Fuß und GOE. 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.