rinkplanner/docs/roadmap.md

17 KiB
Raw Blame History

Rinkplanner – Roadmap

Stand: 2026-11-11 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; JSON-Dateiformat, Export-Smoke-Test und Quality-Meilenstein ergänzt; Sport-Theme mit kompakteren Leisten, UI-Gliederung und mehr Rink-Fläche auf dem Tablet als Quality-Ziel aufgenommen; Sequenz-Erstellung auf Gruppieren umgestellt; Sync-Konflikte automatisch nach Inhalt-Zeitstempel aufgelöst, alter Kopienzoo aufräumbar sowie Küren zentral verwaltbar und umbenennbar; Cloud-Sync vorerst nur mit Dropbox) Diese Reihenfolge ist die verbindliche Arbeitsgrundlage für Phase 1. Änderungen nur bewusst und nach Rücksprache. Letzte Erkenntnisse: docs/findings-2026-10-31-arm-gewichte.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
  • Freeline-Werkzeug für frei gezeichnete, mehrpunktige Laufwege
  • Freeline-Zwischenpunkte bearbeiten, glätten und per RDP reduzieren
  • Playback-Steuerung als Icon-Knöpfe (Start/Pause/Reset)
  • 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 JSON, Schema-Prüfung, atomare Saves, Autosave und Session-Restore (Legacy-.tres lesbar)
  • Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und Geschwindigkeit 0,25×–2,0×
  • Musikstück (MP3/OGG/WAV; M4A/AAC auf macOS automatisch nach WAV konvertiert) je Kür laden; Wiedergabe, Scrubbing und Geschwindigkeit laufen synchron zum Läufer; der Cloud-Sync überträgt die Musikdatei mit der Kür
  • Timeline-Labels: Kür-Labels schräg auf der Timeline, eigene Labels per Klick anlegen, bearbeiten und löschen
  • Abschnittswechsel setzt Abspielfigur und Timeline an den Abschnittsanfang
  • 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)
  • Native PDF-Ausgabe der Laufwege mit Zeit (Übersicht + Abschnittsseiten, Vektorpfade, Tabellen, Fortsetzungsseiten)
  • Export-Abschluss mit absolutem Pfad sowie „Öffnen“, „Ordner anzeigen“ und „Pfad kopieren“; optional direkt im Standardprogramm öffnen
  • 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, aktuell Dropbox)

  • Sync-Einstellungen in der App (Anbieter, Konto verbinden/trennen), Refresh-Tokens unter user://
  • Manueller Sync: .json je Kür laden/hochladen (Legacy-.tres weiterhin), Sync-Stand lokal
  • Konflikte automatisch nach Inhalt-Zeitstempel auflösen; die ältere Fassung bleibt im Konfliktarchiv (user://conflicts/)
  • Küren verwalten: gezieltes Löschen (lokal und optional Cloud) mit Bereinigung des Sync-Stands
  • Küren umbenennen: Dateiname und Titel, optional auch in der Cloud
  • Geführter Aufräumdialog für alte (Server …)-/(Lokal …)-Kopien
  • Fortschritt und Zusammenfassung in der Oberfläche
  • Google-Drive- und Dropbox-Backend ohne externe Bibliothek
  • Pro-Nutzer-OAuth (Google Device Flow, Dropbox PKCE)
  • Automatischer Sync im Hintergrund (später)
  • Manuelles Zusammenführen mit der archivierten Fassung (später)

Aktuell ist Dropbox der produktive Sync-Anbieter (auch auf der Webseite). Das Google-Drive-Backend ist im Code vorhanden, aber die OAuth-App ist nicht veröffentlicht. Google Drive und OneDrive stehen unter „Später: Weitere Cloud-Anbieter“.

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)

Erledigt: Step-Sequence-Gruppen (Option A)

  • element_group_id am Segment, Lead trägt die Elementdaten
  • RoutineSection.get_elements() / ResolvedElement als Auflösungsschicht
  • Validator, Adult-Regeln und Basiswert zählen eine Gruppe einmal
  • Sequenz erstellen über Mehrfachauswahl und das Sequenz-Symbol in der Werkzeugleiste; der frühere Zeichenmodus entfällt (in Tests verworfen)
  • Ein Gruppenlabel in Canvas und SVG
  • Schema 5 mit additivem element_group_id
  • Mehrfachauswahl und nachträgliches Gruppieren in der UI
  • PDF-Zeile pro Element statt pro Segment
  • Gruppe teilen/zusammenführen

In Arbeit: ISU-Regelwerk

  • 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
  • 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 (15 Features) und Schrittsequenzen (5 Features), Level-Berechnung und Auswahl im Inspector; Details in docs/isu-rules.md
  • Level automatisch aus Features (Pirouetten/Sequenzen), Sprünge Base, ChSq/ChSp Level 1; manueller Level nur für Freitext-Codes
  • Validierung von Elementen (Katalog, Level, Features, Level-Abgleich) mit Prüfdialog in der Statusleiste
  • Basiswert-Schätzung im Prüfdialog (Summe ohne GOE, 1,1-Faktor, Komponenten und Abzüge)
  • Programmweite Einmal-Features (once_per_program) als Warnung
  • Update auf ISU 2026/27 (Communication 2786/2788) inkl. ChSp1
  • Adult-Kategorien Bronze/Silver/Gold (plus Masters/Elite) mit Dauer, Elementlimits, erlaubten Sprüngen, Level-Caps und Pflichtelementen
  • Kategorie-Auswahl in der Statusleiste und Kategorie-Prüfungen
  • Max. zwei Features pro Fuß und Feature-Positionsregeln
  • Wiederholungsregeln (max. 2-mal pro gelistetem Sprung)
  • Kombinationsgrenzen (Anzahl, Folgen, max. Sprünge pro Kombination)
  • Strukturierte Sprungkombinationen/-folgen (erster Sprung + bis zu zwei weitere)
  • Altdaten-Migration von Freitext-Kombinationen in die strukturierte Form
  • Axel-Pflicht für Sprungfolgen (Modell, Validator und Dialoghinweis)
  • Dauerprüfung gegen die Kategorie-Zeit
  • PCS und Sturzabzüge in der Punktschätzung (mit Annahmen)
  • In-App-Hilfe „Hilfe & Annahmen“ und docs/manual.md
  • Optional: Suchfeld/Autovervollständigung aus suggest()
  • Optional: GOE-Tabellen sowie V-/Unterrotationsvarianten (2026-11-01 vorerst zurückgestellt)

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 Cloud-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
  • Manuelles Zusammenführen mit der archivierten Fassung
  • Löschweitergabe für einzelne Küren mit Bestätigung (Küren verwalten)
  • Optional: Sync-Ordner pro Anbieter getrennt konfigurieren
  • 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, Adult-Kategorien, Dauer und Wiederholungs-/Kombinationsgrenzen stehen; als Nächstes folgen Feature-Grenzen pro Fuß. GOE und Varianten sind vorerst zurückgestellt. 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.

Später: Weitere Cloud-Anbieter

Für den PoC reicht Dropbox. Weitere Anbieter werden erst nach der fachlichen Validierung angefasst; die Anbieter-Abstraktion (RemoteStore) bleibt dafür erhalten.

  • Google Drive aktivieren: OAuth-Zustimmungsbildschirm veröffentlichen (Branding, Datenschutz-URL, Produktionsstatus). Backend und Device-Flow sind fertig; bis dahin nicht in App und Webseite bewerben.
  • OneDrive ergänzen: Microsoft-Graph-Backend mit Files.ReadWrite.AppFolder (nur Apps/<Name>) und Device-Code-Flow. App-Registrierung in Entra ohne Review oder Publishing; persönliche Microsoft-Konten, kein Admin-Consent.

Quality-Meilenstein

Stand: 2026-11-03. Ziel: den PoC release- und wartbar machen, ohne die fachliche Roadmap zu blockieren. Die Sofortmaßnahmen aus der Projekt-Durchsicht sind umgesetzt; die folgenden Punkte sind die nächsten Schritte.

Erledigt: Sofortmaßnahmen (2026-11-03)

  • Export startet ohne Autoload-/Startfehler; der Runtime-Bridge-Autoload ist im Export enthalten, Editor-Addons bleiben draußen.
  • 3D-Skater in Desktop-/Android-Exporten: GLB plus Quelltexturen sind eingeschlossen; tools/check_export.sh prüft den headless Start, das Fehlen von Testskripten und die Texturen.
  • Kürdateien als JSON (RoutineFile, rinkplanner.routine, Limits, Schema-Prüfung). Legacy-.tres bleibt lesbar, wird aber vor ResourceLoader.load per Whitelist geprüft (kein eingebettetes GDScript, nur Modellskripte).
  • Atomare Saves über Temp + .bak, Überschreibschutz für „Speichern unter“ und Export, letzter Pfad in user://session.cfg; Autosave wird beim Start nur bei neueren Änderungen übernommen und bleibt am letzten Dateipfad.
  • Entf/Backspace löscht nicht mehr durch offene Dialoge (modal guard).

Als Nächstes

  • WhiteboardController in Services/Panels zerlegen: Datei-I/O, Sync, Playback, Validierung, Element-Inspector, Section-Liste. Ziel: < 1.500 Zeilen pro Datei, keine 100 %-Lookups in einem Skript.
  • Gemeinsamer Test-Harness (oder gdUnit4), Timeout pro Testlauf, Coverage; CI auf dem Gitea-/Forgejo-Remote mit tools/test.sh und tools/check_export.sh.
  • Saison datengetrieben: Saison-Auswahl/Default aus data/, 2025/26 auswählbar machen oder entfernen; Regelstand im UI anzeigen.
  • Android-Export teilen: Share-Intent/SAF statt nur user://exports/.
  • Ctrl+S/Ctrl+O/Ctrl+N und sichtbarer Speicherstatus (auch ohne Fenstertitel auf Android).

Danach

  • UI in logische Bereiche gliedern (Werkzeuge, Eigenschaften, Timeline) und Screen Estate zugunsten der Rink-Fläche maximieren – vor allem auf dem Tablet mehr Rink-Fläche durch kompakte, einklappbare Leisten und Panels.
  • Sport-Theme (dunkel, Cyan-Akzente, kräftige Typografie) und vertikal kompaktere Leisten für mehr Rink-Fläche
  • Zentrale UI-Texte (tr()/CSV), Light-Theme und skalierbare Schriftgrößen; kompakte Labels nicht mehr im Controller.
  • Canvas: Culling/Dirty-Regions, Kurven-Cache auch für Pan/Zoom; Perf-Test mit realistischem Budget (< 16 ms bei 480 Segmenten).
  • Doku konsolidieren: 18 findings-*.md nach docs/notes/ oder ins Archiv; Architektur/Manual als aktuelle Quellen; Docstrings und Assertion-Zahlen pflegen.
  • Altlasten entfernen: Flieger.obj (nur Prototyp), alte .godot-Importe, eingefrorenen Prototyp; .gitattributes um Binärregeln ergänzen.
  • Release: Lizenz, Changelog, Version aus einer Quelle, signierte macOS-/Android-Builds.

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 (atomare Saves, .bak-Sicherung, Autosave-/Session-Regeln)
  • Architektur- und Geschwindigkeitsdokumentation aktuell halten

Phase 2 – 3D-Präsentation

  • Externe Asset-Pipeline (Manifest, Hash-Prüfung, Sync nach assets/external/)
  • FTP-Spiegel für Rechner ohne Workbench (--publish / --sync-Fallback)
  • Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
  • Animations-Bake und Godot-Import eines Testclips (TestWave)
  • 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau)
  • Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange, Abbau am Kür-Ende)
  • Ärmel-Skinning mit 8 Bone-Influences und gelenkgenauer Ringgewichtung
  • Ärmel: Pose/Twist und Geometrie manuell verfeinern (Weight Paint, Solidify/Subdivision)
  • Folgekamera folgt der Fahrtrichtung (Frontansicht bei Rückwärtsfahrt)
  • Erster Produktionsclip Glide als 2-s-Loop
  • Rotoscoping-Workflow (Blender-Werkbank, Referenz, Multi-Clip-Export, Manifest)
  • Erste echte Clips aus Referenzmaterial (Vorwärts, Rückwärts, Pirouette)
  • Clip-Zuordnung Element → Animation in Godot
  • 3D-Bearbeitung, freie Kamera und Orbit-Steuerung
  • 3D-Atmosphäre als Stufe (Aus / Standard / Voll): Aus bleibt die nüchterne Trainer-Ansicht (Eis, Bande, Markierungen, Skater, Spur), Standard ergänzt Orientierung (Tribüne, Tore, Bank), Voll bringt Stadion-Details für Hobby-Läufer (Zuschauer, Lichtstimmung, Werbebande). Default Aus oder Standard, damit niemand ungefragt eine bevölkerte Halle bekommt; Stufe wirkt auf rink_3d und die Environment-Einstellungen.
  • 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

  • Native PDF-Ausgabe mit Bildern/Screenshots (die aktuelle PDF-Ausgabe ist vektorbasiert und enthält keine Fotos)
  • Vollständiges ISU-Regelwerk vor dem stabilen Planungs-Workflow
  • Sync-Komfort und visuelles UI-Refactoring (erst nach dem PoC)
  • Google Drive und OneDrive (aktuell reicht Dropbox; siehe „Später: Weitere Cloud-Anbieter“)
  • 3D-Produktionsreife