rinkplanner/docs/findings-2026-11-10-step-sequence-gruppen.md
torsten a1d399f575 feat: Geschwister einer Step Sequence türkis hervorheben
Wird ein Segment aus einer Elementgruppe ausgewählt, umrandet der Canvas die
übrigen Mitglieder türkis; das gewählte Segment behält den gelben Halo. Damit
ist auf einen Blick sichtbar, welche Teilstrecken zur Sequenz gehören.

- RinkCanvas.get_group_member_segment_ids() liefert die Geschwister
  (gleiche element_group_id, ohne Auswahl, ohne bereits mit ausgewählte)
- Zeichnung unter dem gelben Halo, gestrichelt bei Rückwärtssegmenten
- Tests in run_canvas_tests.gd, Sichtprüfung über
  tests/manual/capture_group_highlight.gd
- Findings zu den Step-Sequence-Gruppen aktualisiert
2026-11-12 06:16:57 +01:00

85 lines
4.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 – 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.