diff --git a/README.md b/README.md index ef2451d..98962e1 100644 --- a/README.md +++ b/README.md @@ -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) diff --git a/docs/architecture.md b/docs/architecture.md index 22d3cf6..4d98bf6 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -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 diff --git a/docs/builds.md b/docs/builds.md index d6a4e7c..14cfd31 100644 --- a/docs/builds.md +++ b/docs/builds.md @@ -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`. diff --git a/docs/cloud-setup.md b/docs/cloud-setup.md index d028696..94e4c29 100644 --- a/docs/cloud-setup.md +++ b/docs/cloud-setup.md @@ -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/`. 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/`; 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 diff --git a/docs/credentials.example.txt b/docs/credentials.example.txt index 8cb1900..09109da 100644 --- a/docs/credentials.example.txt +++ b/docs/credentials.example.txt @@ -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: diff --git a/docs/roadmap.md b/docs/roadmap.md index 3cabd3e..bdbbd17 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -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/`) 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 diff --git a/docs/sync.md b/docs/sync.md index e695aa4..b7959b0 100644 --- a/docs/sync.md +++ b/docs/sync.md @@ -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/`); 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/`. 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 diff --git a/rinkplanner/scenes/whiteboard/whiteboard.tscn b/rinkplanner/scenes/whiteboard/whiteboard.tscn index c58cceb..5865832 100644 --- a/rinkplanner/scenes/whiteboard/whiteboard.tscn +++ b/rinkplanner/scenes/whiteboard/whiteboard.tscn @@ -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 diff --git a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd index 20a511d..4e0c169 100644 --- a/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd +++ b/rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd @@ -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/). 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() diff --git a/rinkplanner/tests/run_sync_tests.gd b/rinkplanner/tests/run_sync_tests.gd index 5403f88..eee5d89 100644 --- a/rinkplanner/tests/run_sync_tests.gd +++ b/rinkplanner/tests/run_sync_tests.gd @@ -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()