rinkplanner/docs/roadmap.md

524 lines
28 KiB
Markdown
Raw Normal View History

# 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
### 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“.
**Rückmeldung der Fachtester (2026-11-13):** Sync wurde nicht genutzt – die
Tester arbeiten zuhause am PC und drucken die Abläufe aus. Sync bleibt als
Funktion (für andere Käufer und mehrere Geräte), wird aber nicht ausgebaut.
Der Ausdruck ist damit der Weg, den die PDF-Ausgabe tragen muss.
**Kür-Hub:** ebenfalls noch ungenutzt, aber mit anderem Potential: Die
Tester wohnen weit auseinander, und der Hub ist der einzige Weg, sich
gegenseitig Küren zu zeigen. Abzuwarten, ob dieser Effekt greift, bevor hier
investiert wird.
### 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
- [x] Max. zwei Features pro Fuß (nur bei Fußwechsel-Pirouetten, Abfrage erst
ab drei fußbezogenen Features) und max. zwei Variationen pro Pirouette, je
Kategorie einmal pro Programm
- [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: `V`-/Unterrotationsvarianten als Was-wäre-wenn
(Basiswert-Effekt ist deterministisch; Eingabe bleibt eine Annahme)
### 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
- [ ] 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 das ISU-Regelwerk – Katalog 2026/27,
Level-Features, Elementvalidierung, Adult-Kategorien, Dauer und
Wiederholungs-/Kombinationsgrenzen stehen, ebenso die Mehrsaison-Struktur
(Regelpaket pro Saison, alte Küren bleiben gegen ihre eigene Saison prüfbar)
mit Saison-Upgrade-Prüfung und die Feature-Grenzen pro Fuß. GOE ist bewusst
ausgeschlossen (Richterermessen), die `V`-Varianten sind 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)
- [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. In Etappen nach
`docs/refactor-whiteboard-controller.md`; Stand 2026-11-13: 8.154 Zeilen; `HelpContent`, `SeasonComparisonText`,
`ValidationReportView`, `ExportService`, `RulesContext`,
`SeasonPanelModel`, `SyncSummaryText`, `PlaybackPose`, `ExportPanel`,
`PlaybackPanel`, `TimelineLabelModel`, `SyncSettingsModel`,
`RoutineManagerModel`, `RoutineManagerPanel` und zwei eigenständigen
Panel-Tests ausgelagert.
- [x] Saison datengetrieben: Saison-Auswahl aus `data/`, Voreinstellung nach
`valid_from`, Regelstand in Statusleiste und Prüfdialog.
- [x] Android-Export über SAF: „Speichern unter…“ schreibt PDF/SVG/PNG über
den System-Dateidialog nach Downloads oder in einen anderen Ordner. Kein
Plugin, keine Storage-Permission (2026-11-14).
- [ ] Gerätetest Galaxy Tab S9+: Export → „Speichern unter…“ → Downloads,
PDF/SVG/PNG öffnen; Abbruch und fehlende Datei prüfen.
- [ ] Optional: Share-Intent (`ACTION_SEND`) für „Teilen…“ — braucht ein
Android-Plugin und einen Gradle-Build; erst wenn der SAF-Weg nicht reicht.
- [ ] `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: 25 `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
## Später: Test-Werkzeug und CI
- [ ] Gemeinsamer Test-Harness: Zusammenfassung je Suite, Timeout pro Lauf,
Logs; optional Coverage.
- [ ] CI auf dem Forgejo-Remote — **erst wenn der Server alle
Deployment-Artefakte erzeugen kann.** Das macOS-DMG entsteht auf einem Mac;
solange das so ist, liefert eine CI nur eine halbe Wahrheit. Bis dahin bleibt
`./tools/test.sh` der Vor-Push-Schritt.
## Bewusst nicht jetzt
- **Hochformat und DeX-Layout.** Die Eisfläche ist Querformat, und das Tablet
wird intuitiv so gehalten. Eine Hochformat-Fassung würde die Leisten
umbrechen oder Werkzeuge verstecken, ohne dem Planen zu helfen. Entschieden
am 2026-11-13; die Querformat-Leisten müssen nur auf schmalen
Querformat-Breiten passen (erledigt für 1400 logische Punkte).
- 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
- **GOE-Tabellen.** GOE vergibt der Richter nach der Ausführung (−5 bis +5,
Kriterien wie Höhe, Fluss, Landung). Es ist aus einem Plan nicht ableitbar;
die App würde eine Zahl vortäuschen, die sie nicht kennt. Die
Punktschätzung bleibt deshalb bei Basiswert + PCS-Annahme − Sturzabzug und
benennt die Lücke (`docs/manual.md`). Auch die Maximalwerte je Elementtyp
als Bandbreite wären faktisch korrekt, aber für die Planung nutzlos.
### Weitere Disziplinen
Klassifikation nach zwei Achsen: **wie viele Linien** ein Programm hat und
**welcher Elementkorpus** gilt. Daraus folgt, ob eine Disziplin ein Modus,
eine spätere Erweiterung oder ein eigenes Produkt ist.
| Disziplin | Linien | Elemente | Status |
| :--- | :--- | :--- | :--- |
| Kür (Single Free Skating) | 1 | Einzel-Elemente | umgesetzt |
| Artistic | 1 | Einzel-Elemente, nicht technisch gewertet | umgesetzt (schmal) |
| Paarlauf | 1 gemeinsame Linie | Paar-Elemente | **zurückgestellt, nicht abgelehnt** |
| Eistanz | 2 (Partner) | Tanz-Elemente, Pattern Dances | **nicht als Modus; nur als bezahltes Lehr-/Referenzwerkzeug** |
| Formationsläufe | 12–16 | Team-Elemente | **eigenes Produkt, nicht geplant** |
**Paarlauf** passt auf das Modell: Ein Paar läuft gemeinsam, eine Linie
beschreibt den Weg brauchbar. Es fehlt der Korpus, nicht die Architektur:
- neue Elementtypen Wurf, Twist, Hebung, Todesspirale, Paarpirouette,
Paar-Schrittsequenz (Modell, Inspector, Canvas, Export)
- Base Values für Paar-Elemente (die SoV-Datei heißt „Single & Pair Skating“,
enthält aber nur Einzel-Elemente)
- Level-Features je Paar-Elementtyp aus der eigenen Communication
- Kategorie-Grenzen der Paar-Wettbewerbe (Adult, Intermediate, Masters …)
- Prüfungen für Elementanzahl, erlaubte Elemente, Dauer und PCS
Das ist Datenarbeit plus Modellerweiterung — dieselbe App, kein neues
Produkt, aber ein Projekt über Monate, kein Add-on. Deshalb „zurückgestellt“
statt „abgelehnt“, und deshalb auch keine Saison-Upgrade-Sonderbehandlung:
Sobald es gebaut ist, läuft es in derselben Struktur.
**Eistanz** ist kein Modus für diese App. Es gibt keine Sprünge, der
Punktwert wird von GOE/PCS getrieben (GOE ist bewusst nicht modelliert), und
die eigentliche Planungsaufgabe liegt in Mustern, Schritten, Haltungen und
Musikalität – nicht in der Platzierung hochwertiger Elemente. Ein
„Eistanz-Modus“ wäre ein großer Modus mit demselben dünnen Kern wie Artistic.
Wenn überhaupt, dann als eigenes **Lehr-/Referenzwerkzeug** für Pattern
Dances: exakte ISU-Geometrie, Schrittlabels, Zählzeiten, Haltungen,
Takt-Timeline und Druck. Das hat einen anderen Käufer (Eistanzschule,
Adult-Gruppe, Verband) und einen eigenen Preispunkt. Kein Add-on zum
Kürplaner.
**Formationsläufe** scheitern an der ersten Achse: 12–16 Läufer,
Formationsgeometrie, Teamelemente mit eigenen Level-Features und
Unterbrechungsabzügen. Ein Modus in dieser App würde Teamprogramme prüfen,
ohne die Formationen zu kennen. Wenn Bedarf entsteht: eigenes Werkzeug auf
demselben Planungskern (Canvas, Pfadmodell, Musik, Timeline, Export).
Gemeinsam genutzt würde dabei nur die Planungsebene — Eisfläche, Musik, Zeit,
Abschnitte, Labels, Export. Elemente, Regelwerk und vor allem die Geometrie
über viele Läufer wären eigenständig.
> **Antwort auf entsprechende Anfragen:** Formationsläufe teilen mit dem
> Rinkplanner nur die Planungsebene. Das Regelwerk, die Elemente und vor
> allem die Geometrie über 12–16 Läufer sind eigenständig; ein
> „Synchro-Modus“ in derselben App würde Teamprogramme prüfen, ohne die
> Formationen zu kennen. Bedarf würde ein eigenes Werkzeug auf demselben
> Planungskern rechtfertigen, keine Erweiterung. Paarlauf dagegen ist eine
> spätere Erweiterung derselben App: gleiche Linienlogik, anderer
> Elementkorpus.
**Name für das eigene Werkzeug: `RinkFormation`** (Vorratsentscheidung,
2026-11-13). Der Name hält das Domänenwort „Rink“ konstant – wie bei
`Rinkplanner` und dem Hub – und tauscht nur die Funktion. „Formation“ ist
zugleich der Begriff aus dem Regelwerk, „Rink“ nimmt die Mehrdeutigkeit des
Wortes heraus (Militär, Geologie, Firmengründung). Verworfen:
`FormationPlanner` (dreht das Muster um – Funktion konstant, Domäne getauscht –
und liest sich als Regal „XPlanner“, außerdem im Fußball als Taktikbrett
besetzt), `RinkForm` (kürzer, aber ohne „Formation“ nicht selbsterklärend) und
die bildstarken Varianten `RinkWeave`/`RinkShape` (im Deutschen schlecht
aussprechbar). Namensraum: Repo und Godot-Projekt `rinkformation`, Kennung
`de.programmschmiede.rinkformation`, Domain `rinkformation.de` (am 2026-11-13
ohne DNS-Eintrag; Markenrecherche beim DPMA offen).
Das ist Vorratshaltung, keine Planung: Interessant wird das Werkzeug erst, wenn
der Rinkplanner praktisch ausentwickelt ist. Bis dahin bleibt der Name eine
Notiz in diesem Dokument.
### Disziplin-Gates
Grundsatz: **kein Vorratsbau.** Eine Disziplin wird erst angefasst, wenn es
einen zahlenden Pilotkunden, eine Vorfinanzierung oder einen Verband mit
konkretem Bedarf gibt. Die bloße Möglichkeit reicht nicht.
| Stufe | Was nötig ist | Aufwand | Preislogik |
| :--- | :--- | :--- | :--- |
| Daten (Saison) | neue ISU-/DEU-Daten, Tests | Tage | Saison-Paket 9 € |
| Modell (Paarlauf) | gemeinsame Linie, Partnerpositionen, Paar-Elemente, Levels, Validierung, Export, UI | Monate | Disziplin-Paket 99–149 € einmalig |
| Lehrwerkzeug (Eistanz) | Pattern-Bibliothek, Takt-Timeline, Haltungen, Tanz-Elemente | eigenes Produkt | eigener Preis, Pilot/Verband |
| Neuer Kern (Formation) | 12–16 Läufer, Formationen, Übergänge, Kollisionen, Teamelemente | eigenes Produkt | eigener Preis, eigenes Repo |
**Reihenfolge, wenn überhaupt:**
1. Singles + Adult (Kern, laufend)
2. Paarlauf (bester Produktfit: hochwertige Elemente, Regeln, Timing, Druck)
3. Eistanz (nur als bezahltes Lehr-/Referenzwerkzeug, nicht als Planer)
4. Formation (`RinkFormation`, eigenes Produkt)
**Gate-Kriterien:**
- **Paarlauf:** 10 zahlende Pilot-Trainer mit Anzahlung **oder** ein Verband
mit Letter of Intent und finanzieller Beteiligung, plus ein Pilotverein
mit Paarlauf-Trainer.
- **Eistanz:** 3 Eistanzschulen oder Adult-Gruppen mit Anzahlung **oder** ein
Verbandspilot für ein Pattern-Dance-Lehrwerkzeug. Kein Planer-Modus.
- **Formation:** 3 Teams mit Anzahlung **oder** ein Verbandspilot; sonst
nicht bauen. `RinkFormation` bleibt eine Notiz.
**Warum diese Reihenfolge:** Paarlauf ist dem Kern am nächsten: Wurf, Twist,
Hebung, Todesspirale und Side-by-Side-Sprünge sind wieder hochwertige
Elemente, die man platziert, prüft, vertont und druckt. Der Markt ist
kleiner als bei Eistanz, aber der Wert ist klar. Eistanz hat den größeren
Markt, aber den schwächeren Fit: Der Punktwert hängt an GOE/PCS, die
Planung an Mustern und Haltungen. Es wäre ein Lehrprodukt, kein Kürplaner.
Formation bleibt ein anderer Kern: Der Käufer ist das Team, nicht der
einzelne Läufer, und die Planung über 12–16 Läufer ist nicht dieselbe
Aufgabe wie eine Linie.
**Konsequenz für die Preisliste:** Paarlauf ist kein 39-€-Add-on, sondern
ein Disziplin-Paket (99–149 €). Eistanz wäre ein eigenes Lehrprodukt mit
eigenem Preis. Solo-Läufer zahlen beides nicht mit.
**Konsequenz für die Architektur:** Die gemeinsame Planungsebene (Canvas,
Pfad, Timeline, Musik, Export) bleibt die Schnittstelle. Der
`WhiteboardController` wird aber nicht spekulativ zerlegt; das passiert erst,
wenn ein bezahlter Anlass da ist.
## 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.