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:
parent
7c6c8fc3d4
commit
5968272691
15 changed files with 1429 additions and 67 deletions
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue