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

8 KiB
Raw Blame History

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

  • 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 aus dem Elementkatalog (siehe ISU-Regelwerk)

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+): Installation per adb, Start, Zeichnen, Labels, Beenden über die Zurück-Geste
  • App-Icon (Silhouette, dunkle und invertierte Variante) inkl. Android-Launcher-Icons, reproduzierbar über tools/make_app_icons.py
  • 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

  • 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)
  • Auf dem Zielgerät verifiziert (340 dpi, 2800 × 1752, Landscape)

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)

Erledigt: 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 Segment mit Ein-Punkt-Kurve und element_type/element_code/element_level (D3), Sequenzbereiche als getaggte Segmente
  • Standzeit je Typ (Sprung 0,7 s, Pirouette 8 s) mit Inspector-Override
  • Pirouetten-Dot rotiert während der Standzeit
  • Tests für Marker-Modell, Interaktion und Export erweitern
  • Optional: Elementkatalog mit Kürzelvorschlägen (Teil des ISU-Regelwerks)

In Arbeit: ISU-Regelwerk

  • 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
  • Base Values und Level je Elementfamilie
  • Regelversionen pflegbar halten (saisonale JSON-Datei mit Quelle und Gültigkeitsdatum)
  • Base-Value-Hinweis im Element-Inspector
  • 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