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

4.3 KiB
Raw Blame 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.