feat: manuellen FTP-Sync zwischen Desktop und Tablet
- 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
2026-10-30 11:03:18 +01:00
|
|
|
|
# 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 |
|
2026-10-30 11:25:26 +01:00
|
|
|
|
| beidseitig geändert (seit dem letzten Sync) | **Konflikt**: lokale Fassung bleibt Hauptdatei, Serverfassung kommt als `(Server …)`-Kopie dazu |
|
feat: manuellen FTP-Sync zwischen Desktop und Tablet
- 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
2026-10-30 11:03:18 +01:00
|
|
|
|
| Datei auf einer Seite gelöscht | nichts tun (keine Löschweitergabe) |
|
2026-10-30 11:25:26 +01:00
|
|
|
|
| erster Sync, Datei auf beiden Seiten | **Server übernimmt**: Serverfassung wird Hauptdatei, lokale Fassung bleibt als `(Lokal …)`-Kopie |
|
feat: manuellen FTP-Sync zwischen Desktop und Tablet
- 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
2026-10-30 11:03:18 +01:00
|
|
|
|
|
2026-10-30 11:25:26 +01:00
|
|
|
|
### 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.
|
feat: manuellen FTP-Sync zwischen Desktop und Tablet
- 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
2026-10-30 11:03:18 +01:00
|
|
|
|
- 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.
|