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
This commit is contained in:
parent
e9d520459e
commit
55e7b163b5
33 changed files with 4623 additions and 345 deletions
62
docs/findings-2026-11-10-step-sequence-gruppen.md
Normal file
62
docs/findings-2026-11-10-step-sequence-gruppen.md
Normal file
|
|
@ -0,0 +1,62 @@
|
|||
# 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue