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
This commit is contained in:
torsten 2026-10-30 11:03:18 +01:00
parent 921cf623fd
commit f553785710
15 changed files with 1554 additions and 7 deletions

View file

@ -239,7 +239,12 @@ ggf. eines nach `touchend` (300-ms-Guard).
Details in `docs/builds.md`.
- **Lokale Daten:** `user://` liegt pro Plattform getrennt (Linux
`~/.local/share/godot/app_userdata/Rinkplanner/`, Android im
app-internen Speicher). Ein Kontosync ist noch nicht implementiert.
app-internen Speicher).
- **Kontosync:** manueller FTP-/FTPS-Abgleich der `.tres`-Dateien über
`FtpClient`, `SyncPlan` und `RoutineSync`; Details in `docs/sync.md`.
Zugangsdaten liegen in `user://sync.cfg`, der letzte gemeinsame Stand in
`user://sync_state.cfg`. Konflikte werden als Kopie mit Server-Zeitstempel
behalten.
## 7. Tests
@ -278,6 +283,10 @@ Aktueller Stand:
Leistenlayout bei 1024 und 1400 px.
- **Performance:** Stresstest mit 480 Segmenten in 12 Sections; die mittlere
Redraw-Zeit muss unter 120 ms bleiben (aktuell ca. 7–10 ms).
- **Sync:** 31 Assertions für Vergleichsregeln, Konfliktnamen, Zeitstempel,
PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
(Upload, Download, Konflikt, Aufräumen).
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
end-to-end geprüft.

View file

@ -75,13 +75,16 @@ Voraussetzung für Phase 1.
- [x] Kleine Displays (1024 px) geprüft
- [x] Performance bei vielen Segmenten und Sections (Cache + Stresstest)
### Nächster Schritt: Kontosync (Desktop ↔ Tablet)
### Erledigt: Kontosync (Desktop ↔ Tablet)
- [ ] Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort,
Verzeichnis), Zugangsdaten unter `user://`, nicht im Repo
- [ ] Manueller Sync: neueste `.tres` je Kür laden/hochladen
- [ ] Konflikte als Kopien mit Zeitstempel behalten
- [ ] Automatischer Sync und Sync-Status in der Oberfläche (später)
- [x] Sync-Einstellungen in der App (FTP-Host, Port, Benutzer, Passwort,
Verzeichnis, FTPS, Zertifikatsprüfung), Zugangsdaten unter `user://`
- [x] Manueller Sync: `.tres` je Kür laden/hochladen, Sync-Stand lokal
- [x] Konflikte als Kopien mit Server-Zeitstempel behalten
- [x] Fortschritt und Zusammenfassung in der Oberfläche
- [x] FTP/FTPS-Client ohne externe Bibliothek
- [ ] Automatischer Sync im Hintergrund (später)
- [ ] Konflikt-Zusammenführung in der Oberfläche (später)
### Danach: Element-Marker

80
docs/sync.md Normal file
View file

@ -0,0 +1,80 @@
# 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.