14 KiB
Rinkplanner – Roadmap
Stand: 2026-11-03 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; JSON-Dateiformat, Export-Smoke-Test und Quality-Meilenstein ergänzt)
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
- 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-
.treslesbar) - Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und Geschwindigkeit 0,25×–2,0×
- Musikstück (MP3/OGG/WAV) je Kür laden; Wiedergabe, Scrubbing und Geschwindigkeit laufen synchron zum Läufer; der FTP-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)
- Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort,
Verzeichnis, FTPS, Zertifikatsprüfung), Zugangsdaten unter
user:// - Manueller Sync:
.jsonje Kür laden/hochladen (Legacy-.tresweiterhin), 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 2026/27 mit 24 Sprüngen, 17 Pirouetten (inkl.
ChSp) und 2 Sequenzen; Format und Pflege indocs/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/ChSpLevel 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 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 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.
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.shprüft den headless Start, das Fehlen von Testskripten und die Texturen. - Kürdateien als JSON (
RoutineFile,rinkplanner.routine, Limits, Schema-Prüfung). Legacy-.tresbleibt lesbar, wird aber vorResourceLoader.loadper Whitelist geprüft (kein eingebettetes GDScript, nur Modellskripte). - Atomare Saves über Temp +
.bak, Überschreibschutz für „Speichern unter“ und Export, letzter Pfad inuser://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
WhiteboardControllerin 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.shundtools/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+Nund sichtbarer Speicherstatus (auch ohne Fenstertitel auf Android).
Danach
- Theme-Ressource + zentrale UI-Texte (
tr()/CSV), kompakte Labels nicht mehr im Controller; Dark/Light und skalierbare Schriftgrößen. - 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-*.mdnachdocs/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;.gitattributesum Binärregeln ergänzen. - Release: Lizenz, Changelog, Version aus einer Quelle, signierte macOS-/Android-Builds.
Querschnittsaufgaben
- Tests bei jedem Feature erweitern;
./tools/test.shbleibt 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
Glideals 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
- 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)
- 3D-Produktionsreife