rinkplanner/docs/roadmap.md

153 lines
6.5 KiB
Markdown
Raw Normal View History

# Rinkplanner – Roadmap
Stand: 2026-10-30 (nach der Tablet-/Build-/Sync-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`.
## Leitprinzip
Das 2D-Whiteboard ist das Herzstück und muss ohne 3D-Renderer vollständig
funktionieren. Der 3D-Teil ist eine spätere Präsentationsschicht und keine
Voraussetzung für Phase 1.
## Phase 1 – MVP
### Erledigt
- [x] Datenmodell: `Routine`, `RoutineSection`, `PathSegment`,
`RinkDimensions`, Template-Metadaten, Schema-Version
- [x] 2D-Rink-Canvas mit Meter→Pixel-Transform, Pan/Zoom und Touch-Pinch
- [x] Linien zeichnen, Richtung und Kante umschalten
- [x] Bogen-/Lobe-Vorlage mit automatischer Abflachung an der Bande
- [x] Auswahl, Start-/Endpunkt-Griffe, Bogen-Griff für Tiefe und Seite
- [x] Richtung/Kante auch nachträglich am ausgewählten Segment ändern
- [x] Segment löschen, Undo/Redo mit Snapshot-Historie
- [x] Sections anlegen, umbenennen, löschen, sortieren
- [x] Ghosting inaktiver Sections mit 20 % Deckkraft
- [x] Speichern/Laden als `.tres`, Schema-Prüfung, Autosave und Restore
- [x] Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und
Geschwindigkeit 0,25×–2,0×
- [x] Geschwindigkeits-Arbeitsannahmen in `docs/speed-assumptions.md`
- [x] Headless-Tests und visuelle Smoke-Tests
### Erledigt: Segment-Timing
- [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)
- [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
### Erledigt: Export
- [x] PNG in hoher Auflösung für Tablet-Weitergabe (2560 × 1600)
- [x] SVG direkt aus dem Modell (Kurven, Sections, Legende, Rink)
- [x] Export der aktiven Section und des gesamten Programms
- [x] SVG als Grundlage für Browser-Druck (PDF)
- [x] Export-Tests: Geometrie, Section-Reihenfolge, Sichtbarkeit
- [x] Export-Dialog mit Dateiname, Format und Umfang
### Erledigt: Segment-Labels
- [x] Freitext-Label pro Segment (max. 40 Zeichen), Undo/Redo und Persistenz
- [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
### Erledigt: Builds
- [x] Linux-, Windows- und macOS-Preset plus `tools/export_*.sh`
- [x] Android-Toolchain-Setup (`tools/setup_android.sh`), Debug-Keystore
- [x] Signiertes Android-Debug-APK (arm64-v8a, Landscape, minSdk 24)
- [x] Web-Export entfernt; Zielplattformen sind nur noch Desktop + Android
- [x] Test auf echtem Tablet (Galaxy Tab S9+): Installation per adb, Start,
Zeichnen, Labels, Beenden über die Zurück-Geste
- [x] App-Icon (Silhouette, dunkle und invertierte Variante) inkl.
Android-Launcher-Icons, reproduzierbar über `tools/make_app_icons.py`
- [x] Windows-EXE mit Icon und Versionsinformationen (rcedit über portables
Wine, `tools/setup_windows_export.sh`)
- [ ] Release-Keystore für ein verteilbares APK
- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig)
### Erledigt: Touch-/Tablet-Härtung
- [x] Touch-Ziele auf 56 px erhöht, Guard gegen emulierte Maus-Events
- [x] UI-Skalierung in CSS-Pixeln (DPR-korrekt), kompakte Leiste < 1280 px
- [x] Kleine Displays (1024 px) geprüft
- [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest)
- [x] Auf dem Zielgerät verifiziert (340 dpi, 2800 × 1752, Landscape)
### Erledigt: Kontosync (Desktop ↔ Tablet)
- [x] Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort,
Verzeichnis, FTPS, Zertifikatsprüfung), Zugangsdaten unter `user://`
- [x] Manueller Sync: `.tres` je Kür laden/hochladen, Sync-Stand lokal
- [x] Konflikte als Kopien mit Server-Zeitstempel behalten
- [x] Fortschritt und Zusammenfassung in der Oberfläche
- [x] FTP/FTPS-Client ohne externe Bibliothek
- [ ] Automatischer Sync im Hintergrund (später)
- [ ] Konflikt-Zusammenführung in der Oberfläche (später)
### Nächste Session: 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
### Danach: Sync-Komfort (optional, wenn Zeit)
- [ ] Automatischer Sync beim Start/Beenden
- [ ] Konflikt-Zusammenführung in der Oberfläche
- [ ] Optional: Löschweitergabe mit Bestätigung
- [ ] Optional: echter Kontosync über HTTP/WebDAV statt FTP
### Danach: ISU-Regelwerk
- [ ] Elementkatalog als strukturierte Daten (JSON/Resources)
- [ ] Base Values, Level und Features
- [ ] Validierung von Elementen und Kombinationen
- [ ] Regelversionen pflegbar halten
### Danach: Weitere fachliche Erweiterungen
- [ ] Weitere Templates (z. B. Acht, Dreier)
- [ ] 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.
## Querschnittsaufgaben
- [ ] Tests bei jedem Feature erweitern; `./tools/test.sh` bleibt grün
- [ ] MCP gezielt für Editor-/Runtime-Verifikation nutzen, sobald der Editor
mit dem richtigen Projektpfad läuft
- [ ] Persistenz-Backups und Dateiverwaltung prüfen
- [ ] Architektur- und Geschwindigkeitsdokumentation aktuell halten
## Phase 2 – 3D-Präsentation
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells
- [ ] NLA-/Animations-Tracks aus Blender
- [ ] Blender-MCP und Godot-Editor-MCP für den Asset-Workflow
- [ ] Klare Trennung: Phase 1 bleibt ohne 3D-Abhängigkeiten lauffähig
## Bewusst nicht jetzt
- Audio-Synchronisation (laut Definition in Phase 1 zurückgestellt)
- Native PDF-Ausgabe
- Vollständiges ISU-Regelwerk vor dem stabilen Planungs-Workflow
- 3D-Produktionsreife