rinkplanner/docs/roadmap.md
torsten 0613ffca3e feat: ISU-Level-Features und Level-Berechnung
- ElementFeature/ElementLevelRules mit Daten aus ISU Communication 2701
- 14 Pirouetten- und 4 Schrittsequenz-Features inkl. Pflicht- und
  Level-4-Regeln
- PathSegment.element_features mit Duplikaten fuer schwierige Variationen
- Feature-Menue und abgeleiteter Level-Hinweis im Element-Inspector,
  Auswahl undo-faehig
- 47 neue Level-Assertions, Whiteboard-Tests auf 228 erweitert (833 gesamt)
- Doku: isu-rules, Findings, Architektur und Roadmap aktualisiert
2026-10-31 09:21:03 +01:00

176 lines
8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Rinkplanner – Roadmap
Stand: 2026-10-31 (ISU-Katalog und Level-Features; 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-30-element-marker.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 2025/26 mit 24 Sprüngen, 16 Pirouetten 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 (14 Features) und Schrittsequenzen (4 Features),
Level-Berechnung und Auswahl im Inspector; Details in `docs/isu-rules.md`
- [ ] Validierung von Elementen und Kombinationen
- [ ] Programmweite Feature-Grenzen (`once_per_program`, max. 2 pro Fuß)
- [ ] Optional: Kürzelvorschläge im Inspector 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 und
Level-Features stehen, als Nächstes folgt die Validierung. 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