rinkplanner/docs/findings-2026-11-10-step-sequence-gruppen.md
torsten 55e7b163b5 feat: add step-sequence groups, freehand editing and element PDF
- group contiguous path segments into one sequence element with shared group IDs
- resolve elements centrally and score/adult-count groups once
- add freehand tool with point editing, smoothing and RDP reduction
- render one PDF table row and badge per element instead of per segment
- turn playback start/pause/reset into icon buttons
- add multi-select grouping and extend tests/documentation
2026-11-10 15:50:03 +01:00

62 lines
3.2 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.
## 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.