rinkplanner/docs/roadmap.md

191 lines
8.9 KiB
Markdown
Raw Normal View History

# Rinkplanner – Roadmap
Stand: 2026-10-31 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; Sync-Komfort und UI-Refactoring zurückgestellt)
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-31-adult-2026-27.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 aus dem Elementkatalog (siehe ISU-Regelwerk)
### 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)
### Erledigt: Element-Marker
- [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] Standzeit je Typ (Sprung 0,7 s, Pirouette 8 s) mit Inspector-Override
- [x] Pirouetten-Dot rotiert während der Standzeit
- [x] Tests für Marker-Modell, Interaktion und Export erweitern
- [ ] Optional: Elementkatalog mit Kürzelvorschlägen (Teil des ISU-Regelwerks)
### In Arbeit: ISU-Regelwerk
- [x] Elementkatalog als strukturierte Daten (JSON/Resources)
– Saison 2026/27 mit 24 Sprüngen, 17 Pirouetten (inkl. `ChSp`) und
2 Sequenzen; Format und Pflege in `docs/isu-rules.md`
- [x] Base Values und Level je Elementfamilie
- [x] Regelversionen pflegbar halten (saisonale JSON-Datei mit Quelle und
Gültigkeitsdatum)
- [x] Base-Value-Hinweis im Element-Inspector
- [x] Features und Kriterien für die Level-Vergabe
– Pirouetten (15 Features) und Schrittsequenzen (5 Features),
Level-Berechnung und Auswahl im Inspector; Details in `docs/isu-rules.md`
- [x] Level automatisch aus Features (Pirouetten/Sequenzen), Sprünge Base,
`ChSq`/`ChSp` Level 1; manueller Level nur für Freitext-Codes
- [x] Validierung von Elementen (Katalog, Level, Features, Level-Abgleich)
mit Prüfdialog in der Statusleiste
- [x] Basiswert-Schätzung im Prüfdialog (Summe ohne GOE, 1,1-Faktor,
Komponenten und Abzüge)
- [x] Programmweite Einmal-Features (`once_per_program`) als Warnung
- [x] Update auf ISU 2026/27 (Communication 2786/2788) inkl. `ChSp1`
- [x] Adult-Kategorien Bronze/Silver/Gold (plus Masters/Elite) mit Dauer,
Elementlimits, erlaubten Sprüngen, Level-Caps und Pflichtelementen
- [x] Kategorie-Auswahl in der Statusleiste und Kategorie-Prüfungen
- [ ] Max. zwei Features pro Fuß und Feature-Positionsregeln
- [ ] Wiederholungs- und Kombinationsregeln
- [ ] Dauerprüfung gegen die Kategorie-Zeit
- [ ] PCS und Sturzabzüge in der Punktschätzung
- [ ] Optional: Suchfeld/Autovervollständigung aus `suggest()`
- [ ] Optional: GOE-Tabellen sowie `V`-/Unterrotationsvarianten
### Danach: Weitere fachliche Erweiterungen
- [ ] Weitere Templates (z. B. Acht, Dreier)
- [ ] Optional: Segment-Verknüpfung beim Verschieben von Endpunkten
- [ ] Optional: Section-Timeline mit Zeitproportionen
### Zurückgestellt bis nach dem Proof-of-Concept
Wir sind bewusst noch im PoC. Der bestehende FTP-Sync und die aktuelle
Oberfläche reichen für Tests; Komfort und Optik werden erst nach der
fachlichen Validierung angefasst.
- [ ] Automatischer Sync beim Start/Beenden
- [ ] Konflikt-Zusammenführung in der Oberfläche
- [ ] Löschweitergabe mit Bestätigung
- [ ] Sync über einen selbst gehosteten PHP-Webserver statt FTP
(Ziel: maximaler Datenaustausch-Komfort, z. B. HTTP/JSON-API)
- [ ] Hochformat-, Multi-Window- und DeX-Layout (obere Leiste umbruchfähig)
- [ ] Visuelles UI-Refactoring (z. B. Buttons statt Comboboxen) inklusive
Übernahme des Feedbacks der Tester
Die Reihenfolge ist bewusst: native Builds, Datenaustausch und Element-Marker
sind erledigt. Im PoC läuft jetzt das ISU-Regelwerk – Katalog 2026/27,
Level-Features, Elementvalidierung und Adult-Kategorien stehen; als Nächstes
folgen Wiederholungs-/Kombinationsregeln und die Dauerprüfung. Sync-Komfort
und UI-Refactoring sind zurückgestellt, weil der bestehende Stand für Tests
genügt und die endgültige Sync-Architektur (PHP-Webserver) sowie das
UI-Feedback der Tester ohnehin noch ausstehen.
## 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
- Sync-Komfort und visuelles UI-Refactoring (erst nach dem PoC)
- 3D-Produktionsreife