From e65d330d1db31766725c8b9324b1e83fead08436 Mon Sep 17 00:00:00 2001 From: Stefan Hacker Date: Sun, 12 Apr 2026 03:06:40 +0200 Subject: [PATCH] docs: README File Locking Tabelle aktualisiert - Feature-Beschreibung angepasst (manuelles Entsperren, auto-unlock) - Neue File Locking Tabelle mit allen Szenarien (oeffnen, entsperren, vergessen, client beenden, admin) Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a7412f7..8fdd0b7 100644 --- a/README.md +++ b/README.md @@ -306,7 +306,7 @@ Der Desktop-Client (`clients/desktop/`) synchronisiert Dateien zwischen der Clou - **Sofort-Sync**: Filesystem-Watcher erkennt lokale Aenderungen sofort (3s Debounce), kein Polling - **Intelligenter Sync**: Checksum-Tracking erkennt wer sich geaendert hat (Server oder Lokal) - **Konflikt-Erkennung**: Bei gleichzeitiger Aenderung wird eine Konflikt-Kopie erstellt -- **File Locking**: Automatisches Ein-/Auschecken mit Heartbeat, Auto-Unlock bei Datei-Schliessung +- **File Locking**: Lock beim Oeffnen, Heartbeat alle 60s, manuelles Entsperren per Rechtsklick, auto-unlock nach 15 Min ohne Heartbeat - **System-Tray**: Minimiert in den Tray statt zu beenden, Doppelklick oeffnet Fenster - **Minimiert starten**: Optional direkt im Tray starten (Checkbox in Einstellungen) - **Auto-Login**: Zugangsdaten und Sync-Pfade bleiben nach Neustart/Update erhalten @@ -346,6 +346,19 @@ Der Client merkt sich den Checksum jeder Datei beim letzten Sync. Beim naechsten Beim ersten Sync (kein gespeicherter Checksum) gewinnt immer der Server. +### File Locking + +Dateien werden beim Oeffnen ueber den Client automatisch auf dem Server gesperrt. Andere Benutzer sehen "Datei gesperrt von X" und koennen sie nicht bearbeiten. + +| Szenario | Was passiert | +|----------|-------------| +| .cloud Datei oeffnen | Download + Lock + Heartbeat alle 60s | +| Fertig -> Rechtsklick "Entsperren" | Lock sofort aufgehoben | +| Rechtsklick "Nicht mehr offline" | Lock aufgehoben + zurueck zu .cloud | +| Client beenden ohne Entsperren | Kein Heartbeat -> Lock laeuft nach 15 Min ab | +| Laptop zugeklappt / Netzwerk weg | Kein Heartbeat -> Lock laeuft nach 15 Min ab | +| Admin im Web-UI | Kann jeden Lock jederzeit manuell loesen | + ### Bauen ```bash