- FTP/FTPS-Client (USER/PASS, AUTH TLS + PROT P, EPSV/PASV, MLSD, SIZE, RETR, STOR, DELE, MKD, RNFR/RNTO) ohne externe Bibliothek - Sync-Vergleich pro Kürdatei mit lokalem Sync-Stand: hochladen, herunterladen, überspringen; beidseitige Änderungen bleiben als Kopie mit Server-Zeitstempel erhalten, die lokale Fassung wird nie verworfen - Sync-Einstellungen (Host, Port, Benutzer, Passwort, Verzeichnis, FTPS, Zertifikatsprüfung) unter user://sync.cfg, nicht im Repository - Sync läuft im Thread, Fortschritt in der Statusleiste, Zusammenfassung im Dialog; geöffnete Kür wird nur unverändert neu geladen - Atomare Ersetzung über .part/.bak, Uploads über .uploading + Umbenennen - Tests für Vergleichsregeln, Konfliktnamen, PASV/EPSV/MDTM, Sync-Stand und Einstellungs-Dialog; zusätzlich E2E gegen den echten FTP-Server - docs/sync.md mit Einrichtung, Verhalten und Grenzen
3.7 KiB
3.7 KiB
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
- Auf beiden Geräten: Datei → Sync-Einstellungen…
- Eintragen:
- Server – Hostname des FTP-Servers (ohne
ftp://) - Port – normalerweise 21
- Benutzer / Passwort
- Verzeichnis – Zielordner relativ zum Login, z. B.
rinkplanner
- Server – Hostname des FTP-Servers (ohne
- FTPS eingeschaltet lassen (empfohlen).
- 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.
- Speichern.
Danach Datei → Jetzt synchronisieren.
Was passiert
- Jede Kür liegt als
.tresunteruser://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).tresdaneben 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.uploadingund werden dann umbenannt (falls der Server das verweigert: direkter Upload). - Downloads landen in
name.partund 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.