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

86 lines
4.3 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.
## Gruppen-Hervorhebung (2026-11-12)
Beim Auswählen eines Gruppenmitglieds zeichnet der Canvas die übrigen
Mitglieder mit einem türkisen Halo (`GROUP_HALO_COLOR`, Breite
`_segment_width() + 5`), das gewählte Segment behält den gelben Halo. Die
Hilfsfunktion `RinkCanvas.get_group_member_segment_ids()` liefert dafür die
Geschwister: gleiche `element_group_id`, ohne das gewählte Segment und ohne
bereits mit ausgewählte Segmente (die bleiben gelb). Einzelelemente ohne
Gruppen-ID bekommen keinen zusätzlichen Halo.
Nur der Canvas ist betroffen; SVG-/PNG-Export und Präsentationsmodus bleiben
unverändert. Sichtprüfung:
`tests/manual/capture_group_highlight.gd`.
## 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.~~ Erledigt am 2026-11-12:
Die übrigen Mitglieder werden türkis umrandet (siehe unten).
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.
## Nachtrag (2026-11-11)
Im Nutzertest erwies sich der Sequenz-Zeichenmodus als schwer zugänglich.
Er wurde entfernt; Schrittsequenzen entstehen jetzt ausschließlich über
**Mehrfachauswahl** und das **Sequenz-Symbol** (geschweifte Klammer mit
Plus) in der Werkzeugleiste. Es ersetzt an derselben Stelle das alte
Sequenz-Werkzeug und nennt die Auswahlgröße im Tooltip.