rinkplanner/docs/roadmap.md
torsten d4b227a936 fix: Armgewichte ringweise, Aermel behalten Volumen
- PSEUDO-VOXELS-Gewichte bleichten in spine/head; die offenen
  Aermelflaechen kollabierten trotz 8 Bone-Influences
- x-basierte Ringgewichtung fuer die Armregion, 8 Influences
- neues Quell-Rig und GLB v005, Manifest, Sync und FTP aktualisiert
- Rotoscoping-Default auf skater_rig_v005.blend
- 1189 Assertions gesamt
2026-10-31 15:35:17 +01:00

10 KiB
Raw Blame History

Rinkplanner – Roadmap

Stand: 2026-10-31 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; 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-31-adult-2026-27.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 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

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ß und GOE. 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

  • 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 ringweiser Armgewichtung
  • 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
  • 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