feat: Segment-Timing mit Profilen und Kalibrierung hinzufügen

- Timing-Leiste mit gekoppelter Dauer-/Tempo-Bearbeitung
- Level-Presets Adult Bronze bis Elite, Default Adult Gold 4,3 m/s
- Kalibrierdialog Strecke/Zeit und Standard-Reset
- PathSegment speichert Geschwindigkeit oder Dauer als maßgebliche Größe
- Schema-Version 2 mit Migration alter Dateien
- Tests auf 400 Assertions erweitert
This commit is contained in:
torsten 2026-10-30 08:48:12 +01:00
parent d163b01fa5
commit 43da04b3cc
13 changed files with 819 additions and 44 deletions

View file

@ -95,8 +95,9 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
- **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. Die Dauer wird mit 6 m/s aus der Länge abgeleitet, Züge
über die Bande werden per `clamp_point()` auf die Eisfläche begrenzt.
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.
Liegt der Bogen außerhalb des Rinks, wird die Pfeilhöhe schrittweise
@ -134,11 +135,16 @@ eine Abkürzung. So kann die UI Fehler konkret anzeigen.
sodass die Bewegung entlang des Pfades und die Körperrichtung getrennt
sichtbar sind. Während des Playbacks wird die aktuelle Section hervorgehoben,
ohne die Bearbeitungs-Section zu wechseln. Steuerung: Play/Pause, Reset,
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Die Dauer kommt aus den
Segmentdauern (aktuell 6 m/s Platzhalter). Nicht verbundene Segmente führen
zu einem Sprung des Markers an den Start des nächsten Segments.
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Die Dauer kommt aus dem
Segment-Timing (Default Adult Gold, 4,3 m/s). Nicht verbundene Segmente
führen zu einem Sprung des Markers an den Start des nächsten Segments.
- **Geschwindigkeitsannahmen:** Die belastbaren Referenzwerte, Level-Profile
und Kalibrierung stehen in `docs/speed-assumptions.md`.
- **Segment-Timing:** Die Timing-Leiste zeigt Dauer und Tempo des ausgewählten
Segments. Beide Werte sind gekoppelt; `PathSegment.timing_mode` legt fest,
welche Größe bei Geometrieänderungen erhalten bleibt. Level-Presets
(Adult Bronze bis Elite), `±`-Schritte, „Standard“ (Adult Gold, 4,3 m/s) und
ein Kalibrierdialog (Strecke/Zeit → m/s) sind umgesetzt.
- **Darstellung:** vorwärts durchgezogen, rückwärts gestrichelt, außen rot,
innen blau. Inaktive Sections werden mit 20 % Deckkraft geghostet.
- **Ghosting** ist reine View-Logik: pro Section ein eigener Layer,
@ -173,8 +179,9 @@ standardmäßig bleibt es aus.
- **PDF** ist nicht nativ in Godot. Erste Stufe: Browser-Druck aus SVG;
eine echte PDF-Ausgabe ist ein separates Arbeitspaket.
- **Persistenz** erfolgt lokal als `.tres`-Ressourcen unter
`user://routines/`. `Routine.schema_version` schützt vor inkompatiblen
neueren Dateien. Benannte Kürläufe werden über das Datei-Menü gespeichert
`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 geladen; der Öffnen-Dialog nutzt 48-px-Buttons statt einer kleinen
Dateiliste.
- **Autosave** schreibt nach 1,5 s Inaktivität nach `user://autosave.tres`
@ -194,8 +201,8 @@ Headless, ohne Editor und ohne Display:
Aktueller Stand:
- **Model:** 46 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Template-Metadaten, Schema-Version, Section-Aggregation und
- **Model:** 55 Assertions für Rink-Geometrie, Clamping, Segment-Timing,
Timing-Modi, Template-Metadaten, 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.
@ -210,6 +217,8 @@ Aktueller Stand:
- **Playback:** 38 Assertions für Dauer/Timeline, Vorwärts-/Rückwärts-
Blickrichtung, Section-Hervorhebung, Play/Pause/Reset inklusive
Button-Verdrahtung, Scrubbing und Geschwindigkeitswechsel.
- **Timing:** 41 Assertions für Dauer-/Tempo-Kopplung, Level-Presets,
Kalibrierung, Undo, Persistenz und Schema-1-Migration.
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
end-to-end geprüft.
@ -249,9 +258,8 @@ Viewport-Screenshot; sie ersetzen die headless Tests nicht.
10. **Snapshot-Clone:** `_clone_routine()` kopiert die Modellfelder manuell.
Neue Felder am Modell müssen dort ergänzt werden, sonst fehlen sie in
Undo/Redo-Snapshots.
11. **Segment-Timing:** Die Dauer wird weiterhin mit 6 m/s aus der Länge
abgeleitet. Eine direkte Dauer-/Geschwindigkeitsbearbeitung pro Segment
ist der nächste Timing-Schritt; die Profile stehen in
`docs/speed-assumptions.md`.
11. **Segment-Timing:** Dauer/Tempo, Presets, Kalibrierung und Migration sind
umgesetzt. Offen sind Beschleunigung/Verzögerung innerhalb eines Segments
und eine noch genauere Profilpflege aus eigenen Messungen.
12. **Playback-Komfort:** Loop, Scrubbing während des Abspielens und
Audio-Synchronisation sind bewusst noch nicht enthalten.

View file

@ -30,18 +30,18 @@ Voraussetzung für Phase 1.
- [x] Geschwindigkeits-Arbeitsannahmen in `docs/speed-assumptions.md`
- [x] Headless-Tests und visuelle Smoke-Tests
### Nächster Schritt: Segment-Timing
### Erledigt: Segment-Timing
- [ ] Dauer oder Geschwindigkeit pro Segment editieren
- [ ] Gekoppelte Anzeige: Dauer ↔ Geschwindigkeit
- [ ] Level-Presets aus `docs/speed-assumptions.md`
- [x] Dauer oder Geschwindigkeit pro Segment editieren
- [x] Gekoppelte Anzeige: Dauer ↔ Geschwindigkeit
- [x] Level-Presets aus `docs/speed-assumptions.md`
(Adult Bronze/Silver/Gold, Masters, Elite)
- [ ] Preset „Auf Standard zurücksetzen“ pro Segment
- [ ] Kalibrierung: bekannte Strecke, Zeit messen, Geschwindigkeit berechnen
- [ ] Timing in Playback, Timeline, Undo/Redo und Speichern/Laden integrieren
- [ ] Aktuellen 6-m/s-Platzhalter durch bewusste Profile ersetzen
- [x] Preset „Standard“ pro Segment (Adult Gold, 4,3 m/s)
- [x] Kalibrierung: bekannte Strecke, Zeit messen, Geschwindigkeit berechnen
- [x] Timing in Playback, Timeline, Undo/Redo und Speichern/Laden integriert
- [x] 6-m/s-Platzhalter durch bewusste Profile ersetzt
### Danach: Export
### Nächster Schritt: Export
- [ ] PNG in hoher Auflösung für Tablet-Weitergabe
- [ ] SVG direkt aus dem Modell (Kurven, Sections, Legende, Rink)

View file

@ -62,7 +62,7 @@ werden.
| Masters / fortgeschritten | 4,5–5,5 m/s | 16,2–19,8 km/h |
| Elite / Wettkampf | 5,0–7,0 m/s | 18,0–25,2 km/h |
Vorgeschlagene Preset-Defaults:
Umgesetzte Preset-Defaults:
| Profil | Default |
| :--- | ---: |
@ -101,25 +101,27 @@ Orientierung für Rinkplanung und Playback:
## 6. Verwendung in Rinkplanner
- Der aktuelle Code-Default von **6 m/s** ist ein Platzhalter und entspricht
eher einem schnellen Elite-/Wettkampf-Profil. Er ist zu hoch für Adult-
Bronze/Silver und für technische Abschnitte.
- Geplant sind Level-Presets gemäß Abschnitt 3.
- Jedes Segment soll Dauer oder Geschwindigkeit individuell speichern können.
- Der Playback berechnet die Dauer aus `Strecke / Geschwindigkeit` bzw. nutzt
die gespeicherte Segmentdauer.
- Der Code-Default ist **Adult Gold mit 4,3 m/s**. Die Level-Presets aus
Abschnitt 3 sind in der Timing-Leiste umgesetzt.
- Die Presets gelten für das ausgewählte Segment; ohne Auswahl legen sie das
Tempo für neue Segmente fest.
- Jedes Segment speichert entweder die **Geschwindigkeit** oder die **Dauer**
als maßgebliche Größe. Die jeweils andere wird daraus berechnet.
- Bei einer Geometrieänderung bleibt die maßgebliche Größe erhalten:
- Geschwindigkeitsmodus: Dauer wird neu berechnet.
- Dauer-Modus: Geschwindigkeit wird neu berechnet.
- Der Playback nutzt die gespeicherte Segmentdauer.
- Innerhalb eines Segments wird weiterhin eine konstante Geschwindigkeit
angenommen. Beschleunigung und Verzögerung sind ein späterer Ausbauschritt.
## 7. Einfache Kalibrierung
## 7. Kalibrierung im Tool
1. Eine bekannte Strecke auf dem Eis abstecken oder im Plan zeichnen,
z. B. 20 m geradeaus.
2. Skater diese Strecke mit dem gewünschten Tempo fahren lassen.
3. Zeit mit Stoppuhr oder Video messen.
4. `Geschwindigkeit = Strecke / Zeit` berechnen.
5. Drei Durchläufe messen und den Median verwenden.
6. Den Wert als Segment- oder Profilgeschwindigkeit eintragen.
1. Segment auswählen.
2. „Kalibrieren“ öffnen.
3. Gemessene Strecke und Zeit eingeben.
4. Das Tool berechnet `Geschwindigkeit = Strecke / Zeit` und setzt sie am
Segment.
5. Für belastbare Werte drei Durchläufe messen und den Median verwenden.
Beispiel: 20 m in 4,4 s → 4,55 m/s (16,4 km/h).