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

@ -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