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
85 lines
4.3 KiB
Markdown
85 lines
4.3 KiB
Markdown
# 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.
|