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:
parent
dbcba27ebd
commit
6172d311bc
25 changed files with 2993 additions and 820 deletions
81
docs/sync.md
81
docs/sync.md
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue