Cloud-Synchronisierung

Wie Cloud-Synchronisierung funktioniert

Kanban Pro ist eine Local-first-Anwendung. Jedes Projekt ist ein Ordner auf Ihrem Dateisystem, der Markdown-Ticket-Dateien und ein .kanban/-Konfigurationsverzeichnis enthält. Es gibt keine Konten, keine proprietären Cloud-Dienste und keine Registrierung.

Um mit anderen zusammenzuarbeiten, platzieren Sie Ihren Projektordner einfach in einem cloud-synchronisierten Verzeichnis — iCloud Drive, Dropbox, Google Drive, OneDrive oder ein beliebiges Netzlaufwerk. Jeder Teilnehmer öffnet denselben Ordner in Kanban Pro, und Änderungen werden automatisch durch die Dateisynchronisierung des Cloud-Anbieters übernommen.

Einrichten eines gemeinsamen Projekts

1. Wählen Sie einen Cloud-Ordner. Öffnen Sie den Finder und navigieren Sie zum Synchronisierungsverzeichnis Ihres Cloud-Anbieters (z. B. ~/Library/Mobile Documents/com~apple~CloudDocs/ für iCloud Drive, ~/Dropbox/ für Dropbox oder das Google Drive / OneDrive-Mount in Ihrer Finder-Seitenleiste).
2. Erstellen Sie einen Projektordner. Erstellen Sie einen neuen Ordner für Ihr Projekt, z. B. Team Board.
3. Öffnen Sie ihn in Kanban Pro. Starten Sie Kanban Pro, klicken Sie auf Ordner öffnen, und wählen Sie den gerade erstellten Ordner aus. Kanban Pro initialisiert das .kanban/-Verzeichnis, und Sie können mit dem Hinzufügen von Spalten und Tickets beginnen.
4. Geben Sie den Ordner frei. Verwenden Sie die Freigabefunktionen Ihres Cloud-Anbieters, um Zusammenarbeiter einzuladen. Klicken Sie auf iCloud Drive mit der rechten Maustaste auf den Ordner und wählen Sie Freigeben. Verwenden Sie auf Dropbox oder Google Drive das Freigabedialogfeld. Klicken Sie auf OneDrive mit der rechten Maustaste und wählen Sie Freigeben → Mit OneDrive freigeben. Jeder Zusammenarbeiter sollte dann denselben synchronisierten Ordner in seiner eigenen Kopie von Kanban Pro öffnen.

Empfohlene Ordnerstruktur

Wenn Kanban Pro ein Projekt initialisiert, erstellt es die folgende Struktur in Ihrem gewählten Ordner:

Jedes Ticket ist eine einfache Markdown-Datei mit YAML-Frontmatter für Metadaten (Status, Priorität, Zugewiesen, Tags, benutzerdefinierte Felder). Sie können diese Dateien mit jedem beliebigen Werkzeug lesen, bearbeiten oder sichern — einschließlich KI-Coding-Agenten, die direkt mit dem Dateisystem arbeiten.

Echtzeit-Synchronisierung und konfliktfreie Bearbeitung

Kanban Pro überwacht den Projektordner auf Dateisystemänderungen mit einem Echtzeit-Datei-Watcher. Wenn ein Zusammenarbeiter ein Ticket speichert oder die Board-Konfiguration aktualisiert, wird die Änderung innerhalb von Sekunden erkannt und die Benutzeroberfläche aktualisiert sich automatisch.

Wie Konflikte vermieden werden

• Ticket-Sperrung: Wenn Sie ein Ticket zur Bearbeitung öffnen, erstellt Kanban Pro eine kleine Sperrdatei in .kanban/locks/. Andere Benutzer sehen das Ticket als gesperrt und können Ihre Änderungen nicht überschreiben. Sperrdateien werden durch Ihren Cloud-Anbieter synchronisiert, sodass alle Zusammenarbeiter den gleichen Sperrstatus sehen.
• Atomare Schreibvorgänge: Jedes Ticket ist eine einzelne Markdown-Datei. Kanban Pro schreibt zunächst in eine temporäre Datei und benennt sie dann um — um Teilaktualisierungen zu vermeiden, selbst wenn der Cloud-Anbieter während des Schreibens synchronisiert.
• Schreiben-Ende-Erkennung: Kanban Pro wartet, bis sich Dateien stabilisieren (2 Sekunden für Tickets, 1 Sekunde für Board-Konfiguration), bevor sie gelesen werden. Dies stellt sicher, dass die Cloud-Synchronisierung beendet ist, bevor die App die Änderung verarbeitet.
• Last-Write-Wins für Board-Konfiguration: Spaltenreihenfolge, Einstellungen und benutzerdefinierte Felddefinitionen werden in board.json gespeichert. Wenn zwei Benutzer Board-Einstellungen gleichzeitig ändern, gewinnt der letzte Schreibvorgang — aber dies ist in der Praxis selten, da sich die Board-Konfiguration selten ändert.

Sperrdateien verstehen

Das .kanban/locks/-Verzeichnis enthält temporäre Sperrdateien, die anzeigen, welche Tickets gerade bearbeitet werden und von wem. Jede Sperrdatei ist ein kleines JSON-Dokument:

{
  "ticket": "KAN-42",
  "user": "Alice",
  "device": "Alice-MacBook",
  "timestamp": "2026-03-09T10:30:00Z"
}

Sperrdateien werden erstellt, wenn ein Ticket zur Bearbeitung geöffnet wird, und entfernt, wenn der Editor geschlossen wird. Sie ermöglichen Kanban Pro, einen visuellen Indikator auf gesperrten Tickets anzuzeigen, damit Zusammenarbeiter wissen, dass jemand daran arbeitet.

Veraltete Sperren auflösen

Wenn Kanban Pro abstürzt oder ein Gerät offline geht, kann eine Sperrdatei ohne Cleanup erhalten bleiben. Dies wird als veraltete Sperre bezeichnet.

Kanban Pro erkennt auch Sperren, die älter als 24 Stunden sind, und flaggt sie als möglicherweise veraltet in der Benutzeroberfläche, wodurch Sie die Möglichkeit haben, sie direkt aus der App freizugeben.

Cloud-Anbieter-Hinweise

Best Practices

• Halten Sie Projektordner offline verfügbar. Markieren Sie Ihren Projektordner als "Offline verfügbar", "Dateien spiegeln", "Immer auf diesem Gerät behalten" oder "Herunterladen behalten", je nach Cloud-Anbieter. Dies vermeidet Verzögerungen, die durch Dateien bei Bedarf verursacht werden.
• Halten Sie die Ordnerstruktur flach. Vermeiden Sie tief verschachtelte Verzeichnisse — ein flaches Layout verbessert die Synchronisierungszuverlässigkeit über alle Anbieter hinweg.
• Überprüfen Sie den Synchronisierungsstatus, bevor Sie Ihren Mac schließen. Achten Sie auf Synchronisierungssymbole im Finder oder in der Menüleiste. Ein Herunterfahren während der Synchronisierung kann teilweise Dateien hinterlassen, die Zusammenarbeiter verwirren.
• Speicherplatz beibehalten. Behalten Sie mindestens 10–15 % kostenlosen Speicherplatz auf Ihrem Mac und mindestens 20 % kostenlosen Cloud-Speicher. Niedriger Speicherplatz kann die Synchronisierung stallen oder die Dateientfernung auslösen.
• Verwenden Sie denselben Cloud-Anbieter im Team. Das Mischen von Anbietern (z. B. eine Person auf iCloud, eine andere auf Dropbox) erfordert, dass jede Person ihre eigene Kopie hat — sie werden nicht miteinander synchronisiert.

Fehlerbehebung

• Änderungen werden nicht angezeigt: Überprüfen Sie, dass Ihr Cloud-Anbieter aktiv synchronisiert. Achten Sie auf Synchronisierungssymbole im Finder oder im Menüleisten-Symbol des Cloud-Anbieters. Kanban Pro aktualisiert sich innerhalb von Sekunden nach Erkennung einer Dateiänderung — wenn die Datei noch nicht synchronisiert wurde, kann die App sie nicht sehen.
• Ticket bleibt als gesperrt fest: Siehe den Abschnitt "Veraltete Sperren" oben. Sie können aus der App freigeben (für Sperren älter als 24 Stunden) oder die Sperrdatei manuell in .kanban/locks/ löschen.
• Fehlende Tickets nach Synchronisierung: Einige Cloud-Anbieter verzögern die Synchronisierung neuer Dateien. Warten Sie einen Moment und überprüfen Sie den Synchronisierungsstatus Ihres Anbieters. Wenn das Problem weiterhin besteht, überprüfen Sie, dass der Ordner zum Offline-Synchronisieren eingestellt ist. Überprüfen Sie auf iCloud Drive, dass Dateien nicht durch .icloud-Platzhalterdateien ersetzt wurden.
• Langsames anfängliches Laden: Wenn Ihr Cloud-Anbieter Dateien bei Bedarf streamt, kann das erste Laden länger dauern, während Dateien heruntergeladen werden. Wechseln Sie zum Offline- oder Spiegelmodus für beste Leistung.
• Synchronisierung wurde unerwartet pausiert: Einige Cloud-Anbieter pausieren die Synchronisierung, wenn Ihr Mac auf Batteriebetrieb läuft oder wenig Speicherplatz hat. Überprüfen Sie das Menüleisten-Symbol Ihres Anbieters auf Pausieranzeigen und stellen Sie die Synchronisierung bei Bedarf wieder her.
• Dateien mit "konfligierter Kopie" werden angezeigt: Wenn Sie Dateien mit "konfligierte Kopie" im Finder sehen, haben wahrscheinlich zwei Personen dieselbe Datei offline bearbeitet. Öffnen Sie beide Dateien, um sie zu vergleichen, behalten Sie die richtige Version und löschen Sie die konfligierte Kopie.