rinkplanner/docs/sync.md

6.9 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 .json unter user://routines/ und wird 1:1 in das FTP-Verzeichnis 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 Serverkopien nicht verlieren; neue Speicherungen schreiben .json. Beim Laden wird eine .tres vor dem ResourceLoader gegen eine Whitelist geprüft (nur Modellskripte, kein eingebettetes GDScript).
  • 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).json 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).json dazu. Beim nächsten Sync wird diese Kopie als neue Kür hochgeladen. Zusammenführen musst du selbst. Die Kopien behalten die Endung der Ausgangsdatei; bei Legacy-.tres entstehen also weiterhin .tres-Kopien.

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 …).json. 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.
  • Heruntergeladene .json-Dateien werden als JSON validiert; Legacy-.tres laufen vor dem Laden durch die Whitelist in RoutineFile. Ein präparierter Server kann damit keine eingebetteten GDScripts ausführen.
  • Neue Speicherungen sind JSON; der Sync akzeptiert weiterhin .tres, damit bestehende Dateien auf Server und Tablet nicht verschwinden.
  • Musikdateien werden als normale Anhänge der Kür behandelt: Die JSON nennt nur den Dateinamen (music_file), die Datei liegt daneben. Ändert sich die Musik auf einem Gerät, lädt der nächste Sync sie hoch; auf dem anderen Gerät wird sie heruntergeladen und beim Öffnen der Kür verwendet. Konfliktkopien behalten die Audio-Endung (z. B. kuer (Server …).mp3).
  • Eigene Timeline-Labels stehen in der Kür-JSON (timeline_labels) und werden ohne Zusatzdateien mit der Kür übertragen.
  • 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.