rinkplanner/docs/findings-2026-11-10-step-sequence-gruppen.md

63 lines
3.2 KiB
Markdown
Raw Normal View History

# Findings – Step Sequences als Elementgruppe (2026-11-10)
## Ergebnis
Schrittsequenzen können jetzt als **ein** Element über mehrere gezeichnete
Teilstrecken laufen. Das ist Option A aus dem Modell-Brainstorm: Die
Elementdaten bleiben am Lead-Segment, die Mitglieder verweisen über eine
gemeinsame `element_group_id` darauf.
| Ziel | Ergebnis |
| :--- | :--- |
| Modell | `PathSegment.element_group_id`; Lead trägt Typ, Kürzel, Level, Features |
| Auflösung | `RoutineSection.get_elements()` liefert `ResolvedElement`-Sichten |
| Wertung | Validator, Adult-Regeln und Basiswert zählen eine Gruppe einmal |
| Darstellung | ein Label pro Gruppe am Gruppenmittelpunkt (Canvas und SVG) |
| PDF | eine Tabellenzeile und ein Rink-Badge pro Element, nicht pro Segment |
| Bedienung | Sequenz-Zeichenmodus und nachträgliches Gruppieren per Mehrfachauswahl |
| Persistenz | Schema 5, additives `element_group_id` |
| Tests | `./tools/test.sh` grün |
## Modell
- `element_group_id` ist auf allen Mitgliedern gleich. Genau ein Segment ist
Lead (`element_type != NONE`); die übrigen sind normale Pfadsegmente ohne
Elementdaten.
- Gruppen sind zusammenhängend und liegen in einer Section. Mehrere Leads,
Lücken, Null-Längen-Mitglieder und Nicht-Sequenz-Typen werden abgelehnt.
- `ResolvedElement` kapselt Lead, Mitglieder, Dauer, Caption, Länge und den
Mittelpunkt der Gruppe. Die Sicht ist ephemär; ein erneutes Auflösen liefert
ein neues Objekt mit derselben `element_id`.
- Alte Dateien ohne Gruppen-ID bleiben gültig: Jedes getaggte Segment ist ein
Einzelelement. Schema 4 → 5 ist rein additiv.
## Bedienung
- Das Sequenz-Symbol startet den Zeichenmodus. Linie/Bogen/Freeline zeichnen
die Teilstrecken; die erste wird Lead. Erneutes Drücken, Esc oder ein
anderes Werkzeug beendet den Bereich.
- Eine bestehende Sequenz am Abschnittsende lässt sich fortsetzen: Mitglied
auswählen, Sequenz-Symbol drücken, weiterzeichnen.
- Ein beliebiges Mitglied öffnet im Element-Dialog immer die Gruppe.
- Lead löschen: Das nächste Mitglied übernimmt die Elementdaten.
- „Kein Element“ löst die Gruppe auf; die Pfadsegmente bleiben erhalten.
- Neue Bereiche starten mit `StSq` und Level Base.
- **Mehrfachauswahl:** Der Knopf im Abschnittsbereich schaltet auf
addierendes Antippen; auf dem Desktop geht auch Shift/Cmd/Ctrl-Klick.
„Sequenz gruppieren (N)“ fasst eine zusammenhängende Auswahl in einem
Undo-Schritt zusammen. Lücken, Marker und bestehende Elemente blockieren
die Aktion.
## Offene Punkte
1. **Teilen/Zusammenführen:** Eine Gruppe kann derzeit nur über Löschen oder
„Kein Element“ verändert werden; ein explizites Teilen fehlt.
2. **Gruppen-Hervorhebung:** Der Canvas markiert beim Auswählen nur das
gewählte Segment, nicht die gesamte Gruppe.
3. **Einzelne Sequenz-Tags zusammenführen:** Bereits separat getaggte
Sequenzen müssen vor dem Gruppieren über „Kein Element“ gelöst werden;
ein automatisches Zusammenführen mit Metadaten-Konfliktlösung fehlt.
4. **Punktmarker:** Sprung/Pirouette bleiben Einzelelemente mit einem
Ankersegment. Eine vollständige `RoutineElement`-Ablage (Option B) ist
weiterhin der langfristige Umbau.