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.

View file

@ -0,0 +1,103 @@
# Findings – Session: Element-Marker (2026-10-30)
Ergänzung zu `docs/findings-2026-10-30.md` (Tablet-/Build-/Sync-Session).
Diese Session hat die erste offene Phase-1-Lücke geschlossen: Sprungpunkte,
Pirouettenzentren und Sequenzbereiche sind jetzt Teil des Modells, der
Bedienung und des Exports.
## Ergebnis
| Ziel | Ergebnis |
| :--- | :--- |
| Marker-Modell | `element_type`, `element_code`, `element_level` am Segment |
| Platzieren | Werkzeug „Element“, ein Tipp setzt einen Punktmarker |
| Bearbeiten | Inspector (Typ, Kürzel, Level), Verschieben per Griff |
| Darstellung | Typform + Kürzel auf Canvas, Ghosting und Präsentation |
| Export | SVG-Gruppe `element-marker`, PNG über die Export-Szene |
| Tests | 577 Assertions, `./tools/test.sh` grün |
## Modellentscheidung
Die Roadmap ließ „eigenes Markerobjekt oder Segment“ offen. Umgesetzt ist die
bestehende Entscheidung D3, erweitert:
- Ein Punktmarker ist ein `PathSegment` mit **Ein-Punkt-Kurve**. `is_marker()`
bleibt die geometrische Prüfung (Länge 0), `is_element_marker()` verlangt
zusätzlich einen Elementtyp.
- `element_type`: `NONE`, `JUMP`, `SPIN`, `SEQUENCE`.
- `element_code`: Freitext-Kürzel, getrimmt, max. 24 Zeichen.
- `element_level`: 0 = Base, 1–4; nur für Pirouetten und Sequenzen im Kürzel.
- `element_id` bleibt unangetastet und ist für die spätere Referenz auf den
ISU-Elementkatalog reserviert.
- Eine **Sequenz als Bereich** ist kein Punktmarker, sondern ein normales
Segment mit Länge, das über den Inspector getaggt wird.
Validierung: Level außerhalb 0–4, zu lange Kürzel und ein Kürzel ohne
Elementtyp sind Fehler. `set_element()` trimmt, kürzt und klemmt die Werte;
`set_element(NONE, …)` leert Kürzel und Level.
## Bedienung
- Neues Werkzeug „Element“ in der Werkzeugliste. Ein Tipp innerhalb der Bande
setzt einen Marker des zuletzt gewählten Typs; der Marker wird direkt
ausgewählt. Tipps außerhalb der Eisfläche pannen wie gewohnt.
- Die Timing-Leiste zeigt im Element-Modus nur die relevanten Regler
(Label, Element, Typ, Labels). Dauer-/Tempo-/Profilregler werden
ausgeblendet, ebenso bei Auswahl eines Punktmarkers. Dadurch bleibt die
Leiste bei 1024, 1317 und 1400 px auf einer Zeile.
- Typwechsel über das Optionsfeld wirkt auf die nächste Platzierung und – bei
Auswahl – sofort auf das markierte Segment (mit Undo).
- Inspector-Dialog „Element“: Typ (inkl. „Kein Element“), Kürzel, Level.
„Kein Element“ entfernt bei einem Sequenzbereich nur den Tag; ein reiner
Punktmarker wird gelöscht, weil er ohne Element keine Bedeutung hat.
- Im Auswahlmodus hat ein Marker genau einen Griff; Ziehen verschiebt den
Punkt und wird als ein Undo-Schritt verbucht.
## Darstellung
- Sprung: Raute (bernstein), Pirouette: Kreis (violett), Sequenz: Quadrat
(grün), jeweils mit dunkler Kontur; Auswahl erhält einen hellen Halo.
- Kürzel steht in einer dunklen Pille über der Form, z. B. `3Lz` oder
`CCoSp4 L3`. Der Schalter „Labels“ blendet die Kürzel aus; die Form bleibt
sichtbar, damit Marker nicht unsichtbar werden.
- Sequenzbereiche zeigen ihr Kürzel wie ein Label am Segmentmittelpunkt, wenn
kein Freitext-Label gesetzt ist.
- Ghost-Sections zeichnen Marker mit 20 % Deckkraft, aber ohne Kürzel.
- Marker erzeugen keine Playback-Zeit; die Timeline ignoriert Dauer 0 bereits.
## Export
- SVG: pro Marker eine Gruppe `<g class="element-marker" data-element="…">`
mit Typform und Kürzel (weiße Kontur über `paint-order="stroke"`), gefiltert
nach dem gewählten Abschnitt.
- PNG: läuft über die vorhandene Export-Szene und zeigt Marker, Kürzel und
Sequenz-Tags automatisch mit.
- Ein Abschnittsexport enthält nur die Marker des gewählten Abschnitts.
## Tests
Neu bzw. erweitert:
- **Model (74):** Punktmarker, Typen, Kürzel-Trimmen/-Kürzen, Level-Klemmen,
Caption-Bildung, Tag-löschen, Kürzel ohne Typ als Fehler.
- **Whiteboard (193):** Setzen per Maus, Typwechsel, Inspector-Dialog,
Griff-Drag, Undo/Redo, Löschen über „Kein Element“, Tagging und Entfernen
von Sequenzbereichen, Persistenz der Elementfelder, Marker zählen nicht zur
Playback-Zeit.
- **Export (26):** Marker-Gruppen, Kürzel mit Level, Form, Abschnittsfilter.
- **Touch (28):** Ein Tipp setzt einen Marker und selektiert ihn.
Visuell geprüft über `tests/manual/capture_elements.gd` (normal, `dialog`,
`place`) bei 1024 × 768, 1317 × 824 und 1400 × 876 sowie im PNG-Export.
## Offene Punkte
1. **Elementkatalog:** Kürzel sind Freitext. Vorschläge, Base Values und
Feature-Prüfung kommen mit dem ISU-Regelwerk; `element_id` ist der
Anknüpfungspunkt.
2. **Sequenzbereiche:** Sie werden getaggt, aber (noch) nicht anders als
normale Pfade gezeichnet. Eine eigene Bereichsmarkierung kann folgen.
3. **Marker-Overlap:** Bei dicht beieinanderliegenden Markern überlappen die
Kürzel-Pillen. Eine Kollisionsvermeidung ist bewusst offen.
4. **Level bei Sprüngen:** Das Modell erlaubt Level 0–4 für alle Typen; die
Caption zeigt Level nur bei Pirouetten und Sequenzen.

View file

@ -1,9 +1,9 @@
# Rinkplanner – Roadmap
Stand: 2026-10-30 (nach der Tablet-/Build-/Sync-Session)
Stand: 2026-10-30 (nach der Element-Marker-Session)
Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen
nur bewusst und nach Rücksprache. Erkenntnisse der letzten Session:
`docs/findings-2026-10-30.md`.
`docs/findings-2026-10-30-element-marker.md`.
## Leitprinzip
@ -57,7 +57,7 @@ Voraussetzung für Phase 1.
- [x] Label-Dialog für das ausgewählte Segment, leeren entfernt das Label
- [x] Globaler Schalter „Labels“ blendet alle Beschriftungen in der Ansicht aus
- [x] Labels im Canvas (auch Präsentation) sowie in SVG- und PNG-Export
- [ ] Optional: Label-Vorlagen (Elementkürzel) und Auswahl aus einer Liste
- [ ] Optional: Label-Vorlagen aus dem Elementkatalog (siehe ISU-Regelwerk)
### Erledigt: Builds
@ -93,21 +93,23 @@ Voraussetzung für Phase 1.
- [ ] Automatischer Sync im Hintergrund (später)
- [ ] Konflikt-Zusammenführung in der Oberfläche (später)
### Nächste Session: Element-Marker
### Erledigt: Element-Marker
- [ ] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren
- [ ] Elementtyp, Level und Marker-Darstellung
- [ ] Element-Inspector und Auswahl auf dem Tablet
- [ ] Element-Marker im Export (SVG/PNG)
- [ ] Entscheidung: Marker als eigenes Modellobjekt (Position, Typ, Level)
oder als Segment mit `element_id`/`label`
- [ ] Tests für Marker-Modell, Interaktion und Export erweitern
- [ ] Labels optional aus Elementkürzeln vorschlagen
- [x] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren
- [x] Elementtyp, Level und Marker-Darstellung
- [x] Element-Inspector und Auswahl auf dem Tablet
- [x] Element-Marker im Export (SVG/PNG)
- [x] Entscheidung: Marker als Segment mit Ein-Punkt-Kurve und
`element_type`/`element_code`/`element_level` (D3), Sequenzbereiche als
getaggte Segmente
- [x] Tests für Marker-Modell, Interaktion und Export erweitern
- [ ] Optional: Elementkatalog mit Kürzelvorschlägen (Teil des ISU-Regelwerks)
### Danach: Sync-Komfort (optional, wenn Zeit)
### Nächste Session: Sync-Komfort und Layout-Härtung
- [ ] Automatischer Sync beim Start/Beenden
- [ ] Konflikt-Zusammenführung in der Oberfläche
- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig)
- [ ] Optional: Löschweitergabe mit Bestätigung
- [ ] Optional: echter Kontosync über HTTP/WebDAV statt FTP
@ -124,10 +126,10 @@ Voraussetzung für Phase 1.
- [ ] Optional: Segment-Verknüpfung beim Verschieben von Endpunkten
- [ ] Optional: Section-Timeline mit Zeitproportionen
Die Reihenfolge ist bewusst: native Builds und Datenaustausch sind erledigt,
jetzt kommen die sichtbaren Element-Marker, dann die vollständige ISU-Logik.
Sync-Komfort und Layout-Härtung laufen parallel nur, wenn sie den
Planungs-Workflow nicht blockieren.
Die Reihenfolge ist bewusst: native Builds, Datenaustausch und Element-Marker
sind erledigt, jetzt folgen Sync-Komfort und Layout-Härtung, danach die
vollständige ISU-Logik. Die Element-Marker machen den Planungs-Workflow
vollständig; Sync-Komfort darf ihn nicht blockieren.
## Querschnittsaufgaben