feat: Element-Marker mit Inspector und Export

- PathSegment traegt element_type/element_code/element_level (D3)
- Element-Werkzeug setzt Punktmarker per Tipp; Inspector fuer Typ,
  Kuerzel und Level; Marker per Griff verschiebbar
- Darstellung auf Canvas und in Praesentation inkl. Ghosting,
  Labels-Schalter blendet Kuerzel aus
- Sequenzbereiche sind getaggte Segmente, Tag ueber Inspector setzbar
- SVG/PNG-Export mit Typform und Kuerzel
- Timing-Leiste blendet irrelevante Regler im Element-Modus aus
- Griff-Drag beginnt erst mit der ersten Bewegung (kein Undo bei Tipp)
- Tests: 577 Assertions gruen; Findings, Architektur und Roadmap aktuell
This commit is contained in:
torsten 2026-10-30 23:38:57 +01:00
parent 7c6c8fc3d4
commit 5968272691
15 changed files with 1429 additions and 67 deletions

View file

@ -3,7 +3,8 @@
Stand: 2026-10-30
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
Übergeordnete Reihenfolge: `docs/roadmap.md`
Letzte Session: `docs/findings-2026-10-30.md`
Letzte Session: `docs/findings-2026-10-30-element-marker.md`
(Session davor: `docs/findings-2026-10-30.md`)
## 1. Leitentscheidung
@ -52,7 +53,7 @@ Implementiert in `rinkplanner/src/core/model/`:
| :--- | :--- |
| `Routine` | Wurzelaggregat, Validierung, Gesamtdauer/-länge, Section-Lookup |
| `RoutineSection` | chronologischer Block, Ghosting-Einheit, Segmentliste |
| `PathSegment` | durchgehender Pfad mit Richtung, Kante, Dauer, Element-Marker, Label |
| `PathSegment` | durchgehender Pfad mit Richtung, Kante, Dauer, Element-Marker und Label |
| `RinkDimensions` | Maße, Koordinaten, Punkte-/Kurvenprüfung |
### Entscheidungen
@ -69,7 +70,12 @@ Dot-Simulation deterministisch und vermeidet widersprüchliche Metadaten.
**D3 – Marker sind gültige Segmente.**
Ein Segment mit Länge braucht eine positive Dauer. Ein reiner Element-Marker
(Länge 0, z. B. Sprungpunkt) darf Dauer 0 haben und wird über `is_marker()`
erkannt.
erkannt. Seit der Element-Marker-Session trägt das Segment zusätzlich
`element_type` (Sprung, Pirouette, Sequenz), `element_code` (Kürzel, max.
24 Zeichen) und `element_level` (0 = Base, 1–4). Ein Punktmarker ist ein
Segment mit einer Ein-Punkt-Kurve, `is_element_marker()` ist wahr. Eine
Sequenz als Bereich bleibt ein normales Segment mit Länge und wird nur
getaggt; `element_id` bleibt für die spätere Regelwerk-Referenz reserviert.
**D4 – Koordinaten in Metern, Ursprung in der Rinkmitte.**
+X verläuft entlang der langen Achse (−30 m … +30 m), +Y entlang der kurzen
@ -80,7 +86,8 @@ sind damit auflösungsunabhängig.
Jedes Segment kann ein `label` tragen (max. 40 Zeichen, getrimmt). Es wird im
aktiven Abschnitt neben dem Segmentmittelpunkt gezeichnet, in Präsentation und
Export für alle sichtbaren Abschnitte. Der globale Schalter „Labels“ blendet
alle Beschriftungen in der Ansicht aus; Exporte enthalten sie immer.
alle Beschriftungen in der Ansicht aus; Exporte enthalten sie immer. Das gilt
auch für Elementkürzel; die Marker-Form selbst bleibt beim Ausblenden sichtbar.
**D6 – IDs sind Pflicht und global eindeutig.**
`routine_id`, `section_id` und `segment_id` werden validiert. Die ID-Erzeugung
@ -100,10 +107,10 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
- **Controller** übersetzt Touch-/Maus-Eingaben in Modelloperationen
(Segment anlegen, Kante umschalten, Section wechseln, Playback steuern).
- **Zeichenwerkzeuge:** `WhiteboardController` hält eine Draft-Routine mit
einer Section. Die Toolbar bietet Auswählen, Linie, Bogen links und Bogen
rechts; Richtung (vorwärts/rückwärts) und Kante (innen/außen) gelten für das
nächste Segment. Neue Segmente starten mit dem gewählten Timing-Profil
(Default Adult Gold, 4,3 m/s); Züge über die Bande werden per
einer Section. Die Toolbar bietet Auswählen, Linie, Bogen links, Bogen
rechts und Element; Richtung (vorwärts/rückwärts) und Kante (innen/außen)
gelten für das nächste Segment. Neue Segmente starten mit dem gewählten
Timing-Profil (Default Adult Gold, 4,3 m/s); Züge über die Bande werden per
`clamp_point()` auf die Eisfläche begrenzt.
- **Bogen-Vorlage:** `ArcGeometry` erzeugt einen Kreisbogen mit 40 % der
Sehnenlänge als Pfeilhöhe und liefert eine gesampelte `Curve2D`-Polyline.
@ -116,11 +123,22 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
Bogen-Griff ändert Tiefe und Seite. Richtung und Kante lassen sich über die
Toolbar auch nachträglich ändern; die Buttons spiegeln dabei den Zustand
des ausgewählten Segments. Ohne Auswahl gelten sie für das nächste Segment.
Ein Griff-Drag beginnt mit der ersten Bewegung; ein bloßer Tipp auf einen
Griff erzeugt keinen Undo-Eintrag.
„Segment löschen“ in der Statusleiste ist nur bei Auswahl aktiv; zusätzlich
löschen Entf und Backspace das ausgewählte Segment. Ghost-Sections sind
nicht interaktiv. Die Bogenparameter werden als `template`,
`arc_depth_ratio` und `arc_bulge_left` am `PathSegment` gespeichert, damit
die Kurve nach dem Editieren neu aufgebaut werden kann.
- **Element-Marker:** Das Werkzeug „Element“ setzt per Tipp einen Punktmarker
(Ein-Punkt-Kurve, Dauer 0) des in der Timing-Leiste gewählten Typs
(Sprung/Pirouette/Sequenz). Der Marker wird direkt ausgewählt; der Button
„Element“ öffnet den Inspector für Typ, Kürzel und Level. Im
Auswahlmodus lässt sich der Marker über seinen Griff verschieben. Sequenz-
Bereiche entstehen, indem ein gezeichnetes Segment über den Inspector
getaggt wird. Marker zählen nicht zur Playback-Zeit. Die Timing-Details
(Dauer/Tempo/Profil) werden beim Setzen und für Punktmarker ausgeblendet,
damit die Leiste auch im Landscape kompakt bleibt.
- **Section-Verwaltung:** Ein Panel rechts zeigt die chronologische
Abschnittsliste. Neue Sections werden angelegt, umbenannt, gelöscht und
hoch-/runtergeschoben; `sequence_order` wird nach jeder Änderung
@ -217,7 +235,9 @@ ggf. eines nach `touchend` (300-ms-Guard).
- **SVG** wird direkt aus dem Modell serialisiert (Kurven als Pfade,
Section-Nummern, Legende, Rink), nicht aus einem Screenshot. Damit bleibt
der Export auflösungsunabhängig.
der Export auflösungsunabhängig. Element-Marker werden als eigene Gruppe
(`class="element-marker"`) mit Typform und Kürzel gezeichnet, Sequenz-
Bereiche tragen ihr Kürzel wie ein Label.
- **PNG** entsteht über eine eigene Export-Szene in einem `SubViewport`
(2560 × 1600) mit Titel, Section-Nummern und Legende.
- **Umfang:** Gesamte Kür oder aktiver Abschnitt; Dateien landen unter
@ -227,7 +247,8 @@ ggf. eines nach `touchend` (300-ms-Guard).
- **Persistenz** erfolgt lokal als `.tres`-Ressourcen unter
`user://routines/`. `Routine.schema_version` (aktuell 2) schützt vor
inkompatiblen neueren Dateien; Schema-1-Dateien werden beim Laden migriert
und behalten ihre bisherige Dauer. Benannte Kürläufe werden über das Datei-Menü gespeichert
und behalten ihre bisherige Dauer. Die Elementfelder kamen additiv mit
Defaults hinzu, deshalb bleibt das Schema bei 2. Benannte Kürläufe werden über das Datei-Menü gespeichert
und geladen; der Öffnen-Dialog nutzt 48-px-Buttons statt einer kleinen
Dateiliste.
- **Autosave** schreibt nach 1,5 s Inaktivität nach `user://autosave.tres`
@ -259,14 +280,15 @@ Headless, ohne Editor und ohne Display:
Aktueller Stand:
- **Model:** 55 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, Schema-Version, Section-Aggregation und
Routine-Validierung.
- **Model:** 74 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, Element-Marker samt Kürzel-/Level-Grenzen,
Schema-Version, Section-Aggregation und Routine-Validierung.
- **Canvas:** 90 Assertions für Meter→Pixel-Mapping, Fit/Zoom/Pan,
Rink-Kontur und die reine Bogen-Geometrie.
- **Whiteboard:** 149 Assertions für Controller-Verdrahtung, Segmenterzeugung,
- **Whiteboard:** 193 Assertions für Controller-Verdrahtung, Segmenterzeugung,
Linien-/Bogenpfade, Klemmen an der Bande, Auswahl, Griff- und
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Section-Verwaltung,
Richtungs-/Kanten-Bearbeitung, Segmentlöschung, Element-Marker (Setzen,
Typwechsel, Inspector, Verschieben, Löschen), Section-Verwaltung,
Ghosting-Zustand, Segment-Labels inklusive Dialog und Sichtbarkeits-Schalter,
Speichern/Laden, Schema-Prüfung, Dirty-State,
Navigationsmodus und den Maus-Drag-Pfad.
@ -278,10 +300,12 @@ Aktueller Stand:
Button-Verdrahtung, Scrubbing und Geschwindigkeitswechsel.
- **Timing:** 41 Assertions für Dauer-/Tempo-Kopplung, Level-Presets,
Kalibrierung, Undo, Persistenz und Schema-1-Migration.
- **Export:** 19 Assertions für SVG-Struktur, Titel-Escaping, Segment-Labels, Section-Filter,
Segmentfarben/-strichelung und das Schreiben der Exportdatei.
- **Touch/Tablet:** 21 Assertions für Ein-Finger-Zeichnen, Zwei-Finger-Pan,
Pinch-Zoom, Tipp-Auswahl, Griff-Bearbeitung, Abbruch bei zweitem Finger,
- **Export:** 26 Assertions für SVG-Struktur, Titel-Escaping, Segment-Labels,
Element-Marker, Section-Filter, Segmentfarben/-strichelung und das Schreiben
der Exportdatei.
- **Touch/Tablet:** 28 Assertions für Ein-Finger-Zeichnen, Zwei-Finger-Pan,
Pinch-Zoom, Tipp-Auswahl, Griff-Bearbeitung, Element-Marker per Tipp,
Abbruch bei zweitem Finger,
Unterdrückung synthetischer Maus-Events aus Chrome sowie das responsive
Leistenlayout bei 1024 und 1400 px.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
@ -301,9 +325,10 @@ Viewport-Screenshot; sie ersetzen die headless Tests nicht.
1. **Eckenradius:** 8,5 m ist als Default gesetzt. ISU- und IIHF-Regelwerk
können abweichen; der Wert gehört später in die Regelkonfiguration.
2. **Element-Instanzen:** Aktuell verweist `PathSegment.element_id` auf ein
Element. Ob Sprünge/Pirouetten eigene Instanzen mit Position und Zeit
brauchen, wird mit dem Regelmodell entschieden.
2. **Element-Instanzen:** Punktmarker sind seit der Element-Session
`PathSegment` mit Ein-Punkt-Kurve (D3). `element_id` bleibt für die
Referenz auf einen künftigen Regelkatalog frei; ob Level/Features aus dem
Katalog statt am Segment hängen, entscheidet das Regelmodell.
3. **History-Grenzen:** 50 Snapshots ohne Coalescing; Undo zurück zum
gespeicherten Stand setzt den Dirty-Marker nicht automatisch zurück. Für
lange Sessions ist zu prüfen, ob das reicht.