Sincronització al núvol

Com funciona la sincronització al núvol

Kanban Pro és una aplicació local-first. Cada projecte és una carpeta al vostre sistema de fitxers que conté fitxers de tiquets Markdown i un directori de configuració .kanban/. No hi ha comptes, no hi ha serveis en núvol propietaris i no hi ha registres.

Per col·laborar amb altres, simplement poseu la vostra carpeta de projecte dins d'un directori sincronitzat per al núvol — iCloud Drive, Dropbox, Google Drive, OneDrive o qualsevol unitat de xarxa. Cada participant obri la mateixa carpeta a Kanban Pro, i els canvis es propaguen automàticament a través de la sincronització de fitxers del proveïdor en núvol.

Configuració d'un projecte compartit

1. Trieu una carpeta al núvol. Obriu el Finder i navegueu al directori de sincronització del vostre proveïdor en núvol (per exemple, ~/Library/Mobile Documents/com~apple~CloudDocs/ per a iCloud Drive, ~/Dropbox/ per a Dropbox, o el muntatge de Google Drive / OneDrive a la vostra barra lateral del Finder).
2. Creeu una carpeta de projecte. Creeu una nova carpeta per al vostre projecte, per exemple, Team Board.
3. Obriu-la a Kanban Pro. Inicieu Kanban Pro, feu clic a Obrir carpeta i seleccioneu la carpeta que acabeu de crear. Kanban Pro inicialitzarà el directori .kanban/ i podreu començar a afegir columnes i tiquets.
4. Compartiu la carpeta. Utilitzeu les funcions de compartició del vostre proveïdor en núvol per convidar col·laboradors. A iCloud Drive, feu clic amb el botó dret a la carpeta i trieu Compartir. A Dropbox o Google Drive, utilitzeu el quadre de diàleg de compartició. A OneDrive, feu clic amb el botó dret i seleccioneu Compartir → Compartir amb OneDrive. Cada col·laborador ha d'obrir la mateixa carpeta sincronitzada a la seva pròpia còpia de Kanban Pro.

Estructura de carpeta recomanada

Quan Kanban Pro inicialitza un projecte, crea la següent estructura dins de la carpeta triada:

Cada tiquet és un fitxer Markdown simple amb YAML frontmatter per a metadades (estat, prioritat, assignat, etiquetes, camps personalitzats). Podeu llegir, editar o fer còpia de seguretat d'aquests fitxers amb qualsevol eina — inclosos els agents de codificació de IA que funcionen directament amb el sistema de fitxers.

Sincronització en temps real i edició sense conflictes

Kanban Pro monitoritza la carpeta del projecte per a canvis del sistema de fitxers utilitzant un observador de fitxer en temps real. Quan un col·laborador guarda un tiquet o actualitza la configuració del tauler, el canvi es detecta en segons i la interfície d'usuari es refresca automàticament.

Com es prevenen els conflictes

• Bloqueig de tiquets: Quan obriu un tiquet per editar-lo, Kanban Pro crea un petit fitxer de bloqueix dins de .kanban/locks/. Altres usuaris veuen el tiquet com bloquejat i no poden sobrescriure els vostres canvis. Els fitxers de bloqueix es sincronitzen a través del vostre proveïdor en núvol de manera que tots els col·laboradors vegin el mateix estat de bloqueix.
• Escriptures atòmiques: Cada tiquet és un fitxer Markdown únic. Kanban Pro escriu primer en un fitxer temporal i després el reanomena — evitant actualitzacions parcials fins i tot si el proveïdor en núvol es sincronitza a mitges de l'escriptura.
• Detecció de finalització de l'escriptura: Kanban Pro espera que els fitxers es vagin estabilitzant (2 segons per a tiquets, 1 segon per a configuració del tauler) abans de llegir-los. Això garanteix que la sincronització en núvol hagi acabat d'escriure abans que l'aplicació processi el canvi.
• L'última escriptura guanya per a la configuració del tauler: L'ordre de les columnes, les configuracions i les definicions de camps personalitzats es desen a board.json. Si dos usuaris canvien les configuracions del tauler simultàniament, l'última escriptura guanya — però això és rar a la pràctica ja que la configuració del tauler canvia poc freqüentment.

Comprensió dels fitxers de bloqueix

El directori .kanban/locks/ conté fitxers de bloqueix temporals que indiquen quins tiquets s'estan editant i per qui. Cada fitxer de bloqueix és un petit document JSON:

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

Els fitxers de bloqueix es creen quan s'obri un tiquet per editar-lo i s'esborren quan es tanca l'editor. Permeten que Kanban Pro mostri un indicador visual en tiquets bloquejats perquè els col·laboradors sàpiguen que algú està treballant en ells.

Resolució de bloquejos obsolets

Si Kanban Pro s'acaba o un dispositiu es desconnecta, un fitxer de bloqueix pot romandre sense netejar-se. Això s'anomena un bloqueix obsolet.

Kanban Pro també detecta bloquejos més antics de 24 hores i els marca com a potencialment obsolets a la interfície d'usuari, donant-vos la opció de desbloquar fonsament directament des de l'aplicació.

Notes sobre proveïdors en núvol

Millors pràctiques

• Mantingueu les carpetes de projecte disponibles sense connexió. Marqueu la vostra carpeta de projecte com « Disponible sense connexió », « Fitxers mirall », « Mantenir sempre en aquest dispositiu » o « Mantenir descarregat » depenent del vostre proveïdor en núvol. Això evita retards causats per descàrregues de fitxer sota demanda.
• Mantingueu la estructura de carpeta seca. Eviteu directoris profundament niats — un disseny pla millora la fiabilitat de la sincronització a tots els proveïdors.
• Comproveu l'estat de sincronització abans de tancar el vostre Mac. Cerqueu les icones de sincronització en curs al Finder o a la barra de menús. Apagar al mig de la sincronització pot deixar fitxers parcials que confonen els col·laboradors.
• Mantingueu l'emmagatzematge lliure. Mantingueu almenys el 10–15% d'espai lliure al vostre Mac i almenys el 20% d'emmagatzematge en núvol lliure. L'emmagatzematge baix pot aturar la sincronització o activar l'expulsió de fitxers.
• Utilitzeu el mateix proveïdor en núvol a tot l'equip. Mesclar proveïdors (per exemple, una persona a iCloud, una altra a Dropbox) requereix que cada persona tingui la seva pròpia còpia — no es sincronitzaran entre elles.

Resolució de problemes

• Els canvis no apareixen: Comproveu que el vostre proveïdor en núvol s'està sincronitzant activament. Cerqueu les icones d'estat de sincronització al Finder o a la icona de barra de menús del proveïdor en núvol. Kanban Pro es refresca en segons de detectar un canvi de fitxer — si el fitxer encara no s'ha sincronitzat, l'aplicació no pot veure'l.
• Tiquet atrapat com a bloquejat: Veieu la secció de bloquejos obsolets a dalt. Podeu desbloquar fonsament des de l'aplicació (per a bloquejos més antics de 24 hores) o esborrar manualment el fitxer de bloqueix a .kanban/locks/.
• Tiquets desaparits després de la sincronització: Alguns proveïdors en núvol retarden la sincronització de fitxers nous. Espereu un moment i comproveu l'estat de sincronització del vostre proveïdor. Si el problema persisteix, comproveu que la carpeta estigui configurada per sincronitzar sense connexió. A iCloud Drive, comproveu que els fitxers no hagin estat reemplaçats per fitxers de placeholder .icloud.
• Carregament inicial lent: Si el vostre proveïdor en núvol transmet fitxers sota demanda, la primera càrrega pot trigar més temps mentre es descarreguen els fitxers. Canvieu al mode sense connexió o mirall per al millor rendiment.
• Sincronització pausada inesperadament: Alguns proveïdors en núvol pausa la sincronització quan el vostre Mac funciona amb bateria o té poc espai en disc. Comproveu la icona de barra de menús del vostre proveïdor per a indicadors de pausa i reprèn la sincronització si és necessari.
• Els fitxers de còpia conflictiva apareixen: Si veieu fitxers anomenats amb « còpia conflictiva » al Finder, probablement dues persones van editar el mateix fitxer sense connexió. Obriu ambdós fitxers per comparar, mantingueu la versió correcta i esborreu la còpia conflictiva.