feat: Sync-Einstellungen auf Dropbox festlegen

- Cloud-Ordner-Feld entfernt; der Sync nutzt fest den Dropbox-App-Ordner
  Apps/<App-Name>
- Alte directory-Einträge werden beim Laden einmalig entfernt, bei Bedarf
  mit Reset des Sync-Stands
- Google Drive erscheint nur noch, wenn Zugangsdaten im Build konfiguriert
  sind; sonst wird der Anbieter auf Dropbox normalisiert
- Roadmap, Sync-Doku und Cloud-Setup an den Dropbox-only-Stand angepasst
- Sync-Tests für Migration und Anbieter-Sichtbarkeit erweitert
This commit is contained in:
torsten 2026-11-10 16:26:24 +01:00
parent 55e7b163b5
commit 6f22350934
10 changed files with 94 additions and 76 deletions

View file

@ -11,5 +11,5 @@ Planner for Figure Skating free skate
- **3D-Assets:** [`docs/assets.md`](docs/assets.md)
- **Rotoscoping:** [`docs/rotoscoping.md`](docs/rotoscoping.md)
- **Builds:** [`docs/builds.md`](docs/builds.md)
- **Kür-Sync (Google Drive/Dropbox):** [`docs/sync.md`](docs/sync.md)
- **Kür-Sync (Dropbox):** [`docs/sync.md`](docs/sync.md)
- **Cloud-Sync einrichten:** [`docs/cloud-setup.md`](docs/cloud-setup.md)

View file

@ -554,7 +554,8 @@ ggf. eines nach `touchend` (300-ms-Guard).
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;
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

View file

@ -205,9 +205,9 @@ auf `tools/sync_assets.sh --sync` ab. Für einen reinen Starttest ohne
## Kontosync
Der manuelle Sync über Google Drive oder Dropbox lädt die neuesten
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 Cloud-Konto; Refresh-Tokens liegen in den App-Einstellungen
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

@ -186,19 +186,20 @@ 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**.
2. Anbieter wählen (derzeit Dropbox; Google Drive ist vorbereitet, aber nicht
freigeschaltet).
3. **Verbinden…**: Rinkplanner öffnet die Dropbox-Seite. Den dort angezeigten
Code in die App einfügen und **Verbinden** drücken.
(Die Google-Drive-Anmeldung per Gerätecode ist im Code vorhanden und wird
aktiv, sobald die OAuth-App freigeschaltet ist.)
4. **Speichern**, danach **Datei → Jetzt synchronisieren**.
Der Sync nutzt direkt den Dropbox-App-Ordner `Apps/<App-Name>`; bei Google
Drive den von der App angelegten Ordner `Rinkplanner`. Ein eigener
Cloud-Unterordner wird nicht abgefragt.
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.
dasselbe Konto verwenden; der Abgleich läuft über den gemeinsamen App-Ordner.
## Lizenzen und Musikdateien

View file

@ -21,7 +21,7 @@ FTP_DIRECTORY=rinkplanner
# ---------------------------------------------------------------------------
# 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.
# Jeder Nutzer verbindet danach sein eigenes 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:

View file

@ -1,6 +1,6 @@
# Rinkplanner – Roadmap
Stand: 2026-11-03 (ISU 2026/27, Adult-Kategorien Gold/Silver/Bronze; JSON-Dateiformat, Export-Smoke-Test und Quality-Meilenstein ergänzt)
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)
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`.
@ -97,10 +97,10 @@ Voraussetzung für Phase 1.
- [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest)
- [x] Auf dem Zielgerät verifiziert (340 dpi, 2800 × 1752, Landscape)
### Erledigt: Kontosync (Desktop ↔ Tablet)
### Erledigt: Kontosync (Desktop ↔ Tablet, aktuell Dropbox)
- [x] Sync-Einstellungen in der App (Anbieter, Konto verbinden/trennen,
Cloud-Ordner), Refresh-Tokens unter `user://`
- [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 als Kopien mit Server-Zeitstempel behalten
@ -110,6 +110,11 @@ Voraussetzung für Phase 1.
- [ ] Automatischer Sync im Hintergrund (später)
- [ ] Konflikt-Zusammenführung in der Oberfläche (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“.
### Erledigt: Element-Marker
- [x] Sprungpunkte, Pirouettenzentren und Sequenzbereiche platzieren
@ -202,6 +207,20 @@ 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
@ -290,4 +309,6 @@ Schritte.
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

View file

@ -1,36 +1,33 @@
# Kür-Sync über Cloud-Speicher
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
Cloud-Speicher des Nutzers: Dropbox. Google Drive ist im Code vorbereitet,
aber derzeit nicht freigeschaltet. 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. **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**.
2. **Anbieter** wählen: Dropbox.
3. **Verbinden…** drücken und im Browser mit dem eigenen Dropbox-Konto
anmelden. Die App öffnet die Dropbox-Seite; den dort angezeigten Code
in das Feld einfügen und **Verbinden** drücken.
4. **Speichern**.
Der Sync nutzt direkt den Dropbox-App-Ordner `Apps/<App-Name>`. Ein eigener
Cloud-Unterordner wird nicht mehr abgefragt.
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.
können dasselbe Dropbox-Konto verwenden; der Abgleich läuft über den
gemeinsamen App-Ordner.
## Was passiert
- 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
App-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

View file

@ -1095,7 +1095,7 @@ cancel_button_text = "Abbrechen"
[node name="SyncSettingsDialog" type="ConfirmationDialog" parent="."]
unique_name_in_owner = true
title = "Sync-Einstellungen"
size = Vector2i(620, 500)
size = Vector2i(620, 460)
ok_button_text = "Speichern"
cancel_button_text = "Abbrechen"
@ -1103,7 +1103,7 @@ cancel_button_text = "Abbrechen"
offset_left = 12.0
offset_top = 12.0
offset_right = 608.0
offset_bottom = 430.0
offset_bottom = 390.0
theme_override_constants/separation = 10
[node name="SyncHint" type="Label" parent="SyncSettingsDialog/SyncBox"]
@ -1111,7 +1111,7 @@ custom_minimum_size = Vector2(560, 0)
layout_mode = 2
theme_override_colors/font_color = Color(0.580392, 0.639216, 0.721569, 1)
theme_override_font_sizes/font_size = 14
text = "Jedes Gerät verbindet sein eigenes Google- oder Dropbox-Konto. Rinkplanner speichert die Kürdateien und Musik nur in diesem Konto; es gibt keinen gemeinsamen Server."
text = "Jedes Gerät verbindet sein eigenes Dropbox-Konto. Rinkplanner speichert die Kürdateien und Musik nur in diesem Konto; es gibt keinen gemeinsamen Server."
autowrap_mode = 2
[node name="SyncGrid" type="GridContainer" parent="SyncSettingsDialog/SyncBox"]
@ -1130,17 +1130,6 @@ custom_minimum_size = Vector2(330, 48)
layout_mode = 2
size_flags_horizontal = 3
[node name="SyncDirectoryLabel" type="Label" parent="SyncSettingsDialog/SyncBox/SyncGrid"]
layout_mode = 2
text = "Cloud-Ordner"
[node name="SyncDirectoryEdit" type="LineEdit" parent="SyncSettingsDialog/SyncBox/SyncGrid"]
unique_name_in_owner = true
custom_minimum_size = Vector2(330, 48)
layout_mode = 2
size_flags_horizontal = 3
placeholder_text = "leer = Cloud-Hauptordner"
[node name="SyncAccountRow" type="HBoxContainer" parent="SyncSettingsDialog/SyncBox"]
layout_mode = 2
theme_override_constants/separation = 10

View file

@ -246,7 +246,6 @@ const MAX_MUSIC_FILE_BYTES := 64 * 1024 * 1024
@onready var sync_provider_option: OptionButton = %SyncProviderOption
@onready var sync_account_value: Label = %SyncAccountValue
@onready var sync_connect_button: Button = %SyncConnectButton
@onready var sync_directory_edit: LineEdit = %SyncDirectoryEdit
@onready var cloud_auth_dialog: ConfirmationDialog = %CloudAuthDialog
@onready var cloud_auth_status: Label = %CloudAuthStatus
@onready var cloud_auth_url_edit: LineEdit = %CloudAuthUrlEdit
@ -5424,7 +5423,6 @@ func _apply_responsive_layout() -> void:
func load_sync_settings() -> Dictionary:
var settings := {
"provider": "dropbox",
"directory": "",
"tokens": {},
}
var config := ConfigFile.new()
@ -5432,12 +5430,30 @@ func load_sync_settings() -> Dictionary:
return settings
for key: String in settings.keys():
settings[key] = config.get_value("connection", key, settings[key])
# The cloud folder is always the provider's app folder (Dropbox:
# Apps/<App-Name>). Drop an old custom subfolder once so existing
# installations move to the app-folder root.
if config.has_section_key("connection", "directory"):
var legacy_directory := str(
config.get_value("connection", "directory", "")
).strip_edges()
config.erase_section_key("connection", "directory")
config.save(SYNC_SETTINGS_PATH)
_protect_sync_settings()
if not legacy_directory.is_empty():
_reset_sync_state()
var tokens: Variant = settings.get("tokens", {})
if not tokens is Dictionary:
settings["tokens"] = {}
var provider := str(settings.get("provider", ""))
if not SYNC_PROVIDERS.has(provider):
settings["provider"] = "dropbox"
elif provider == "google_drive" and not SyncAppConfig.is_configured(
"google_drive", SyncAppConfig.load_config()
):
# Google Drive stays hidden until its OAuth app is configured for
# this build; never start a sync with an unavailable provider.
settings["provider"] = "dropbox"
return settings
@ -5467,10 +5483,9 @@ func _open_sync_settings_dialog() -> void:
var settings := load_sync_settings()
_ensure_sync_provider_items()
_apply_sync_provider_to_ui(str(settings.get("provider", "dropbox")))
sync_directory_edit.text = str(settings.get("directory", ""))
_update_sync_account(settings)
sync_settings_dialog.popup_centered(Vector2i(620, 500))
sync_directory_edit.grab_focus()
sync_settings_dialog.popup_centered(Vector2i(620, 460))
sync_provider_option.grab_focus()
func _ensure_sync_provider_items() -> void:
@ -5479,11 +5494,10 @@ func _ensure_sync_provider_items() -> void:
var app := SyncAppConfig.load_config()
var has_dropbox := SyncAppConfig.is_configured("dropbox", app)
var has_google := SyncAppConfig.is_configured("google_drive", app)
if not has_dropbox and not has_google:
# Developer build without app credentials: show both so the missing
# configuration is visible instead of an empty dropdown.
if not has_dropbox:
# Developer build without app credentials: show Dropbox so the
# missing configuration is visible instead of an empty dropdown.
has_dropbox = true
has_google = true
if has_dropbox:
sync_provider_option.add_item("Dropbox", 0)
sync_provider_option.set_item_metadata(
@ -5533,19 +5547,8 @@ func _on_sync_provider_selected(_index: int) -> void:
func _on_sync_settings_confirmed() -> void:
var settings := load_sync_settings()
var provider := _selected_sync_provider()
var directory := (
sync_directory_edit.text.strip_edges()
.replace("/", "-")
.replace("\\", "-")
)
if directory.is_empty() and provider == "google_drive":
directory = "Rinkplanner"
var changed := (
str(settings.get("provider", "")) != provider
or str(settings.get("directory", "")) != directory
)
var changed := str(settings.get("provider", "")) != provider
settings["provider"] = provider
settings["directory"] = directory
save_sync_settings(settings)
if changed:
_reset_sync_state()

View file

@ -339,7 +339,10 @@ func _test_controller_wiring() -> void:
})
var loaded := controller.load_sync_settings()
_check(loaded["provider"] == provider, "Sync-Einstellungen speichern den Anbieter")
_check(loaded["directory"] == "Kueren", "Sync-Einstellungen speichern den Cloud-Ordner")
_check(
not loaded.has("directory"),
"Sync-Einstellungen verwerfen den alten Cloud-Unterordner"
)
_check(
RoutineSync.provider_tokens(loaded, provider).get("refresh_token") == "refresh",
"Sync-Einstellungen speichern den Refresh-Token"
@ -354,9 +357,13 @@ func _test_controller_wiring() -> void:
controller._selected_sync_provider() == provider,
"Dialog wählt den gespeicherten Anbieter"
)
var google_items := 0
for index: int in range(controller.sync_provider_option.item_count):
if str(controller.sync_provider_option.get_item_metadata(index)) == "google_drive":
google_items += 1
_check(
controller.sync_directory_edit.text == "Kueren",
"Dialog ist mit dem gespeicherten Ordner gefüllt"
google_items == (1 if SyncAppConfig.is_configured("google_drive", app_config) else 0),
"Google Drive erscheint nur mit konfigurierten Zugangsdaten"
)
_check(
controller.sync_account_value.text == "konto@example.org",
@ -371,7 +378,6 @@ func _test_controller_wiring() -> void:
# Ohne Refresh-Token öffnet "Jetzt synchronisieren" die Einstellungen.
controller.save_sync_settings({
"provider": "dropbox",
"directory": "Rinkplanner",
"tokens": {},
})
controller.start_sync()