feat: Sport-Theme, Küren-Verwaltung und Sync-Konflikte

- zentrales Sport-Theme für das Weißbrett
- Küren im Sync umbenennen, löschen und Musikzuordnung aufräumen
- Konfliktbereinigung mit Vorschau und gezieltem Löschen
- Sync nutzt saved_at aus der Kür statt Gerätezeit
- Schrittsequenzen über Mehrfachauswahl gruppieren
- Startskript aktualisiert den class_name-Cache bei Änderungen
This commit is contained in:
torsten 2026-11-11 13:14:14 +01:00
parent dbcba27ebd
commit 6172d311bc
25 changed files with 2993 additions and 820 deletions

View file

@ -300,19 +300,18 @@ Fahrtrichtung.
ihre Reihenfolge. Der Marker wird direkt ausgewählt; der Button
„Element“ öffnet den Inspector für Typ, Kürzel und Level. Im
Auswahlmodus lässt sich der Marker über seinen Griff verschieben.
Das **Sequenz-Symbol** startet den Sequenz-Zeichenmodus: Die erste
gezeichnete Strecke wird Lead eines Bereichs, weitere Strecken treten über
dieselbe `element_group_id` bei. Die Gruppe zählt in Prüfung, Basiswert,
Adult-Regeln, Timeline und Export als **ein** Element. Ein beliebiges
Mitglied lässt sich auswählen; der Inspector bearbeitet immer das Lead-
Segment. Beim Löschen des Leads übernimmt das nächste Mitglied die
Schrittsequenzen entstehen durch **Mehrfachauswahl** (Knopf im
Abschnittsbereich oder Shift/Cmd/Ctrl-Klick) und das **Sequenz-Symbol**
(geschweifte Klammer mit Plus) in der Werkzeugleiste: Das gruppiert
zusammenhängende Segmente über eine gemeinsame `element_group_id`. Der
Controller prüft Lücken, Marker und bestehende Elemente, bevor er den
Undo-fähigen Gruppenschritt ausführt. Die Gruppe zählt in Prüfung,
Basiswert, Adult-Regeln, Timeline und Export als **ein** Element. Ein
beliebiges Mitglied lässt sich auswählen; der Inspector bearbeitet immer
das Lead-Segment. Beim Löschen des Leads übernimmt das nächste Mitglied die
Elementdaten. `RoutineSection.get_elements()` löst Einzelelemente und
Gruppen zu `ResolvedElement`-Sichten auf; alle Wertungs- und Anzeigepfade
iterieren darüber statt über die Rohsegmente. Die **Mehrfachauswahl**
(Knopf im Abschnittsbereich oder Shift/Cmd/Ctrl-Klick) erlaubt das
nachträgliche Gruppieren zusammenhängender Segmente über
„Sequenz gruppieren“; der Controller prüft Lücken, Marker und bestehende
Elemente, bevor er den Undo-fähigen Gruppenschritt ausführt. Punktmarker haben eine
iterieren darüber statt über die Rohsegmente. Punktmarker haben eine
**Standzeit** (`element_duration_seconds`)
mit Typ-Defaults (Sprung 0,7 s, Pirouette 4 s, Sequenz 0 s), die im
Inspector übersteuert wird und in die Timeline eingeht. Pirouetten tragen
@ -392,8 +391,9 @@ Fahrtrichtung.
auf das 1,85-Fache, um die Luftphase zu zeigen. Während
des Playbacks wird die aktuelle Section hervorgehoben,
ohne die Bearbeitungs-Section zu wechseln. Ein **▶** markiert sie in der
Abschnittsliste; ihr Name erscheint kurz oben auf der Eisfläche und blendet
sich innerhalb von zwei Sekunden aus. Steuerung: Icon-Knöpfe für
Abschnittsliste; ihr Name erscheint als große Sport-TV-Bauchbinde bündig
am oberen Rand der Eisfläche und gleitet nach 2,6 Sekunden wieder aus.
Steuerung: Icon-Knöpfe für
Start/Pause und Reset (Rekorder-Symbole, Tooltips nennen die Aktion),
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Ein optionales
Musikstück liegt neben der Kür-JSON in `user://routines/` und läuft über
@ -402,8 +402,9 @@ Fahrtrichtung.
benannte ISO-Container werden auf macOS mit `afconvert` zu mono
PCM-WAV (44,1 kHz) konvertiert. Beim Kopieren in den Kür-Ordner wird der
Inhalt verglichen: identische Tracks werden wiederverwendet (auch die
bereits referenzierte Datei der Kür bleibt erhalten), nur bei
abweichendem Inhalt gleichen Namens entsteht ein nummerierter Name. Start,
bereits referenzierte Datei der Kür bleibt erhalten). Bei gleichem Namen
und abweichendem Inhalt fragt ein Dialog, ob die vorhandene Datei verwendet
oder überschrieben wird; nummerierte Namen entstehen nicht mehr. Start,
Pause, Reset, Scrubbing und Geschwindigkeit wirken auf Bild und Ton. Über
der Timeline liegt eine Label-Spur: Labels von Segmenten und Kürzel von
Elementen ohne Freitext erscheinen schräg an ihrem Startzeitpunkt (auch
@ -453,24 +454,39 @@ die Bildschirm-Skalierung (`DisplayServer.screen_get_scale()`). Auf dem
Tablet (DPR ≈ 2,6) entspricht eine Layout-Einheit damit einem CSS-Pixel und
wird trotzdem in Gerätepixeln gerendert:
- Ein 56-px-Button ist auf dem Tablet wirklich 56 CSS-Pixel groß, statt durch
- Ein 48-px-Button ist auf dem Tablet wirklich 48 CSS-Pixel groß, statt durch
eine feste Designauflösung kleingerechnet zu werden.
- Das Rink bleibt in Metern; nur die Pixelabbildung ändert sich.
- Der PNG-Export ist unabhängig davon (eigener `SubViewport`, 2560 × 1600).
### Sport-Theme
`src/ui/sport_theme.gd` baut das zentrale `Theme` zur Laufzeit und wird im
Controller auf das Whiteboard und alle Dialoge/Popups angewendet:
- Tiefes Marineblau (`#070b12`/`#0b1320`) mit Cyan-Akzenten (`#38c6f4`),
flache Panels mit dünnen Rahmen statt runder UI-Boxen.
- Buttons, Eingabefelder, Menüs, Tabs, Slider und Scrollbars teilen sich
dieselben Zustände (normal/hover/pressed/disabled/focus).
- Überschriften erhalten eine kräftigere `FontVariation`; „RINKPLANNER“,
„ABSCHNITTE“ und „TIMING“ laufen in Großbuchstaben mit Akzentfarbe.
- Die Hauptleisten wurden vertikal verdichtet: Kopfzeile 80 → 60 px, Timing
72 → 60 px, Playback 124 → 92 px, Status 64 → 52 px; Bedienelemente
56 → 48 px. Dadurch bleibt deutlich mehr Höhe für das Rink.
### Responsive Leiste
- Die Werkzeuge liegen als Icon-Leiste in der Kopfzeile: Mauszeiger für
„Auswählen“, Linie, linker und rechter Bogen sowie drei Element-Icons
(springendes Strichmännchen mit Pfeil = Sprung, hockendes mit Kreispfeil =
Pirouette, gehendes = Sequenz). Beim Start ist „Auswählen“ aktiv. Das aktive
Werkzeug wird erhellt (weißes Icon) und mit einem weißen Rahmen markiert;
Werkzeug wird mit einem cyanfarbenen Rahmen und einer Akzentkante markiert;
Tooltips nennen den Namen.
- Ab 1390 px Breite: volle Beschriftungen („Rinkplanner“, „Vorwärts“,
„Rückgängig“, „Wiederholen“, „Kalibrieren“).
- Unter 1390 px: kompakte Beschriftungen („Undo“, „Redo“, „Vor“, „Rück“,
„Fit“, „Kalib.“), der Titel entfällt, die Werkzeug-Icons werden 44 statt
48 px breit, das Sections-Panel 260 statt 300 px.
„Fit“, „Kalib.“), der Titel entfällt, die Werkzeug-Icons werden 36 statt
44 px breit, das Sections-Panel 260 statt 300 px.
- Die Timing-Leiste ist ein `HFlowContainer` und bricht bei Bedarf um, statt
seitlich abgeschnitten zu werden.
- Geprüfte Landschaftsbreiten: 1024 px (kleine Tablets) und 1400 px
@ -564,11 +580,18 @@ ggf. eines nach `touchend` (300-ms-Guard).
Jeder Nutzer verbindet sein eigenes Dropbox-Konto; das
Google-Drive-Backend ist vorbereitet, aber derzeit nicht freigeschaltet.
Refresh-Tokens liegen in `user://sync.cfg`, der letzte gemeinsame Stand in
`user://sync_state.cfg`. Beim ersten Abgleich einer beidseitig vorhandenen
Datei übernimmt die Cloud-Fassung den Namen, die lokale bleibt als
`(Lokal …)`-Kopie; bei einem echten Konflikt bleibt die lokale Fassung
Hauptdatei und die Cloud-Fassung kommt als `(Server …)`-Kopie dazu.
Konfliktnamen behalten die jeweilige Endung.
`user://sync_state.cfg`. Sind Dateien beidseitig vorhanden, lädt der Sync
die Cloud-Fassung in eine temporäre Datei und vergleicht den
Inhalt-Zeitstempel (`saved_at` in der Kür-JSON); bei Legacy-`.tres` und
Musikdateien dienen die Dateizeiten als Ersatz. Die neuere Fassung behält
den normalen Namen, die ältere wird nach `user://conflicts/` kopiert
(ein Archivplatz pro Dateiname). Bei Gleichstand übernimmt beim ersten
Abgleich die Cloud, bei einem echten Konflikt die lokale Fassung. Sichtbare
`(Server …)`-/`(Lokal …)`-Kopien aus früheren Versionen findet und entfernt
**Datei → Küren verwalten… → Konfliktkopien** nach Bestätigung; die Kopien
landen dabei im Konfliktarchiv. Derselbe Dialog löscht normale Küren lokal
und auf Wunsch auch im Cloud-Konto; dabei werden der Sync-Stand und
ungenutzte Musikdateien bereinigt.
## 7. Tests
@ -620,28 +643,32 @@ Aktueller Stand:
- **History:** 53 Assertions für Undo/Redo von Segmenten, Kanten, Labels, Sections,
Zeichengesten und Griff-Bearbeitung, Toolbar-Buttons, Erhalt der Ansicht
sowie das Zurücksetzen der Historie.
- **Playback:** 99 Assertions für Dauer/Timeline, Vorwärts-/Rückwärts-
- **Playback:** 121 Assertions für Dauer/Timeline, Vorwärts-/Rückwärts-
Blickrichtung, Section-Hervorhebung und -Banner, Play/Pause/Reset inklusive
Button-Verdrahtung, Scrubbing, Geschwindigkeitswechsel, Standzeiten von
Elementen, Markerrotation in einer Pirouette sowie Timeline-Tooltips.
Elementen, Markerrotation in einer Pirouette, Timeline-Tooltips und den
Musikimport mit Dialog für gleichnamige Dateien.
- **Timing:** 41 Assertions für Dauer-/Tempo-Kopplung, Level-Presets,
Kalibrierung, Undo, Persistenz und Schema-1-Migration.
- **Export:** 31 Assertions für SVG-Struktur, Titel-Escaping, Segment-Labels,
Element-Marker, strukturierte Sprungkombinationen, Section-Filter,
Segmentfarben/-strichelung und das Schreiben der Exportdatei.
- **Touch/Tablet:** 28 Assertions für Ein-Finger-Zeichnen, Zwei-Finger-Pan,
- **Touch/Tablet:** 35 Assertions für Ein-Finger-Zeichnen, Zwei-Finger-Pan,
Pinch-Zoom, Tipp-Auswahl, Griff-Bearbeitung, Element-Marker per Tipp,
Abbruch bei zweitem Finger,
Unterdrückung synthetischer Maus-Events aus Chrome sowie das responsive
Leistenlayout bei 1024 und 1400 px.
Unterdrückung synthetischer Maus-Events aus Chrome, das responsive
Leistenlayout bei 1024 und 1400 px sowie die kompakten Haupthöhen.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms).
- **Sync:** 59 Assertions für Vergleichsregeln, Konfliktnamen (JSON und
Legacy-`.tres`), Zeitstempel, URL/PKCE-Helfer, Cloud-Pfade, App-Konfiguration,
Sync-Stand und die Einstellungs-Verdrahtung. Die echten Cloud-APIs werden
nicht in den automatischen Tests angesprochen (OAuth erfordert ein
Testkonto); der Ablauf ist in `docs/cloud-setup.md` beschrieben.
- **3D-Assets:** 57 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
- **Sync:** 123 Assertions für Vergleichsregeln, die Neuere-gewinnt-Auflösung
(inklusive Archiv und Fake-Cloud), das Aufräumen alter Konfliktkopien,
gezieltes Löschen (lokal und Cloud), Umbenennen inklusive Cloud,
Zeitstempel, URL/PKCE-Helfer,
Cloud-Pfade, App-Konfiguration, Sync-Stand und die
Einstellungs-Verdrahtung. Die echten Cloud-APIs werden nicht in den
automatischen Tests angesprochen (OAuth erfordert ein Testkonto); der
Ablauf ist in `docs/cloud-setup.md` beschrieben.
- **3D-Assets:** 58 Assertions für Manifest-Schema, Pfade, FTP-Pfade,
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
– Größe, SHA-256 sowie die 8-Bone-Gewichte der GLB-Datei.
- **3D-Vorschau:** 61 Assertions für Koordinatenabbildung, Rink-Geometrie,

View file

@ -252,8 +252,8 @@ auf `tools/sync_assets.sh --sync` ab. Für einen reinen Starttest ohne
## Kontosync
Der manuelle Sync über Dropbox lädt die neuesten
`.json`-Dateien (Legacy-`.tres` weiterhin) je Kür hoch bzw. herunter,
Konflikte bleiben als Kopien mit Zeitstempel erhalten. Jedes Gerät verbindet
das eigene Dropbox-Konto; Refresh-Tokens liegen in den App-Einstellungen
(`user://`), nicht im Repository. Details in `docs/sync.md` und
`docs/cloud-setup.md`.
`.json`-Dateien (Legacy-`.tres` weiterhin) je Kür hoch bzw. herunter. Sind
beide Seiten geändert, gewinnt die neuere Fassung; die ältere bleibt im
Konfliktarchiv. Jedes Gerät verbindet das eigene Dropbox-Konto;
Refresh-Tokens liegen in den App-Einstellungen (`user://`), nicht im
Repository. Details in `docs/sync.md` und `docs/cloud-setup.md`.

View file

@ -77,3 +77,21 @@ Jedes erneute Laden desselben Stücks legte bisher eine neue Kopie an
Tests in `run_playback_tests.gd`: zweimal dasselbe Stück laden behält den
Namen und erzeugt kein `… 2.wav`; ein anderes Stück gleichen Namens bekommt
eine Nummer, die beim erneuten Laden stabil bleibt.
## Nachtrag (2026-11-11): Entscheidungsdialog statt Nummern-Suffix
Der nummerierte Name bei abweichendem Inhalt entfällt. Der Import zeigt
jetzt einen Dialog mit **Bestehende verwenden**, **Überschreiben** und
**Abbrechen**:
- **Bestehende verwenden** referenziert die vorhandene Datei, ohne sie zu
verändern.
- **Überschreiben** ersetzt die vorhandene Datei atomar unter demselben
Namen.
- **Abbrechen** lässt Datei und Kür unverändert.
- Identischer Inhalt wird weiterhin ohne Nachfrage wiederverwendet.
- Ein Zahlen-Suffix wie `… 2.mp3` wird nie mehr erzeugt.
`_resolve_music_copy_name()` ist dafür zur Coroutine geworden und wartet auf
das Signal `music_conflict_decided`; die eigentliche Kopie übernimmt
`_store_music_copy()` über eine temporäre Datei und `.bak`-Rotation.

View file

@ -60,3 +60,11 @@ gemeinsame `element_group_id` darauf.
4. **Punktmarker:** Sprung/Pirouette bleiben Einzelelemente mit einem
Ankersegment. Eine vollständige `RoutineElement`-Ablage (Option B) ist
weiterhin der langfristige Umbau.
## Nachtrag (2026-11-11)
Im Nutzertest erwies sich der Sequenz-Zeichenmodus als schwer zugänglich.
Er wurde entfernt; Schrittsequenzen entstehen jetzt ausschließlich über
**Mehrfachauswahl** und das **Sequenz-Symbol** (geschweifte Klammer mit
Plus) in der Werkzeugleiste. Es ersetzt an derselben Stelle das alte
Sequenz-Werkzeug und nennt die Auswahlgröße im Tooltip.

View file

@ -15,6 +15,21 @@ App über den Button **?** in der Statusleiste erreichbar.
6. Optional **3D** in der oberen Leiste öffnen, um die Kür als Vorschau
abzuspielen.
## Küren verwalten
**Datei → Küren verwalten…** bündelt die Dateipflege:
- **Küren:** Lokale Kürdateien öffnen, umbenennen oder gezielt löschen.
Beim Umbenennen werden Dateiname und Titel geändert; ist ein Cloud-Konto
verbunden, wird die Cloud-Kopie auf Wunsch mit umbenannt. Beim Löschen kann
die Kopie im Cloud-Konto mit entfernt werden. Die Musikdatei wird nur
gelöscht, wenn keine andere Kür sie verwendet. Die gerade geöffnete Kür
lässt sich nicht löschen – dafür zuerst eine andere Kür öffnen.
- **Konfliktkopien:** Alte sichtbare Kopien wie
`Kür (Server 2026-10-30 1050).json` suchen und nach Bestätigung ins
Konfliktarchiv verschieben. Echte Sync-Konflikte löst die App automatisch
nach dem neuesten Speicherstand auf; die ältere Fassung bleibt im Archiv.
## Laufwege zeichnen
- **Linie** und die beiden **Bogen**-Werkzeuge erzeugen eine gerade Strecke
@ -41,9 +56,10 @@ App über den Button **?** in der Statusleiste erreichbar.
## Elemente platzieren
Die Werkzeuge **Sprung**, **Pirouette** und **Sequenz** setzen per Tipp einen
Element-Marker. Wo der Marker in der Kür erscheint, entscheidet die gezeichnete
Laufspur:
Die Werkzeuge **Sprung** und **Pirouette** setzen per Tipp einen Element-Marker.
Schrittsequenzen entstehen dagegen durch Gruppieren gezeichneter
Teilstrecken (siehe unten). Wo der Marker in der Kür erscheint, entscheidet die
gezeichnete Laufspur:
- Ein Tipp am **Anfang** der Spur setzt das Element an den Abschnittsanfang.
- Ein Tipp **zwischen zwei Segmenten** fügt das Element an dieser Stelle ein.
@ -56,42 +72,33 @@ an der getippten Stelle auf dem Eis und lässt sich im Auswahlmodus verschieben.
### Schrittsequenzen als Bereich
Eine Schrittsequenz besteht oft aus mehreren Teilstrecken, zählt aber als
**ein** Element mit einem Kürzel, einem Level und einem Basiswert.
**ein** Element mit einem Kürzel, einem Level und einem Basiswert. In der App
entsteht sie, indem die Teilstrecken gezeichnet und anschließend gruppiert
werden:
- Das **Sequenz-Symbol** in der Werkzeugleiste startet den Sequenz-Zeichenmodus.
- Mit **Linie**, **Bogen** oder **Freeline** werden die Teilstrecken
gezeichnet. Die erste Strecke wird das Lead-Segment, alle weiteren treten
derselben Sequenz bei.
- Erneut **Sequenz** drücken oder ein anderes Werkzeug als Linie/Bogen/
Freeline wählen beendet den Bereich. Neue Strecken danach gehören nicht
mehr dazu.
- Eine bestehende Sequenz lässt sich fortsetzen, solange sie am Abschnittsende
liegt: ein Mitglied auswählen, das Sequenz-Symbol drücken und
weiterzeichnen.
- Klickt man ein beliebiges Mitglied an, öffnet der **Element**-Dialog die
ganze Sequenz. Kürzel, Level und Features gelten einmal für alle Teilstrecken.
- Wird das Lead-Segment gelöscht, übernimmt das nächste Mitglied automatisch
die Elementdaten. **Kein Element** im Dialog löst die Gruppe auf; die
gezeichneten Teilstrecken bleiben erhalten.
- Neue Sequenzbereiche starten mit dem Kürzel `StSq` und Level Base; beides
lässt sich im Element-Dialog ändern.
### Nachträglich gruppieren
Bestehende Teilstrecken lassen sich ohne Neuzeichnen zu einer Sequenz
zusammenfassen:
1. **Mehrfachauswahl** im Abschnittsbereich aktivieren.
2. Die gewünschten Segmente antippen. Erneutes Antippen entfernt ein Segment
1. Die Teilstrecken mit **Linie**, **Bogen** oder **Freeline** zeichnen.
2. **Mehrfachauswahl** im Abschnittsbereich aktivieren.
3. Die gewünschten Segmente antippen. Erneutes Antippen entfernt ein Segment
wieder aus der Auswahl. Auf dem Desktop funktioniert auch
**Shift/Cmd/Ctrl + Klick** ohne aktivierte Mehrfachauswahl.
3. **Sequenz gruppieren (N)** drücken.
4. Das **Sequenz-Symbol** (geschweifte Klammer mit Plus) in der
Werkzeugleiste drücken.
Die Auswahl muss aus mindestens zwei **zusammenhängenden** Pfadsegmenten
bestehen und darf keine bestehenden Elemente oder Sprung-/Pirouettenmarker
enthalten. Nach dem Gruppieren wird das Lead-Segment ausgewählt und die
Mehrfachauswahl beendet. Esc bricht die Mehrfachauswahl ab.
- Klickt man ein beliebiges Mitglied an, öffnet der **Element**-Dialog die
ganze Sequenz. Kürzel, Level und Features gelten einmal für alle Teilstrecken.
- Wird das Lead-Segment gelöscht, übernimmt das nächste Mitglied automatisch
die Elementdaten. **Kein Element** im Dialog löst die Gruppe auf; die
gezeichneten Teilstrecken bleiben erhalten.
- Neue Sequenzen starten mit dem Kürzel `StSq` und Level Base; beides lässt
sich im Element-Dialog ändern.
- Einzelne Segmente lassen sich im Element-Dialog auch direkt als Sequenz
taggen; für mehrere Teilstrecken ist das Gruppieren der vorgesehene Weg.
## 3D-Vorschau
Der Button **3D** in der oberen Leiste wechselt in eine schreibgeschützte
@ -160,12 +167,16 @@ Dateiname vermerkt.
- **×** entfernt die Musik aus der Kür, löscht die Datei aber nicht. So
bleibt sie für andere Kürdateien erhalten.
- Dasselbe Stück kann beliebig oft geladen werden: Ist der Inhalt schon im
Kür-Ordner vorhanden, wird die vorhandene Datei weiterverwendet. Eine
Nummer im Namen (`… 2.mp3`) entsteht nur bei echt unterschiedlichem Inhalt
gleichen Namens.
Kür-Ordner vorhanden, wird die vorhandene Datei ohne Nachfrage
weiterverwendet. Gibt es eine gleichnamige Datei mit anderem Inhalt, fragt
die App: **Bestehende verwenden**, **Überschreiben** oder **Abbrechen**.
Nummerierte Kopien wie `… 2.mp3` werden nicht mehr erzeugt.
- Beim **Sync** wird die Musikdatei wie die Kür-JSON hoch- und
heruntergeladen. Fehlt sie auf einem Gerät, zeigt die Leiste
„(fehlt)“; nach dem nächsten Sync ist sie verfügbar.
„(fehlt)“; nach dem nächsten Sync ist sie verfügbar. Ist sie auf beiden
Geräten unterschiedlich, gewinnt die neuere Dateizeit; die ältere Fassung
landet im Konfliktarchiv (Datei → Küren verwalten… → Konfliktkopien →
Konfliktarchiv öffnen).
## Timeline-Labels
@ -193,8 +204,9 @@ läuft sie ab dieser Stelle weiter. Die Position berücksichtigt alle davor lieg
Abschnitte inklusive Element-Standzeiten.
Während der Wiedergabe markiert ein **▶** den aktuellen Abschnitt in der
Liste rechts. Der Name des Abschnitts erscheint kurz oben auf der Eisfläche
und blendet sich innerhalb von zwei Sekunden weich aus.
Liste rechts. Der Name des Abschnitts erscheint als große, schräge
Sport-TV-Bauchbinde bündig am oberen Rand der Eisfläche und gleitet nach
2,6 Sekunden wieder aus.
## Export

View file

@ -1,6 +1,6 @@
# Rinkplanner – Roadmap
Stand: 2026-11-10 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; JSON-Dateiformat, Export-Smoke-Test und Quality-Meilenstein ergänzt; Cloud-Sync vorerst nur mit Dropbox)
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`.
@ -103,12 +103,17 @@ Voraussetzung für Phase 1.
Refresh-Tokens unter `user://`
- [x] Manueller Sync: `.json` je Kür laden/hochladen (Legacy-`.tres` weiterhin),
Sync-Stand lokal
- [x] Konflikte als Kopien mit Server-Zeitstempel behalten
- [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)
- [ ] Konflikt-Zusammenführung in der Oberfläche (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
@ -134,7 +139,8 @@ OAuth-App ist nicht veröffentlicht. Google Drive und OneDrive stehen unter
- [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-Zeichenmodus und Fortsetzen einer bestehenden Gruppe
- [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
@ -190,8 +196,8 @@ 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
- [ ] 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
@ -261,8 +267,13 @@ Schritte.
### Danach
- [ ] Theme-Ressource + zentrale UI-Texte (`tr()`/CSV), kompakte Labels nicht
mehr im Controller; Dark/Light und skalierbare Schriftgrößen.
- [ ] 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

View file

@ -43,9 +43,49 @@ gemeinsamen App-Ordner.
| nur in der Cloud | herunterladen |
| seit dem letzten Sync nur lokal geändert | hochladen |
| seit dem letzten Sync nur in der Cloud geändert | herunterladen |
| beidseitig geändert (seit dem letzten Sync) | **Konflikt**: lokale Fassung bleibt Hauptdatei, Cloud-Fassung kommt als `(Server …)`-Kopie dazu |
| beidseitig geändert (seit dem letzten Sync) | **neueste Fassung gewinnt**: ältere Fassung wandert ins Konfliktarchiv |
| Datei auf einer Seite gelöscht | nichts tun (keine Löschweitergabe) |
| erster Sync, Datei auf beiden Seiten | **Cloud übernimmt**: Cloud-Fassung wird Hauptdatei, lokale Fassung bleibt als `(Lokal …)`-Kopie |
| erster Sync, Datei auf beiden Seiten | **neueste Fassung gewinnt**: ältere Fassung wandert ins Konfliktarchiv |
### Wie entscheidet der Sync, welche Fassung neuer ist?
- Bei `.json`-Küren zählt der **Inhalt**: Jede Speicherung schreibt
`saved_at` (Unix-Zeit) in die Datei. Der Sync lädt die Cloud-Fassung in eine
temporäre Datei und vergleicht beide Zeitstempel. Damit sind
Geräte-Dateizeiten und Upload-Zeitpunkte unerheblich.
- Bei Legacy-`.tres`- und Musikdateien gibt es keinen Inhalt-Zeitstempel.
Dort vergleicht der Sync die lokale Dateizeit mit der Cloud-Änderungszeit.
- Bei Gleichstand oder unbekannten Zeiten gilt: Beim ersten Abgleich ohne
gemeinsamen Stand übernimmt die Cloud-Fassung, bei einem echten Konflikt
bleibt die lokale Fassung.
Kürdateien aus älteren Versionen haben noch kein `saved_at`. Dort greift beim
ersten Abgleich die Dateizeit als Ersatz; ab der nächsten Speicherung trägt
die JSON den Inhalt-Zeitstempel.
Die unterlegene Fassung wird nicht mehr sichtbar neben die Kür gelegt. Sie
landet unter `user://conflicts/<dateiname>` – ein Archivplatz pro Datei, der
bei der nächsten Auflösung überschrieben wird. Erreichbar über
**Datei → Küren verwalten… → Konfliktkopien → Konfliktarchiv öffnen**. So
entstehen keine `(Server …)`-/`(Lokal …)`-Kopien mehr in der Kürliste.
Alte Kopien aus früheren Versionen bleiben zunächst liegen. Über
**Datei → Küren verwalten… → Konfliktkopien → Konfliktkopien suchen…** sucht
der Sync nach solchen Kopien, deren Hauptdatei noch existiert, zeigt sie in
einem Dialog und verschiebt sie nach Bestätigung ins Konfliktarchiv.
Cloud-Kopien werden dabei aus dem Cloud-Ordner gelöscht, damit sie nicht beim
nächsten Sync zurückkommen. Kopien ohne Hauptdatei werden nicht angefasst –
sie könnten die einzige erhaltene Fassung sein.
Normale, nicht mehr benötigte Küren lassen sich ebenfalls über
**Datei → Küren verwalten…** löschen. Die Cloud-Kopie wird auf Wunsch
mitgelöscht; die Musikdatei nur, wenn keine andere Kür sie verwendet.
**Umbenennen** ändert Dateinamen und Titel der Kür. Mit verbundenem
Cloud-Konto wird auch die Cloud-Kopie umbenannt und der alte Sync-Stand
entfernt. Ohne Cloud-Verbindung bleibt die alte Cloud-Kopie bestehen; der
Sync holt sie dank des bisherigen Sync-Stands nicht als zweite Kür zurück,
lädt aber die neue lokale Fassung hoch.
### Wie kommt eine Kür vom Desktop aufs Tablet?
@ -55,28 +95,20 @@ gemeinsamen App-Ordner.
Wichtig: Der Abgleich ordnet Dateien über den **Dateinamen** zu (der aus dem
Kür-Titel entsteht). Eine Kür mit demselben Namen auf beiden Geräten ist
kein „Update“, sondern eine Kollision:
- **Erster Sync einer Datei auf beiden Seiten** (kein gemeinsamer Stand):
Die **Cloud-Fassung übernimmt den Namen**, die lokale Fassung bleibt als
`name (Lokal JJJJ-MM-TT HHMM).json` daneben. So bekommt ein neues Gerät die
gemeinsame Version, ohne die lokale Arbeit zu verlieren.
- **Beide Seiten seit dem letzten Sync geändert**: Die lokale Fassung bleibt
Hauptdatei, die Cloud-Fassung kommt als
`name (Server JJJJ-MM-TT HHMM).json` dazu. Beim nächsten Sync wird diese
Kopie als neue Kür hochgeladen. Zusammenführen musst du selbst.
Die Kopien behalten die Endung der Ausgangsdatei; bei Legacy-`.tres`
entstehen also weiterhin `.tres`-Kopien.
kein „Update“, sondern eine Kollision. Der Sync löst sie anhand des
Inhalt-Zeitstempels auf; die ältere Fassung bleibt im Konfliktarchiv, statt
die Kürliste zu füllen. Bereits vorhandene alte `(Server …)`-/`(Lokal …)`-
Kopien werden nicht automatisch gelöscht.
Wenn du auf dem Tablet also eine leere „Testkür1“ anlegst, obwohl es die
Desktop-Version schon gibt, hast du nach dem Sync zwei Dateien: die
Desktop-Version unter dem normalen Namen und deine leere Fassung als
`testkür1 (Lokal …).json`. Besser: erst synchronisieren, dann die vorhandene
Kür öffnen und bearbeiten.
Desktop-Version schon gibt, gewinnt nach dem Sync die Fassung mit dem
neueren `saved_at`. Besser: erst synchronisieren, dann die vorhandene Kür
öffnen und bearbeiten.
- Vor dem Sync wird eine geänderte, bereits gespeicherte Kür automatisch
gespeichert. Eine noch nie gespeicherte Kür öffnet zuerst „Speichern unter“.
- Läuft der Sync, zeigt die Statusleiste den Fortschritt; danach erscheint
eine Zusammenfassung (hochgeladen / heruntergeladen / Konflikte / Fehler).
eine Zusammenfassung (hochgeladen / heruntergeladen / aufgelöste Konflikte /
Fehler).
- Ist die geöffnete Kür vom Download betroffen und ungespeichert, wird sie
**nicht** überschrieben – es erscheint ein Hinweis.
@ -91,7 +123,7 @@ Kür öffnen und bearbeiten.
| `src/core/sync/cloud_auth.gd` | Refresh-Token, Access-Token-Erneuerung |
| `src/core/sync/cloud_oauth_job.gd` | Google-Device-Flow und Dropbox-PKCE-Flow |
| `src/core/sync/sync_app_config.gd` | App-Client-ID/App-Key laden |
| `src/core/sync/sync_plan.gd` | reine Vergleichslogik, Konfliktnamen, Zeitstempel |
| `src/core/sync/sync_plan.gd` | reine Vergleichslogik, Zeitstempel, Gleichstandsregel |
| `src/core/sync/routine_sync.gd` | Ablauf, Datei-Ersetzung, Sync-Stand |
- Der Sync läuft in einem `Thread`; die Oberfläche bleibt bedienbar und
@ -108,8 +140,9 @@ Kür öffnen und bearbeiten.
- Musikdateien werden als normale Anhänge der Kür behandelt: Die JSON nennt
nur den Dateinamen (`music_file`), die Datei liegt daneben. Ändert sich die
Musik auf einem Gerät, lädt der nächste Sync sie hoch; auf dem anderen Gerät
wird sie heruntergeladen und beim Öffnen der Kür verwendet. Konfliktkopien
behalten die Audio-Endung (z. B. `kuer (Server …).mp3`).
wird sie heruntergeladen und beim Öffnen der Kür verwendet. Bei einer
Kollision gewinnt die neuere Dateizeit; die ältere landet unter
`user://conflicts/`.
- Eigene Timeline-Labels stehen in der Kür-JSON (`timeline_labels`) und
werden ohne Zusatzdateien mit der Kür übertragen.
- Refresh-Tokens liegen in `user://sync.cfg` (Klartext, app-privat). Auf
@ -140,8 +173,8 @@ Werte in `docs/credentials.txt` stehen in
## Grenzen
- Kein automatischer Sync, kein Push, kein Locking. Zwei Geräte, die
gleichzeitig synchronisieren, können sich überholen; der Konfliktfall
verhindert dann Datenverlust, nicht aber doppelte Dateien.
gleichzeitig synchronisieren, können sich überholen; der Sync behält dann
die neuere Fassung und legt die ältere ins Konfliktarchiv.
- Löschungen werden nicht übertragen (bewusst, um Versehen nicht zu
multiplizieren).
- Umbenennen einer Kür wirkt wie „neu lokal“ + „nur Cloud“: beide Fassungen