rinkplanner/docs/findings-2026-10-31-sprungkombinationen.md
torsten 05dee8da2b feat: Legacy-Migration, Axel-Pflicht und Kombinations-Export
- Alte Freitext-Kombinationen werden beim Laden und Uebernehmen in die
  strukturierte Form migriert
- Sprungfolgen verlangen einen Axel als 2. oder 3. Sprung
- Dialoghinweis fuer Folgen (Axel vorhanden/fehlt)
- Export zeigt eine Kombination als einen Marker mit voller Caption
- 100 Model-, 169 Rules-, 66 Validation-, 70 Adult-, 297 Whiteboard-
  und 31 Export-Assertions (1075 gesamt)
- Doku und Findings aktualisiert
2026-10-31 11:59:13 +01:00

91 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 werden beim Laden/Übernehmen migriert |
| Folge | Axel als 2./3. Sprung verpflichtend, Dialoghinweis |
| Export | Kombination erscheint als ein Marker mit voller Caption |
| Tests | 1075 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:** 100 Assertions (Kombination, Folge, Grenzen, Typwechsel,
Legacy-Migration, Axel-Pflicht).
- **Regelwerk:** 169 Assertions (strukturierte und Legacy-Base-Values).
- **Adult:** 70 Assertions (strukturierte Wiederholungen/Kombinationen).
- **Whiteboard:** 297 Assertions (Dialog, Base-Value-Summe, Undo,
Legacy-Migration, Folge-Hinweis).
- **Export:** 31 Assertions (Kombination als ein Marker inkl. Caption).
- **Gesamt:** 1075 Assertions.
Visuell geprüft bei 1400 × 876 und 1024 × 768 mit `3Lz+2T` und Base Value
7,20.
## Offen
- Nicht parsebare Legacy-Sonderfälle bleiben Freitext und werden von der
Validierung gemeldet.
- Die Axel-Prüfung bewertet den Code, nicht die tatsächliche Verbindung im
Laufweg.
- Die Timeline zeigt weiterhin einen Marker für das gesamte Element; eine
eigene Kombinationsdarstellung kann folgen.