# Kontosync über FTP 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. ## 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. 5. **Speichern**. Danach **Datei → Jetzt synchronisieren**. ## Was passiert - Jede Kür liegt als `.tres` unter `user://routines/` und wird 1:1 in das FTP-Verzeichnis gespiegelt (flach, keine Unterordner). - Der Sync vergleicht pro Datei den letzten gemeinsamen Stand (`user://sync_state.cfg`) mit den aktuellen Zeitstempeln: | Lage | Aktion | | :--- | :--- | | nur lokal, noch nie synchronisiert | hochladen | | nur auf dem Server | herunterladen | | seit dem letzten Sync nur lokal geändert | hochladen | | seit dem letzten Sync nur auf dem Server geändert | herunterladen | | beidseitig geändert | **Konflikt**: beide Fassungen behalten | | Datei auf einer Seite gelöscht | nichts tun (keine Löschweitergabe) | | erster Sync, Datei auf beiden Seiten | **Konflikt** (kein Stand bekannt) | - Bei einem Konflikt bleibt die lokale Fassung unverändert; die Serverfassung wird als `name (Server JJJJ-MM-TT HHMM).tres` daneben gespeichert. Beim nächsten Sync wird diese Kopie als neue Kür hochgeladen. Zusammenführen musst du selbst. - 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). - Ist die geöffnete Kür vom Download betroffen und ungespeichert, wird sie **nicht** überschrieben – es erscheint ein Hinweis. ## Technik | 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/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). - Downloads landen in `name.part` und ersetzen die Zieldatei erst danach. - Zugangsdaten 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/`. - Android braucht die `INTERNET`-Berechtigung – ist im APK gesetzt. ## 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. - Löschungen werden nicht übertragen (bewusst, um Versehen nicht zu multiplizieren). - Umbenennen einer Kür wirkt wie „neu lokal“ + „nur Server“: 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.