Cloud Sync

Hoe Cloud Sync werkt

Kanban Pro is een lokale applicatie. Elk project is een map op je bestandssysteem met Markdown-ticketbestanden en een configuratiemap .kanban/. Er zijn geen accounts, geen propriëtaire cloudservices en geen aanmeldingen.

Om met anderen samen te werken, plaats je je projectmap eenvoudig in een cloud-gesynchroniseerde map — iCloud Drive, Dropbox, Google Drive, OneDrive of een netwerkapparaat. Elke deelnemer opent dezelfde map in Kanban Pro, en wijzigingen worden automatisch doorgegeven via de bestandssynchronisatie van de cloudprovider.

Een gedeeld project instellen

1. Kies een cloudmap. Open Finder en navigeer naar de synchronisatiemap van je cloudprovider (b.v. ~/Library/Mobile Documents/com~apple~CloudDocs/ voor iCloud Drive, ~/Dropbox/ voor Dropbox, of de Google Drive-/OneDrive-koppeling in je Finder-zijbalk).
2. Maak een projectmap. Maak een nieuwe map voor je project, bijv. Team Board.
3. Open deze in Kanban Pro. Start Kanban Pro, klik op Map openen, en selecteer de map die je zojuist hebt gemaakt. Kanban Pro initialiseert de map .kanban/ en je kunt kolommen en tickets gaan toevoegen.
4. Deel de map. Gebruik de delingsfuncties van je cloudprovider om medewerkers uit te nodigen. Klik in iCloud Drive met de rechtermuisknop op de map en kies Delen. In Dropbox of Google Drive gebruikje de delingsvenster. Klik in OneDrive met de rechtermuisknop en selecteer Delen → Delen via OneDrive. Elke medewerker opent vervolgens dezelfde gesynchroniseerde map in hun eigen kopie van Kanban Pro.

Aanbevolen mapindeling

Wanneer Kanban Pro een project initialiseert, maakt het de volgende structuur in je gekozen map:

Elk ticket is een eenvoudig Markdown-bestand met YAML-frontmatter voor metagegevens (status, prioriteit, toegewezen aan, tags, aangepaste velden). Je kunt deze bestanden lezen, bewerken of back-uppen met elk hulpmiddel — inclusief AI-coderingsagenten die rechtstreeks met het bestandssysteem werken.

Realtimesynchronisatie en conflictvrij bewerken

Kanban Pro bewaakt de projectmap op bestandssysteemwijzigingen met behulp van een realtimebestandswatcher. Wanneer een medewerker een ticket opslaat of de bordconfiguratie bijwerkt, wordt de wijziging binnen seconden gedetecteerd en wordt de UI automatisch vernieuwd.

Hoe conflicten worden voorkomen

• Ticketvergrendeling: Wanneer je een ticket voor bewerking opent, maakt Kanban Pro een kleine vergrendelingsbestand in .kanban/locks/. Andere gebruikers zien het ticket als vergrendeld en kunnen je wijzigingen niet overschrijven. Vergrendelingsbestanden worden via je cloudprovider gesynchroniseerd, zodat alle medewerkers dezelfde vergrendelingstoestand zien.
• Atoomaire schrijfbewerkingen: Elk ticket is één Markdown-bestand. Kanban Pro schrijft eerst naar een tijdelijk bestand en hernoemt het vervolgens in plaats — waarbij gedeeltelijke updates worden voorkomen, zelfs als de cloudprovider tijdens het schrijven synchroniseert.
• Schrijfbewerking voltooid detecteren: Kanban Pro wacht tot bestanden stabiliseren (2 seconden voor tickets, 1 seconde voor bordconfiguratie) voordat ze worden gelezen. Dit zorgt ervoor dat de cloudsynchronisatie het schrijven heeft voltooid voordat de app de wijziging verwerkt.
• Laatst schrijven wint voor bordconfiguratie: Kolomvolgorde, instellingen en aangepaste velddefinities worden opgeslagen in board.json. Als twee gebruikers tegelijkertijd bordinstellingen wijzigen, wint de laatste schrijfbewerking — maar dit is zeldzaam in de praktijk omdat de bordconfiguratie zelden verandert.

Vergrendelingsbestanden begrijpen

De map .kanban/locks/ bevat tijdelijke vergrendelingsbestanden die aangeven welke tickets momenteel worden bewerkt en door wie. Elk vergrendelingsbestand is een klein JSON-document:

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

Vergrendelingsbestanden worden gemaakt wanneer een ticket voor bewerking wordt geopend en verwijderd wanneer de editor wordt gesloten. Ze stellen Kanban Pro in staat om een visuele indicator op vergrendelde tickets weer te geven, zodat medewerkers weten dat iemand eraan werkt.

Verouderde vergrendelingen oplossen

Als Kanban Pro crasht of een apparaat offline gaat, kan een vergrendelingsbestand blijven bestaan zonder opgeruimd te worden. Dit wordt een verouderde vergrendeling genoemd.

Kanban Pro detecteert ook vergrendelingen ouder dan 24 uur en markeert deze in de UI als mogelijk verouderd, wat je de mogelijkheid geeft om rechtstreeks vanuit de app te ontgrendelen.

Opmerkingen cloudprovider

Best practices

• Hou projectmappen offline beschikbaar. Markeer je projectmap als "Offline beschikbaar", "Bestanden spiegelen", "Altijd op dit apparaat behouden" of "Behouden en gedownload" afhankelijk van je cloudprovider. Dit voorkomt vertragingen door on-demand downloads van bestanden.
• Hou de mapstructuur plat. Vermijd diep geneste mappen — een vlakke indeling verbetert de synchronisatiebetrouwbaarheid voor alle providers.
• Controleer de synchronisatiestatus voordat je je Mac afsluit. Zoek naar synchronisatiepictogrammen in Finder of de menubalk. Uitschakelen tijdens synchronisatie kan onvolledig bestanden achterlaten die medewerkers in verwarring brengen.
• Behoud vrije opslagruimte. Houd minstens 10–15% vrije schijfruimte op je Mac en minstens 20% vrije cloudopslag. Lage opslag kan synchronisatie vastlopen of bestandsverwijdering activeren.
• Gebruik dezelfde cloudprovider in het hele team. Providers mixen (bijv. één persoon op iCloud, ander op Dropbox) vereist dat elke persoon een eigen kopie heeft — zij synchroniseren niet met elkaar.

Probleemoplossing

• Wijzigingen worden niet weergegeven: Controleer of je cloudprovider actief synchroniseert. Zoek naar synchronisatiepictogrammen in Finder of het menubalkpictogram van je cloudprovider. Kanban Pro wordt vernieuwd binnen seconden nadat een bestandswijziging is gedetecteerd — als het bestand nog niet is gesynchroniseerd, kan de app het niet zien.
• Ticket blijft vergrendeld: Zie het verouderde vergrendelingen-gedeelte hierboven. Je kunt ontgrendelen uit de app (voor vergrendelingen ouder dan 24 uur) of het vergrendelingsbestand in .kanban/locks/ handmatig verwijderen.
• Tickets ontbreken na synchronisatie: Sommige cloudproviders vertragen het synchroniseren van nieuwe bestanden. Wacht even en controleer je provider's synchronisatiestatus. Als het probleem aanhoudt, controleer of de map is ingesteld op offline synchronisatie. Controleer in iCloud Drive of bestanden niet zijn vervangen door .icloud placeholderbestanden.
• Langzaam eerste laden: Als je cloudprovider bestanden on-demand streamt, kan het eerste laden langer duren terwijl bestanden worden gedownload. Schakel voor optimale prestaties over naar offline of spiegelmodus.
• Synchronisatie onverwacht gepauzeerd: Sommige cloudproviders pauzeren synchronisatie wanneer je Mac op batterij draait of weinig schijfruimte heeft. Controleer je provider's menubalkpictogram op pauseaanduidingen en hervat synchronisatie indien nodig.
• Geconflicteerde kopiebestanden verschijnen: Als je bestanden ziet met "geconflicteerde kopie" in Finder, hebben twee personen waarschijnlijk hetzelfde bestand offline bewerkt. Open beide bestanden om te vergelijken, behoud de juiste versie en verwijder de geconflicteerde kopie.