# Rinkplanner – Roadmap Stand: 2026-11-13 (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; Regelwerk als Saisonordner mit deklarativen Policies und Saison-Upgrade-Prüfung verbindlich festgelegt, siehe `docs/isu-rules-structure.md`) 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 - [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] Freeline-Werkzeug für frei gezeichnete, mehrpunktige Laufwege - [x] Freeline-Zwischenpunkte bearbeiten, glätten und per RDP reduzieren - [x] Playback-Steuerung als Icon-Knöpfe (Start/Pause/Reset) - [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 JSON, Schema-Prüfung, atomare Saves, Autosave und Session-Restore (Legacy-`.tres` lesbar) - [x] Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und Geschwindigkeit 0,25×–2,0× - [x] 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 - [x] Timeline-Labels: Kür-Labels schräg auf der Timeline, eigene Labels per Klick anlegen, bearbeiten und löschen - [x] Abschnittswechsel setzt Abspielfigur und Timeline an den Abschnittsanfang - [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] Native PDF-Ausgabe der Laufwege mit Zeit (Übersicht + Abschnittsseiten, Vektorpfade, Tabellen, Fortsetzungsseiten) - [x] Export-Abschluss mit absolutem Pfad sowie „Öffnen“, „Ordner anzeigen“ und „Pfad kopieren“; optional direkt im Standardprogramm öffnen - [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, aktuell Dropbox) - [x] Sync-Einstellungen in der App (Anbieter, Konto verbinden/trennen), Refresh-Tokens unter `user://` - [x] Manueller Sync: `.json` je Kür laden/hochladen (Legacy-`.tres` weiterhin), Sync-Stand lokal - [x] Konflikte automatisch nach Inhalt-Zeitstempel auflösen; die ältere Fassung bleibt im Konfliktarchiv (`user://conflicts/`) - [x] Küren verwalten: gezieltes Löschen (lokal und optional Cloud) mit Bereinigung des Sync-Stands - [x] Küren umbenennen: Dateiname und Titel, optional auch in der Cloud - [x] Geführter Aufräumdialog für alte `(Server …)`-/`(Lokal …)`-Kopien - [x] Fortschritt und Zusammenfassung in der Oberfläche - [x] Google-Drive- und Dropbox-Backend ohne externe Bibliothek - [x] 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 - [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) ### Erledigt: Step-Sequence-Gruppen (Option A) - [x] `element_group_id` am Segment, Lead trägt die Elementdaten - [x] `RoutineSection.get_elements()` / `ResolvedElement` als Auflösungsschicht - [x] Validator, Adult-Regeln und Basiswert zählen eine Gruppe einmal - [x] Sequenz erstellen über Mehrfachauswahl und das Sequenz-Symbol in der Werkzeugleiste; der frühere Zeichenmodus entfällt (in Tests verworfen) - [x] Ein Gruppenlabel in Canvas und SVG - [x] Schema 5 mit additivem `element_group_id` - [x] Mehrfachauswahl und nachträgliches Gruppieren in der UI - [x] PDF-Zeile pro Element statt pro Segment - [ ] Gruppe teilen/zusammenführen ### 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 - [x] Mehrsaison-Struktur: Regelpaket pro Saison (Ordner, Manifest, deklarative Policies), alte Küren gegen ihre eigene Saison prüfen; Zielbild und Invariantenkatalog in `docs/isu-rules-structure.md` - [x] Saison-Upgrade-Prüfung: bestehende Kür gegen eine andere Saison prüfen und nur berichten („2 Elemente nicht mehr im Katalog", „1 Feature entfallen", „Dauer jetzt 10 s zu lang"), ohne die Kür zu ändern - [ ] Max. zwei Features pro Fuß und Feature-Positionsregeln (als Policy in den Daten, nicht als Codebedingung) - [x] Artistic Free Skating als schmaler Modus (Entscheidung der Fachgruppe 2026-11-13: Punktwertung nicht wichtig, Länge und Begrenzungen schon). `program_type` als zweite Achse, Kategorien je Programmtyp, keine Punktschätzung für Artistic. Nicht modelliert: Pair Artistic, Eistanz, Synchro. - [x] Wiederholungsregeln (max. 2-mal pro gelistetem Sprung) - [x] Kombinationsgrenzen (Anzahl, Folgen, max. Sprünge pro Kombination) - [x] Strukturierte Sprungkombinationen/-folgen (erster Sprung + bis zu zwei weitere) - [x] Altdaten-Migration von Freitext-Kombinationen in die strukturierte Form - [x] Axel-Pflicht für Sprungfolgen (Modell, Validator und Dialoghinweis) - [x] Dauerprüfung gegen die Kategorie-Zeit - [x] PCS und Sturzabzüge in der Punktschätzung (mit Annahmen) - [x] 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 - [x] 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 folgt die Mehrsaison-Struktur (Regelpaket pro Saison, alte Küren bleiben gegen ihre eigene Saison prüfbar) samt Saison-Upgrade-Prüfung, danach 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/`) 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) - [x] Export startet ohne Autoload-/Startfehler; der Runtime-Bridge-Autoload ist im Export enthalten, Editor-Addons bleiben draußen. - [x] 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. - [x] 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). - [x] 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. - [x] 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. - [x] 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 - [x] Persistenz-Backups und Dateiverwaltung prüfen (atomare Saves, `.bak`-Sicherung, Autosave-/Session-Regeln) - [ ] Architektur- und Geschwindigkeitsdokumentation aktuell halten ## Phase 2 – 3D-Präsentation - [x] Externe Asset-Pipeline (Manifest, Hash-Prüfung, Sync nach `assets/external/`) - [x] FTP-Spiegel für Rechner ohne Workbench (`--publish` / `--sync`-Fallback) - [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export) - [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`) - [x] 3D-Rink, Kamera und Skater auf denselben Kurven (schreibgeschützte Vorschau) - [x] Kufenspur mit Richtungsfarbe (vorwärts türkis, rückwärts orange, Abbau am Kür-Ende) - [x] Ärmel-Skinning mit 8 Bone-Influences und gelenkgenauer Ringgewichtung - [ ] Ärmel: Pose/Twist und Geometrie manuell verfeinern (Weight Paint, Solidify/Subdivision) - [x] Folgekamera folgt der Fahrtrichtung (Frontansicht bei Rückwärtsfahrt) - [x] Erster Produktionsclip `Glide` als 2-s-Loop - [x] 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 - [x] 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 ## Später: Build-Größe (ganz am Ende) - [ ] Intel-Support für macOS aufgeben: nur noch arm64 bauen. Das Universal Binary enthält derzeit beide Architekturen (171 MB Mac-Binary gegenüber 110 MB Windows); ein arm64-only-DMG halbiert den Download ungefähr. Vorher prüfen, wie viele Nutzer noch Intel-Macs verwenden – falls nötig, ein zweites, separates Intel-DMG statt Universal. - [ ] Auf ein leistungsfähigeres Kompressionsverfahren umstellen. Das DMG nutzt zlib (UDZO), der Windows-Installer LZMA; bei gleicher Kompression wäre der Mac-Download deutlich kleiner. Kandidaten: UDBZ (bzip2) oder ULFO (LZFSE) für das DMG, LZMA2/7z für Windows. - [ ] Optional: Godot-Export-Template ohne ungenutzte Module bauen – größter Effekt, aber eigener Toolchain-Schritt.