rinkplanner/docs/sync.md
torsten 7c6c8fc3d4 docs: Findings der Tablet-/Build-/Sync-Session festhalten
- docs/findings-2026-10-30.md: Gerät, Toolchain, Android-APK, Windows-
  Ressourcen, Icon-Pipeline, Sync-Regeln und -Fehler, Labels, Tests,
  offene Punkte
- Roadmap: Tablet-Test, Icons und rcedit als erledigt markiert; nächste
  Session auf Element-Marker gesetzt, danach Sync-Komfort und Layout
- builds.md: Zielgerät-Verifikation, invertiertes Icon, bekannte Grenzen
  (Hochformat/DeX, arm64, rcedit-Setup, macOS-Signierung)
- sync.md: Erfahrungen mit dem Zielserver (FTPS-Zertifikat, MLSD/MDTM,
  Ordneranlage)
- architecture.md: Sync-Testanzahl und Verweis auf die Findings
2026-10-30 12:14:59 +01:00

5.5 KiB
Raw Blame History

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 (seit dem letzten Sync) Konflikt: lokale Fassung bleibt Hauptdatei, Serverfassung 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

Wie kommt eine Kür vom Desktop aufs Tablet?

  1. Auf dem Desktop die Kür speichern (Datei → Speichern) und synchronisieren.
  2. Auf dem Tablet zuerst synchronisieren, dann Datei → Öffnen. Die Kür wird heruntergeladen und erscheint in der Liste.

Wichtig: Der Abgleich ordnet Dateien über den Dateinamen zu (der aus dem 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 name (Lokal JJJJ-MM-TT HHMM).tres 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 name (Server JJJJ-MM-TT HHMM).tres dazu. Beim nächsten Sync wird diese Kopie als neue Kür hochgeladen. Zusammenführen musst du selbst.

Wenn du auf dem Tablet also eine leere „Testkür1“ anlegst, obwohl es die Desktop-Version schon gibt, hast du nach dem Sync zwei Dateien: die Desktop-Version unter dem normalen Namen und deine leere Fassung als testkür1 (Lokal …).tres. Besser: erst synchronisieren, dann die vorhandene Kür öffnen und bearbeiten.

  • 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.

Erfahrungen mit dem Zielserver

  • 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.

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.