rinkplanner/docs/findings-2026-10-31-sprungkombinationen.md
torsten 8f1cf1bf44 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
2026-10-31 11:55:18 +01:00

83 lines
2.9 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 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