feat: Cloud-Sync über Dropbox und Google Drive

- FTP-Sync durch Cloud-Backends ersetzt (Dropbox, Google Drive)
- OAuth-Flow mit nutzereigenen Tokens und App-Key-Konfiguration
- Zeit-Tooltips für Timeline-Labels und Abschnittsbanner beim Playback
- Tests, Build-Konfiguration und Doku aktualisiert
This commit is contained in:
torsten 2026-11-09 06:25:21 +01:00
parent 533a12ef1a
commit 74d9d6b61f
36 changed files with 3040 additions and 817 deletions

View file

@ -339,14 +339,17 @@ Fahrtrichtung.
sichtbar sind. Punktmarker halten die Ankunftsrichtung, Pirouetten drehen
den Marker während der Standzeit mit 1,5 Umdrehungen pro Sekunde. Während
des Playbacks wird die aktuelle Section hervorgehoben,
ohne die Bearbeitungs-Section zu wechseln. Steuerung: Play/Pause, Reset,
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: Play/Pause, Reset,
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Ein optionales
Musikstück (MP3/OGG/WAV) liegt neben der Kür-JSON in `user://routines/`
und läuft über einen `AudioStreamPlayer` auf derselben Zeitbasis: 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
Elemente mit 0 s Standzeit); ein Klick in die Spur legt ein eigenes,
Elemente mit 0 s Standzeit); beim Überfahren zeigt ein Tooltip den
Zeitpunkt im Track. Ein Klick in die Spur legt ein eigenes,
frei beschriftetes Timeline-Label an, das per Klick wieder bearbeitet oder
gelöscht werden kann. Ein Wechsel des aktiven Abschnitts setzt Marker,
Timeline-Slider und Label-Spur an den Anfang dieses Abschnitts; eine
@ -483,14 +486,17 @@ ggf. eines nach `touchend` (300-ms-Guard).
- **Lokale Daten:** `user://` liegt pro Plattform getrennt (Linux
`~/.local/share/godot/app_userdata/Rinkplanner/`, Android im
app-internen Speicher).
- **Kontosync:** manueller FTP-/FTPS-Abgleich der `.json`- und
Legacy-`.tres`-Dateien über `FtpClient`, `SyncPlan` und `RoutineSync`;
Details in `docs/sync.md`. Zugangsdaten liegen in `user://sync.cfg`, der
letzte gemeinsame Stand in `user://sync_state.cfg`. Beim ersten Abgleich
einer beidseitig vorhandenen Datei übernimmt die Serverfassung den Namen,
die lokale bleibt als `(Lokal …)`-Kopie; bei einem echten Konflikt bleibt
die lokale Fassung Hauptdatei und die Serverfassung kommt als
`(Server …)`-Kopie dazu. Konfliktnamen behalten die jeweilige Endung.
- **Kontosync:** manueller Cloud-Abgleich der `.json`- und
Legacy-`.tres`-Dateien über `RemoteStore`, `DropboxStore`,
`GoogleDriveStore`, `SyncPlan` und `RoutineSync`; Details in
`docs/sync.md`, Einrichtung der OAuth-Apps in `docs/cloud-setup.md`.
Jeder Nutzer verbindet sein eigenes Google-Drive- oder Dropbox-Konto;
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.
## 7. Tests
@ -542,10 +548,10 @@ 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:** 45 Assertions für Dauer/Timeline, Vorwärts-/Rückwärts-
Blickrichtung, Section-Hervorhebung, Play/Pause/Reset inklusive
- **Playback:** 99 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 und die Rotation des Markers in einer Pirouette.
Elementen, Markerrotation in einer Pirouette sowie Timeline-Tooltips.
- **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,
@ -558,11 +564,11 @@ Aktueller Stand:
Leistenlayout bei 1024 und 1400 px.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms).
- **Sync:** 34 Assertions für Vergleichsregeln, Konfliktnamen (JSON und
Legacy-`.tres`), Zeitstempel, PASV/EPSV/MDTM-Parsing, Sync-Stand und die
Einstellungs-Verdrahtung.
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
(Upload, Download, Übernahme, Konflikt, Aufräumen).
- **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,
Platzierung, Rig-Metadaten, Animationen, Hashes und – falls synchronisiert
– Größe, SHA-256 sowie die 8-Bone-Gewichte der GLB-Datei.
@ -615,8 +621,7 @@ Viewport-Screenshot; sie ersetzen die headless Tests nicht.
sich im Praxisbetrieb.
9. **Dateinamen:** Die Normalisierung ersetzt Leerzeichen und entfernt
Pfadzeichen, transliteriert aber keine Umlaute. Für Windows und den
geplanten FTP-Sync ist zu prüfen, ob eine ASCII-Normalisierung robuster
ist.
Cloud-Sync ist zu prüfen, ob eine ASCII-Normalisierung robuster ist.
10. **Snapshot-Clone:** `_clone_routine()` kopiert die Modellfelder manuell.
Neue Felder am Modell müssen dort ergänzt werden, sonst fehlen sie in
Undo/Redo-Snapshots.

View file

@ -27,6 +27,11 @@ Texturen in den Exporten liegt (`docs/assets.md`), sind die Builds etwa
Export den Platzhalter.
- Export-Templates derselben Version unter
`~/.local/share/godot/export_templates/4.7.2.stable/`
- Für den Cloud-Sync: `rinkplanner/sync_apps.cfg` mit den OAuth-App-Zugängen.
Die Datei wird aus `docs/credentials.txt` erzeugt:
`./tools/sync_apps_config.sh`; Einrichtung in `docs/cloud-setup.md`.
Ohne die Datei baut die App, zeigt beim Verbinden aber einen
Konfigurationshinweis.
- Für Android zusätzlich JDK 17 + Android SDK (siehe unten)
## Desktop bauen
@ -200,7 +205,9 @@ auf `tools/sync_assets.sh --sync` ab. Für einen reinen Starttest ohne
## Kontosync
Der manuelle Sync über FTP lädt die neuesten `.json`-Dateien
(Legacy-`.tres` weiterhin) je Kür hoch bzw. herunter, Konflikte bleiben als
Kopien mit Zeitstempel erhalten. Zugangsdaten liegen in den
App-Einstellungen (`user://`), nicht im Repository.
Der manuelle Sync über Google Drive oder 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 Cloud-Konto; Refresh-Tokens liegen in den App-Einstellungen
(`user://`), nicht im Repository. Details in `docs/sync.md` und
`docs/cloud-setup.md`.

238
docs/cloud-setup.md Normal file
View file

@ -0,0 +1,238 @@
# Cloud-Sync einrichten (Google Drive / Dropbox)
Rinkplanner speichert Kürdateien und Musik im **eigenen Cloud-Konto jedes
Nutzers**. Dafür registriert der Entwickler einmalig eine OAuth-App pro
Anbieter. Nutzer melden sich in ihrem Browser mit ihrem eigenen Konto an; die
App sieht niemals deren Passwort.
## Warum keine E-Mail-/Passwort-Anmeldung?
Google Drive und Dropbox haben die Anmeldung mit Benutzername und Passwort
über ihre APIs abgeschaltet. Ein `GOOGLE_PASSWORD` oder `DROPBOX_PASSWORD` in
`docs/credentials.txt` kann deshalb nicht verwendet werden. Nötig sind:
- eine **App-Registrierung** (Client-ID/App-Key) für Rinkplanner,
- pro Nutzer ein **Refresh-Token** aus dem OAuth-Flow.
Die App-Registrierung ist öffentlich (vergleichbar mit einem Paketnamen). Der
Refresh-Token ist das eigentliche Geheimnis und bleibt auf dem Gerät des
Nutzers in `user://sync.cfg`.
## Google Drive
1. In der [Google Cloud Console](https://console.cloud.google.com/) ein
Projekt anlegen (z. B. `Rinkplanner`).
2. **APIs & Dienste → Bibliothek → Google Drive API** aktivieren.
3. **OAuth-Zustimmungsbildschirm** einrichten:
- Nutzertyp **Extern**
- App-Name `Rinkplanner`, Support- und Entwickler-E-Mail
- Scopes:
- `https://www.googleapis.com/auth/drive.file`
- `openid`
- `email`
- Solange die App im Status **Testing** ist, müssen Testkonten unter
„Testnutzer“ eingetragen werden. Refresh-Tokens aus dem Testing-Status
laufen nach sieben Tagen ab; für den Dauerbetrieb die App
veröffentlichen („In Produktion“).
4. **Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID**:
- Anwendungstyp **TVs and Limited Input devices** (Device Flow).
- Die Client-ID und das Client-Secret notieren.
5. Werte in `docs/credentials.txt` eintragen:
```ini
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
```
6. `./tools/sync_apps_config.sh` ausführen. Das schreibt die App-Werte nach
`rinkplanner/sync_apps.cfg` (gitignored, wird in den Build eingebettet).
`drive.file` ist ein nicht-sensibler Scope: Die App darf nur Dateien sehen,
die sie selbst angelegt hat. Sie kann nicht das übrige Google Drive des
Nutzers lesen. Rinkplanner legt dafür den Ordner `Rinkplanner` an.
## Dropbox
1. In der [Dropbox App Console](https://www.dropbox.com/developers/apps) eine
App anlegen.
2. **Zugriffstyp: App folder** (nicht „Full Dropbox“). Damit landet alles in
`Apps/<App-Name>/` und Rinkplanner sieht keine anderen Dateien. Der
App-Name bestimmt den Ordnernamen; nach der Produktionsfreigabe ist er
nicht mehr änderbar.
3. **Permissions** setzen:
- `files.content.read` (Download)
- `files.content.write` (Upload/Überschreiben)
- `files.metadata.read` (Ordner auflisten)
- `files.metadata.write` (Zielordner anlegen, umbenennen, löschen)
- `account_info.read` (nur für die Anzeige der Konto-E-Mail)
Änderungen mit **Save changes** speichern. Bereits verbundene Konten
müssen sich danach neu verbinden, weil der Token die alten Rechte behält.
4. **Settings → OAuth 2**:
- **Redirect-URI leer lassen** (wir nutzen den Code-Flow ohne Redirect).
- **Allow public clients / PKCE** aktivieren, falls vorhanden.
5. **App Key** notieren. Ein App Secret ist für den PKCE-Flow nicht nötig;
optional kann es ebenfalls eingetragen werden.
6. Werte in `docs/credentials.txt` eintragen:
```ini
DROPBOX_APP_KEY=...
# optional:
DROPBOX_APP_SECRET=...
```
7. `./tools/sync_apps_config.sh` ausführen.
8. **Settings → App configuration → Development users**: **Enable additional
users** aktivieren, sonst kann nur dein eigenes Dropbox-Konto die App
verbinden. In der Development-Phase sind bis zu 500 Nutzer möglich.
Der Dropbox-Flow nutzt **PKCE ohne Redirect-URI**: Nach der Anmeldung zeigt
Dropbox einen Autorisierungscode an, den der Nutzer in Rinkplanner einfügt.
Das funktioniert auf Desktop und Android ohne lokalen Callback-Server.
## Veröffentlichungsstatus: Testing vs. Produktion
„Veröffentlichen“ ist keine Veröffentlichung im App-Store, sondern der
Wechsel der OAuth-App vom Test- in den Produktivstatus beim jeweiligen
Anbieter. Das ist nötig, damit Tokens nicht ablaufen und beliebig viele
Nutzer das Konto verbinden können.
### Google Drive
| | Testing | In Produktion |
| :--- | :--- | :--- |
| Nutzer | max. 100 Testnutzer | beliebige Google-Konten |
| Refresh-Token | **läuft 7 Tage nach der Zustimmung ab** | bleibt gültig, bis der Nutzer den Zugriff widerruft |
| Warnung | „Ungeprüfte App“ möglich | für `drive.file` in der Regel keine Scope-Prüfung |
Die 7-Tage-Regel gilt, weil Rinkplanner neben `openid`/`email` auch
`drive.file` anfragt. Die Ausnahme für reine Anmelde-Scopes greift hier
nicht.
**Konkret zu tun:**
1. Im Google-Cloud-Projekt unter **Google Auth Platform → Branding**:
App-Name, Support-E-Mail, Entwicklerkontakt, Startseite, Datenschutz-URL
und autorisierte Domain eintragen. Diese Links sind für externe
Produktions-Apps erforderlich.
2. Unter **Audience** auf **Publish app** klicken. Der Status wechselt zu
**In production**.
3. Eine **Markenprüfung** kann nötig sein, damit Name und Logo auf dem
Zustimmungsbildschirm erscheinen. Sie ist kein Security-Audit und dauert
laut Google meist nur Minuten, kann aber einige Tage brauchen.
4. Eine **Datenzugriffsprüfung** ist für `drive.file` nicht erforderlich,
weil der Scope als nicht-sensibel gilt. Ein teures Security-Assessment
ist damit nicht verbunden.
5. Nutzer, die schon im Testing-Status verbunden waren, müssen sich nach
dem Veröffentlichen **einmal neu verbinden**, damit sie einen
langlebigen Refresh-Token erhalten.
Kosten: keine. Google verlangt für `drive.file` keine Verifikationsgebühr.
Wenn nur du und ein paar Testgeräte den Sync nutzen, kannst du im
Testing-Status bleiben – dann muss jedes Gerät wöchentlich neu verbinden.
Für den echten Betrieb ist „In production“ die richtige Wahl.
### Dropbox
| | Development | Production |
| :--- | :--- | :--- |
| Nutzer | bis 500 verbundene Dropbox-Konten | unbegrenzt |
| Review | erst ab 50 verbundenen Nutzern (oder early review) | erforderlich |
| App-Name | änderbar | **nach der Freigabe nicht mehr änderbar** |
**Konkret zu tun:**
1. In der Dropbox App Console unter **Branding** ein App-Icon hinterlegen.
2. Unter **Settings → App configuration → Apply for production** den Antrag
ausfüllen: wie die App die API nutzt, warum App-Folder-Zugriff reicht,
Datenschutz-URL usw.
3. Der Antrag wird regulär erst geprüft, wenn die App **50 Nutzer** verbunden
hat. Ab 50 Nutzern hast du zwei Wochen Zeit, die Produktionsfreigabe zu
erhalten; sonst werden weitere Verbindungen blockiert.
4. Nach der Freigabe sind unbegrenzt viele Nutzer möglich. Der App-Name
bleibt dann fest.
Für eine kleine geschlossene Testgruppe reicht Development. Sobald
Rinkplanner an mehr als 50 Personen geht, sollte der Produktionsantrag
vorbereitet sein.
Wichtig für die Musik: Dropbox genehmigt keine Apps, die
Urheberrechtsverletzungen fördern. Rinkplanner stellt keine Dateien bereit
und teilt keine Musik zwischen Nutzern; die App sollte auch im Store-Text
nicht so beworben werden. Musik im eigenen Konto des Nutzers ist der
vorgesehene Fall.
## App-Werte ohne Repository-Datei
`SyncAppConfig` liest die App-Zugänge in dieser Reihenfolge (spätere Quellen
überschreiben frühere):
1. Umgebungsvariablen
`RINKPLANNER_GOOGLE_CLIENT_ID`, `RINKPLANNER_GOOGLE_CLIENT_SECRET`,
`RINKPLANNER_DROPBOX_APP_KEY`, `RINKPLANNER_DROPBOX_APP_SECRET`
2. `res://sync_apps.cfg` (beim Build eingebettet)
3. `user://sync_apps.cfg` (lokale Entwickler-Installation)
Für Release-Builds muss `rinkplanner/sync_apps.cfg` vor dem Export existieren.
Fehlt sie, startet die App normal, zeigt beim Verbinden aber einen Hinweis,
dass der Cloud-Sync in diesem Build nicht eingerichtet ist.
Die Datei wird am besten mit `./tools/sync_apps_config.sh` erzeugt. Godots
`ConfigFile`-Format erwartet Kommentare mit `;` und Strings in
Anführungszeichen (`dropbox_app_key="..."`); `#`-Kommentare oder unquoted
Werte führen zu einem Parse-Fehler.
## Nutzerfluss in der App
1. **Datei → Sync-Einstellungen…**
2. Anbieter wählen (Dropbox oder Google Drive).
3. **Verbinden…**:
- Google Drive: Rinkplanner zeigt einen Code und öffnet die
Google-Anmeldeseite. Nach der Bestätigung schließt sich der Dialog.
- Dropbox: Rinkplanner öffnet die Dropbox-Seite. Den dort angezeigten Code
in die App einfügen und **Verbinden** drücken.
4. Cloud-Ordner festlegen. Bei Dropbox leer lassen, dann liegt alles direkt
im App-Ordner `Apps/<App-Name>`. Bei Google Drive legt die App den Ordner
`Rinkplanner` an.
5. **Speichern**, danach **Datei → Jetzt synchronisieren**.
Jedes Gerät (Desktop und Tablet) wird einmal verbunden. Beide Geräte können
dasselbe Konto verwenden; der Abgleich läuft über den Cloud-Ordner.
## Lizenzen und Musikdateien
- Musikdateien werden ausschließlich im Konto des Nutzers gespeichert.
Rinkplanner betreibt keinen Speicher und keine zentrale Kopie.
- Die App greift bei Google Drive nur auf `drive.file`-Dateien zu, bei Dropbox
nur auf den App-Ordner. Es gibt keinen Zugriff auf fremde Konten.
- Es gibt kein gemeinsames Rinkplanner-Konto, über das Musik weitergegeben
würde. Jeder Nutzer ist für die Rechte an seinen hochgeladenen Dateien
selbst verantwortlich.
- In der App und in der Datenschutzerklärung sollte dieser Hinweis stehen:
„Musikdateien werden im eigenen Cloud-Konto gespeichert. Für die
Nutzungsrechte ist der Nutzer verantwortlich.“
## Sicherheit
- Nutzerpasswörter werden nie abgefragt und nie gespeichert.
- Refresh-Tokens liegen in `user://sync.cfg` (app-privat). Auf Android ist das
der interne App-Speicher; auf dem Desktop
`~/.local/share/godot/app_userdata/Rinkplanner/`.
- **Trennen** in den Sync-Einstellungen löscht den Token auf dem Gerät. Die
Cloud-Dateien bleiben erhalten.
- Ein widerrufener Zugriff führt beim nächsten Sync zu einer verständlichen
Fehlermeldung; anschließend neu verbinden.
- Das Google-Client-Secret ist bei installierten Apps nicht geheim. Es
identifiziert die App, nicht den Nutzer. Dropbox nutzt PKCE und kommt ohne
Secret aus.
## Veröffentlichung
- Google: OAuth-Zustimmungsbildschirm veröffentlichen. `drive.file` ist
nicht-sensibel; trotzdem können Angaben zu Datenschutz und
Entwickleridentität verlangt werden.
- Dropbox: Produktionszugriff in der App Console beantragen. App-Folder-Apps
haben vor der Freigabe ein Nutzerlimit.
- Für Stores eine Datenschutzerklärung hinterlegen, die den Cloud-Zugriff und
die Musikverantwortung beschreibt.

View file

@ -1,15 +1,37 @@
# Vorlage für den FTP-Zugang (nie mit echten Werten einchecken).
# Vorlage für Entwickler-Zugänge (nie mit echten Werten einchecken).
# Die echte Datei heißt docs/credentials.txt und ist in .gitignore eingetragen.
#
# Format: KEY=WERT, eine Zuweisung pro Zeile. '#' startet einen Kommentar.
#
# ---------------------------------------------------------------------------
# FTP: nur noch für tools/sync_assets.sh --publish (Asset-Verteilung).
# Der Kür-Sync der App nutzt FTP nicht mehr.
# ---------------------------------------------------------------------------
# FTP_URL: Hostname oder URL des FTP-Servers, z. B. ftp.example.org
# (Schema und Port sind optional: ftp://host:21)
# FTP_USER: Benutzername des FTP-Kontos
# FTP_PASSWORD: Passwort des FTP-Kontos
# FTP_DIRECTORY: Zielverzeichnis relativ zum Login-Verzeichnis, z. B. rinkplanner
FTP_URL=ftp.example.org
FTP_USER=benutzer
FTP_PASSWORD=passwort
FTP_DIRECTORY=rinkplanner
# ---------------------------------------------------------------------------
# Cloud-Sync: OAuth-Apps von Rinkplanner (eine App je Anbieter, nicht je Nutzer)
# ---------------------------------------------------------------------------
# Die App-Zugänge werden mit tools/sync_apps_config.sh nach
# rinkplanner/sync_apps.cfg übernommen und beim Build eingebettet.
# Jeder Nutzer verbindet danach sein eigenes Google-/Dropbox-Konto in der App.
# E-Mail/Passwörter der Nutzer werden dafür nicht benötigt und nicht gespeichert.
#
# GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET:
# OAuth-Client vom Typ "TVs and Limited Input devices" (Device Flow) in der
# Google Cloud Console. Scope: https://www.googleapis.com/auth/drive.file
# DROPBOX_APP_KEY:
# App Key einer Dropbox-App mit "App folder"-Zugriff (Scoped access).
# DROPBOX_APP_SECRET:
# Optional; der PKCE-Flow funktioniert auch ohne Secret.
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
DROPBOX_APP_KEY=
DROPBOX_APP_SECRET=

View file

@ -91,6 +91,8 @@ Kür-Ordner kopiert und in der Kür-JSON als Dateiname vermerkt.
an diesem Zeitpunkt an; der Text wird im Dialog eingegeben.
- **Bearbeiten:** Ein Klick auf ein goldenes eigenes Label öffnet den Dialog
erneut. Dort lässt es sich umbenennen oder löschen.
- **Zeit-Tooltip:** Beim Überfahren eines Element-Labels zeigt ein Tooltip
dessen Zeitpunkt im Track, z. B. `1A · 12,3 s`.
- Labels gehören zur Kür, werden mitgespeichert und über Undo/Redo sowie den
Sync mitgeführt.
@ -102,6 +104,10 @@ Eine laufende Wiedergabe wird dabei angehalten; mit **Start** läuft sie ab
dieser Stelle weiter. Die Position berücksichtigt alle davor liegenden
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.
## Export
**Datei → Exportieren…** schreibt nach `user://exports/`. Zur Wahl stehen:

View file

@ -30,7 +30,7 @@ Voraussetzung für Phase 1.
- [x] Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und
Geschwindigkeit 0,25×–2,0×
- [x] Musikstück (MP3/OGG/WAV) je Kür laden; Wiedergabe, Scrubbing und
Geschwindigkeit laufen synchron zum Läufer; der FTP-Sync überträgt die
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
@ -96,13 +96,14 @@ Voraussetzung für Phase 1.
### Erledigt: Kontosync (Desktop ↔ Tablet)
- [x] Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort,
Verzeichnis, FTPS, Zertifikatsprüfung), Zugangsdaten unter `user://`
- [x] Sync-Einstellungen in der App (Anbieter, Konto verbinden/trennen,
Cloud-Ordner), 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] Fortschritt und Zusammenfassung in der Oberfläche
- [x] FTP/FTPS-Client ohne externe Bibliothek
- [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)
@ -164,15 +165,14 @@ Voraussetzung für Phase 1.
### Zurückgestellt bis nach dem Proof-of-Concept
Wir sind bewusst noch im PoC. Der bestehende FTP-Sync und die aktuelle
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
- [ ] 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)
- [ ] 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
Übernahme des Feedbacks der Tester

View file

@ -1,35 +1,41 @@
# Kontosync über FTP
# Kür-Sync über Cloud-Speicher
Der Abgleich zwischen Desktop und Tablet läuft **manuell** über einen
FTP-Zugang. Es gibt kein Konto im Sinne einer Anmeldung auf einem Server:
Die Zugangsdaten sind das „Konto“, jedes Gerät bekommt dieselben Daten.
Der Abgleich zwischen Desktop und Tablet läuft **manuell** über den eigenen
Cloud-Speicher des Nutzers: Google Drive oder Dropbox. Es gibt kein Konto auf
einem Rinkplanner-Server. Jeder Nutzer verbindet sein eigenes Konto; die App
speichert nur den Refresh-Token lokal auf dem Gerät.
## Einrichten
1. Auf beiden Geräten: **Datei → Sync-Einstellungen…**
2. Eintragen:
- **Server** – Hostname des FTP-Servers (ohne `ftp://`)
- **Port** – normalerweise 21
- **Benutzer / Passwort**
- **Verzeichnis** – Zielordner relativ zum Login, z. B. `rinkplanner`
3. **FTPS** eingeschaltet lassen (empfohlen).
4. **Server-Zertifikat prüfen** nur abschalten, wenn der Hoster ein
abweichendes Zertifikat nutzt (bei Shared Hosting häufig). Die Verbindung
bleibt verschlüsselt, der Server wird dann aber nicht kryptografisch
bestätigt.
2. **Anbieter** wählen: Dropbox oder Google Drive.
3. **Verbinden…** drücken und im Browser mit dem eigenen Konto anmelden:
- **Google Drive:** Die App zeigt einen Code und öffnet die
Google-Anmeldeseite. Nach der Bestätigung im Browser schließt sich der
Dialog automatisch.
- **Dropbox:** Die App öffnet die Dropbox-Seite. Den dort angezeigten Code
in das Feld einfügen und **Verbinden** drücken.
4. **Cloud-Ordner** festlegen. Bei Dropbox ist das standardmäßig der
App-Ordner selbst (`Apps/<App-Name>`); bei Google Drive legt die App
standardmäßig den Ordner `Rinkplanner` an. Ein leerer Eintrag bedeutet
„Cloud-Hauptordner des Anbieters“.
5. **Speichern**.
Danach **Datei → Jetzt synchronisieren**.
Auf dem Tablet muss das Konto ebenfalls einmal verbunden werden. Beide Geräte
können dasselbe Google-/Dropbox-Konto verwenden; der Abgleich läuft über den
gemeinsamen Cloud-Ordner.
## Was passiert
- Jede Kür liegt als `.json` unter `user://routines/` und wird 1:1 in das
FTP-Verzeichnis gespiegelt (flach, keine Unterordner). Gehört eine
Musikdatei zur Kür (`.mp3`, `.ogg`, `.wav`), liegt sie im selben Ordner und
wird mit denselben Regeln hoch- und heruntergeladen. Legacy-`.tres`-
Dateien werden weiterhin mit synchronisiert, damit bestehende Installationen
ihre Serverkopien nicht verlieren; neue Speicherungen schreiben `.json`.
Beim Laden wird eine `.tres` vor dem `ResourceLoader` gegen eine Whitelist
- Jede Kür liegt als `.json` unter `user://routines/` und wird 1:1 in den
Cloud-Ordner gespiegelt (flach, keine Unterordner). Gehört eine Musikdatei
zur Kür (`.mp3`, `.ogg`, `.wav`), liegt sie im selben Ordner und wird mit
denselben Regeln hoch- und heruntergeladen. Legacy-`.tres`-Dateien werden
weiterhin mit synchronisiert, damit bestehende Installationen ihre
Cloud-Kopien nicht verlieren; neue Speicherungen schreiben `.json`. Beim
Laden wird eine `.tres` vor dem `ResourceLoader` gegen eine Whitelist
geprüft (nur Modellskripte, kein eingebettetes GDScript).
- Der Sync vergleicht pro Datei den letzten gemeinsamen Stand
(`user://sync_state.cfg`) mit den aktuellen Zeitstempeln:
@ -37,12 +43,12 @@ Danach **Datei → Jetzt synchronisieren**.
| Lage | Aktion |
| :--- | :--- |
| nur lokal, noch nie synchronisiert | hochladen |
| nur auf dem Server | herunterladen |
| nur in der Cloud | herunterladen |
| seit dem letzten Sync nur lokal geändert | hochladen |
| seit dem letzten Sync nur auf dem Server geändert | herunterladen |
| beidseitig geändert (seit dem letzten Sync) | **Konflikt**: lokale Fassung bleibt Hauptdatei, Serverfassung kommt als `(Server …)`-Kopie dazu |
| 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 |
| Datei auf einer Seite gelöscht | nichts tun (keine Löschweitergabe) |
| erster Sync, Datei auf beiden Seiten | **Server übernimmt**: Serverfassung wird Hauptdatei, lokale Fassung bleibt als `(Lokal …)`-Kopie |
| erster Sync, Datei auf beiden Seiten | **Cloud übernimmt**: Cloud-Fassung wird Hauptdatei, lokale Fassung bleibt als `(Lokal …)`-Kopie |
### Wie kommt eine Kür vom Desktop aufs Tablet?
@ -55,11 +61,11 @@ 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 **Serverfassung übernimmt den Namen**, die lokale Fassung bleibt als
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 Serverfassung kommt als
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`
@ -81,20 +87,27 @@ Kür öffnen und bearbeiten.
| Datei | Aufgabe |
| :--- | :--- |
| `src/core/sync/ftp_client.gd` | FTP/FTPS-Client (USER/PASS, AUTH TLS + PROT P, EPSV/PASV, MLSD, SIZE, RETR, STOR, DELE, MKD, RNFR/RNTO) |
| `src/core/sync/remote_store.gd` | gemeinsame Schnittstelle der Cloud-Anbieter |
| `src/core/sync/dropbox_store.gd` | Dropbox-API (App-Ordner, `files/list_folder`, `files/upload`, `files/download`, `files/move_v2`) |
| `src/core/sync/google_drive_store.gd` | Google-Drive-API v3 (`drive.file`-Scope, Ordner `Rinkplanner`, Multipart-Upload, `alt=media`-Download) |
| `src/core/sync/cloud_http.gd` | blockierender HTTPS-Client für den Worker-Thread |
| `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/routine_sync.gd` | Ablauf, Datei-Ersetzung, Sync-Stand |
- Der Sync läuft in einem `Thread`; die Oberfläche bleibt bedienbar und
pollt den Fortschritt in `_process`.
- Uploads gehen zuerst nach `name.uploading` und werden dann umbenannt
(falls der Server das verweigert: direkter Upload).
- Cloud-Uploads sind einzelne, atomare HTTP-Anfragen (Dropbox
`files/upload` mit `mode: overwrite`, Google Drive Multipart-Upload). Ein
zusätzliches `.uploading`-Umbenennen wie beim alten FTP-Sync entfällt.
- Downloads landen in `name.part` und ersetzen die Zieldatei erst danach.
- Heruntergeladene `.json`-Dateien werden als JSON validiert; Legacy-`.tres`
laufen vor dem Laden durch die Whitelist in `RoutineFile`. Ein präparierter
Server kann damit keine eingebetteten GDScripts ausführen.
laufen vor dem Laden durch die Whitelist in `RoutineFile`. Ein manipuliertes
Cloud-Konto kann damit keine eingebetteten GDScripts ausführen.
- Neue Speicherungen sind JSON; der Sync akzeptiert weiterhin `.tres`, damit
bestehende Dateien auf Server und Tablet nicht verschwinden.
bestehende Dateien in der Cloud und auf dem Tablet nicht verschwinden.
- 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
@ -102,22 +115,30 @@ Kür öffnen und bearbeiten.
behalten die Audio-Endung (z. B. `kuer (Server …).mp3`).
- Eigene Timeline-Labels stehen in der Kür-JSON (`timeline_labels`) und
werden ohne Zusatzdateien mit der Kür übertragen.
- Zugangsdaten liegen in `user://sync.cfg` (Klartext, app-privat). Auf
- Refresh-Tokens liegen in `user://sync.cfg` (Klartext, app-privat). Auf
Android ist das der interne App-Speicher, auf dem Desktop
`~/.local/share/godot/app_userdata/Rinkplanner/`.
`~/.local/share/godot/app_userdata/Rinkplanner/`. Nutzerpasswörter werden
nicht gespeichert. Nach einem Kontowechsel oder Anbieterwechsel wird
`user://sync_state.cfg` zurückgesetzt, damit alte Zeitstempel keinen
falschen Konflikt auslösen.
- Android braucht die `INTERNET`-Berechtigung – ist im APK gesetzt.
## Erfahrungen mit dem Zielserver
## Datenschutz und Musiklizenzen
- Der Server spricht explizites FTPS (`AUTH TLS`), außerdem `MLST`, `MDTM`,
`MFMT` und `EPSV` – genau das, was der Abgleich braucht.
- Sein TLS-Zertifikat passt nicht zum Hostnamen (leeres CN/SAN). Deshalb muss
„Server-Zertifikat prüfen“ ausgeschaltet werden; die Übertragung bleibt
verschlüsselt.
- Der Zielordner existiert in Kleinschreibung. Die App wechselt direkt
hinein und legt ihn bei Bedarf per `MKD` an.
- Ein vollständiger Testlauf (Upload, Überspringen, Download, Übernahme,
Konflikt, Aufräumen) lief gegen den echten Server erfolgreich.
- Bei Google Drive nutzt die App den Scope `drive.file`: Sie sieht nur
Dateien, die Rinkplanner selbst angelegt hat, nicht das übrige Drive.
- Bei Dropbox ist die App auf einen **App-Ordner** beschränkt.
- Musikdateien werden im Konto des Nutzers gespeichert. Es gibt keinen
zentralen Rinkplanner-Speicher und keine Weitergabe zwischen Konten. Die
Verantwortung für die Nutzungsrechte liegt beim Nutzer.
- Die App zeigt diesen Hinweis in den Sync-Einstellungen und sollte ihn auch
in der Datenschutzerklärung für Stores führen.
## Einrichtung der OAuth-Apps
Die App-Registrierung bei Google und Dropbox, die nötigen Scopes und die
Werte in `docs/credentials.txt` stehen in
[`docs/cloud-setup.md`](cloud-setup.md).
## Grenzen
@ -126,7 +147,23 @@ Kür öffnen und bearbeiten.
verhindert dann Datenverlust, nicht aber doppelte Dateien.
- Löschungen werden nicht übertragen (bewusst, um Versehen nicht zu
multiplizieren).
- Umbenennen einer Kür wirkt wie „neu lokal“ + „nur Server“: beide Fassungen
- Umbenennen einer Kür wirkt wie „neu lokal“ + „nur Cloud“: beide Fassungen
landen nebeneinander.
- Sehr große Kürsammlungen werden vollständig verglichen; für hunderte
Dateien ist das noch unkritisch, für tausende wäre ein Manifest sinnvoll.
- Dropbox-Uploads sind auf 150 MB pro Datei begrenzt (App-Ordner-Apps). Für
Kür-JSONs und übliche Musikdateien reicht das; größere Dateien müssten
chunked hochgeladen werden.
- Google Drive erlaubt technisch mehrere Dateien mit demselben Namen. Der
Sync sucht die erste passende Datei und führt bestehende Duplikate aus
anderen Quellen nicht zusammen.
## Migration vom FTP-Sync
Der frühere FTP-/FTPS-Sync ist entfernt. Alte `user://sync.cfg`-Einträge
(`host`, `port`, `user`, `password`, `ftps`, `verify_certificate`) werden
ignoriert; beim ersten Öffnen der Sync-Einstellungen muss ein Cloud-Konto
verbunden werden. Die Dateien im alten FTP-Verzeichnis werden nicht
automatisch übernommen: Wer sie behalten will, kopiert sie einmalig manuell
in den Cloud-Ordner oder verbindet beide Geräte mit demselben Cloud-Konto und
lädt die lokalen Kürdateien hoch.