rinkplanner/docs/roadmap.md
torsten f553785710 feat: manuellen FTP-Sync zwischen Desktop und Tablet
- FTP/FTPS-Client (USER/PASS, AUTH TLS + PROT P, EPSV/PASV, MLSD, SIZE,
  RETR, STOR, DELE, MKD, RNFR/RNTO) ohne externe Bibliothek
- Sync-Vergleich pro Kürdatei mit lokalem Sync-Stand: hochladen,
  herunterladen, überspringen; beidseitige Änderungen bleiben als Kopie
  mit Server-Zeitstempel erhalten, die lokale Fassung wird nie verworfen
- Sync-Einstellungen (Host, Port, Benutzer, Passwort, Verzeichnis, FTPS,
  Zertifikatsprüfung) unter user://sync.cfg, nicht im Repository
- Sync läuft im Thread, Fortschritt in der Statusleiste, Zusammenfassung
  im Dialog; geöffnete Kür wird nur unverändert neu geladen
- Atomare Ersetzung über .part/.bak, Uploads über .uploading + Umbenennen
- Tests für Vergleichsregeln, Konfliktnamen, PASV/EPSV/MDTM, Sync-Stand
  und Einstellungs-Dialog; zusätzlich E2E gegen den echten FTP-Server
- docs/sync.md mit Einrichtung, Verhalten und Grenzen
2026-10-30 11:03:18 +01:00

5.4 KiB
Raw Blame History

Rinkplanner – Roadmap

Stand: 2026-10-30 Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen nur bewusst und nach Rücksprache.

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

  • Datenmodell: Routine, RoutineSection, PathSegment, RinkDimensions, Template-Metadaten, Schema-Version
  • 2D-Rink-Canvas mit Meter→Pixel-Transform, Pan/Zoom und Touch-Pinch
  • Linien zeichnen, Richtung und Kante umschalten
  • Bogen-/Lobe-Vorlage mit automatischer Abflachung an der Bande
  • Auswahl, Start-/Endpunkt-Griffe, Bogen-Griff für Tiefe und Seite
  • Richtung/Kante auch nachträglich am ausgewählten Segment ändern
  • Segment löschen, Undo/Redo mit Snapshot-Historie
  • Sections anlegen, umbenennen, löschen, sortieren
  • Ghosting inaktiver Sections mit 20 % Deckkraft
  • Speichern/Laden als .tres, Schema-Prüfung, Autosave und Restore
  • Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und Geschwindigkeit 0,25×–2,0×
  • Geschwindigkeits-Arbeitsannahmen in docs/speed-assumptions.md
  • Headless-Tests und visuelle Smoke-Tests

Erledigt: Segment-Timing

  • Dauer oder Geschwindigkeit pro Segment editieren
  • Gekoppelte Anzeige: Dauer ↔ Geschwindigkeit
  • Level-Presets aus docs/speed-assumptions.md (Adult Bronze/Silver/Gold, Masters, Elite)
  • Preset „Standard“ pro Segment (Adult Gold, 4,3 m/s)
  • Kalibrierung: bekannte Strecke, Zeit messen, Geschwindigkeit berechnen
  • Timing in Playback, Timeline, Undo/Redo und Speichern/Laden integriert
  • 6-m/s-Platzhalter durch bewusste Profile ersetzt

Erledigt: Export

  • PNG in hoher Auflösung für Tablet-Weitergabe (2560 × 1600)
  • SVG direkt aus dem Modell (Kurven, Sections, Legende, Rink)
  • Export der aktiven Section und des gesamten Programms
  • SVG als Grundlage für Browser-Druck (PDF)
  • Export-Tests: Geometrie, Section-Reihenfolge, Sichtbarkeit
  • Export-Dialog mit Dateiname, Format und Umfang

Erledigt: Segment-Labels

  • Freitext-Label pro Segment (max. 40 Zeichen), Undo/Redo und Persistenz
  • Label-Dialog für das ausgewählte Segment, leeren entfernt das Label
  • Globaler Schalter „Labels“ blendet alle Beschriftungen in der Ansicht aus
  • Labels im Canvas (auch Präsentation) sowie in SVG- und PNG-Export
  • Optional: Label-Vorlagen (Elementkürzel) und Auswahl aus einer Liste

Erledigt: Builds

  • Linux-, Windows- und macOS-Preset plus tools/export_*.sh
  • Android-Toolchain-Setup (tools/setup_android.sh), Debug-Keystore
  • Signiertes Android-Debug-APK (arm64-v8a, Landscape, minSdk 24)
  • Web-Export entfernt; Zielplattformen sind nur noch Desktop + Android
  • Test auf echtem Tablet (Galaxy Tab S9+)
  • Hochformat-Layout (nur prüfen, falls benötigt)
  • Release-Keystore für ein verteilbares APK

Erledigt: Touch-/Tablet-Härtung

  • Touch-Ziele auf 56 px erhöht, Guard gegen emulierte Maus-Events
  • UI-Skalierung in CSS-Pixeln (DPR-korrekt), kompakte Leiste < 1280 px
  • Kleine Displays (1024 px) geprüft
  • Performance bei vielen Segmenten und Sections (Cache + Stresstest)

Erledigt: Kontosync (Desktop ↔ Tablet)

  • Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort, Verzeichnis, FTPS, Zertifikatsprüfung), Zugangsdaten unter user://
  • Manueller Sync: .tres je Kür laden/hochladen, Sync-Stand lokal
  • Konflikte als Kopien mit Server-Zeitstempel behalten
  • Fortschritt und Zusammenfassung in der Oberfläche
  • FTP/FTPS-Client ohne externe Bibliothek
  • Automatischer Sync im Hintergrund (später)
  • Konflikt-Zusammenführung in der Oberfläche (später)

Danach: 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)

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: erst native Builds und Datenaustausch, dann sichtbare Element-Marker, dann die vollständige ISU-Logik.

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