Kanban Pro

Sincronizarea în cloud

Aflați cum să partajați foldere în cloud și să colaborați în timp real.

Cum funcționează sincronizarea în cloud

Kanban Pro este o aplicație local-first. Fiecare proiect este un folder pe sistemul dumneavoastră de fișiere care conține fișiere de bilet Markdown și un director de configurare .kanban/. Nu există conturi, fără servicii cloud proprietare și fără înregistrări.

Pentru a colabora cu alții, pur și simplu plasați folderul proiectului în interiorul unui director sincronizat în cloud — iCloud Drive, Dropbox, Google Drive, OneDrive sau orice unitate de rețea. Fiecare participant deschide același folder în Kanban Pro, iar schimbările se propagă automat prin sincronizarea de fișiere a furnizorului de cloud.

Sfat

Nu este necesar niciun cont Kanban Pro. Sincronizarea folosește sistemul de fișiere direct — dacă furnizorul dumneavoastră de cloud poate sincroniza un folder, Kanban Pro funcționează cu acesta.

Configurarea unui proiect partajat

  1. Alegeți un folder în cloud. Deschideți Finder și navigați la directorul de sincronizare al furnizorului dumneavoastră de cloud (de exemplu, ~/Library/Mobile Documents/com~apple~CloudDocs/ pentru iCloud Drive, ~/Dropbox/ pentru Dropbox, sau montarea Google Drive / OneDrive din bara laterală a Finder-ului).
  2. Creați un folder de proiect. Creați un nou folder pentru proiectul dumneavoastră, de exemplu, Team Board.
  3. Deschideți-l în Kanban Pro. Lansați Kanban Pro, faceți clic pe Deschideți folder și selectați folderul pe care tocmai l-ați creat. Kanban Pro va inițializa directorul .kanban/ și puteți începe să adăugați coloane și bilete.
  4. Partajați folderul. Utilizați caracteristicile de partajare ale furnizorului dumneavoastră de cloud pentru a invita colaboratori. Pe iCloud Drive, faceți clic dreapta pe folder și alegeți Partajați. Pe Dropbox sau Google Drive, utilizați dialogul de partajare. Pe OneDrive, faceți clic dreapta și selectați Partajați → Partajați cu OneDrive. Fiecare colaborator ar trebui apoi să deschidă același folder sincronizat în propria copie de Kanban Pro.

Sfat

La partajare, setați permisiunile la Poate edita (nu Poate vedea) astfel încât colaboratorii să poată crea și actualiza bilete.

Structura de folder recomandată

Când Kanban Pro inițializează un proiect, acesta creează următoarea structură în folderul ales:

Team Board/
  .kanban/ — configurare proiect
    board.json — coloane, setări, câmpuri personalizate
    locks/ — lacate de editare active (a se vedea mai jos)
    activity/ — intrări jurnal activitate
  attachments/ — imagini și fișiere încărcate
  KAN-1.md — bilet (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Fiecare bilet este un fișier Markdown simplu cu YAML frontmatter pentru metadate (stare, prioritate, atribuit, etichete, câmpuri personalizate). Puteți citi, edita sau face copie de siguranță a acestor fișiere cu orice instrument — inclusiv agenți de codare AI care funcționează direct cu sistemul de fișiere.

Sincronizare în timp real și editare fără conflicte

Kanban Pro monitorizează folderul proiectului pentru schimbări ale sistemului de fișiere folosind un observator de fișiere în timp real. Când un colaborator salvează un bilet sau actualizează configurația plăcii, schimbarea este detectată în câteva secunde și interfața utilizatorului se reîmprospătează automat.

Cum sunt evitate conflictele

  • Blocarea biletelor: Când deschideți un bilet pentru editare, Kanban Pro creează un mic fișier de blocare în .kanban/locks/. Alți utilizatori văd biletul ca blocat și nu pot suprascrie schimbările dumneavoastră. Fișierele de blocare sunt sincronizate prin furnizorul dumneavoastră de cloud, astfel încât toți colaboratorii să vadă aceeași stare de blocare.
  • Scrieri atomice: Fiecare bilet este un singur fișier Markdown. Kanban Pro scrie mai întâi într-un fișier temporar și apoi o redenumește — evitând actualizări parțiale chiar dacă furnizorul de cloud se sincronizează la jumătatea scrierii.
  • Detecția finalizării scrierii: Kanban Pro așteaptă ca fișierele să se stabilizeze (2 secunde pentru bilete, 1 secundă pentru configurarea plăcii) înainte de a le citi. Acest lucru garantează că sincronizarea în cloud s-a terminat de scris înainte ca aplicația să proceseze schimbarea.
  • Ultima scriere câștigă pentru configurarea plăcii: Ordinea coloanelor, setările și definițiile câmpurilor personalizate sunt stocate în board.json. Dacă doi utilizatori schimbă setările plăcii în același timp, ultima scriere câștigă — dar acest lucru este rar în practică, deoarece configurarea plăcii se schimbă rar.

Înțelegerea fișierelor de blocare

Directorul .kanban/locks/ conține fișiere de blocare temporare care indică ce bilete sunt în curs de editare și de cine. Fiecare fișier de blocare este un mic document JSON:

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

Fișierele de blocare sunt create atunci când un bilet este deschis pentru editare și eliminate atunci când editorul este închis. Acestea permit Kanban Pro să afișeze un indicator vizual pe biletele blocate, astfel încât colaboratorii să știe că cineva lucrează la ele.

Rezolvarea lacatelor depășite

Dacă Kanban Pro se prăbușește sau un dispozitiv se deconectează, un fișier de blocare poate rămâne neîncurajat. Aceasta se numește blocare depășită.

Blocare depășită?

Dacă un bilet pare blocat, dar nimeni nu îl editează, puteți șterge cu siguranță fișierul corespunzător din .kanban/locks/ utilizând Finder sau terminalul. Kanban Pro va detecta ștergerea și va debloca biletul.

Kanban Pro detectează, de asemenea, lacate mai vechi de 24 de ore și le marchează ca potențial depășite în interfața utilizatorului, dandu-vă opțiunea de a forța deblocarea direct din aplicație.

Note despre furnizori de cloud

iCloud Drive

iCloud Drive funcționează perfect cu Kanban Pro. macOS păstrează fișierele accesate recent descărcate local, deci placa dumneavoastră se încarcă instantaneu. Dacă un fișier de bilet a fost eliminat din stocarea locală (afișat ca mic fișier .icloud în Finder), macOS îl descarcă la cerere — s-ar putea să observați o mică întârziere la deschiderea proiectelor foarte mari pentru prima dată.

Partajarea unui folder iCloud Drive

  1. Deschideți Finder și navigați la folderul dumneavoastră iCloud Drive în bara laterală.
  2. Faceți clic dreapta pe folderul proiectului și selectați Partajați → Colaborați.
  3. Setați permisiunile la « Doar persoane invitate » și « Poate face schimbări ».
  4. Introduceți adresele de e-mail ale colaboratorilor dumneavoastră și faceți clic pe Partajați.

Sfat

Pentru a păstra fișierele proiectului întotdeauna disponibile pe Mac-ul dumneavoastră, faceți clic dreapta pe folderul proiectului în Finder și alegeți Păstrați descărcat. Aceasta previne macOS de la a elimina fișiere pentru a economisi spațiu.

Dropbox

Dropbox funcționează bine cu Kanban Pro, dar caracteristica Smart Sync poate elimina fișiere de bilete pentru a economisi spațiu pe disc. Pentru cea mai bună performanță, marcați folderul proiectului ca Disponibil offline, astfel încât toate fișierele să rămână pe Mac-ul dumneavoastră.

Configurarea accesului offline

  1. Deschideți Finder și navigați la folderul dumneavoastră Dropbox.
  2. Faceți clic dreapta pe folderul proiectului.
  3. Selectați Disponibil offline.
  4. O iconiță cu bifare verde confirmă că folderul este acum păstrat local.

Partajarea unui folder Dropbox

  1. Faceți clic dreapta pe folderul proiectului în Finder.
  2. Faceți clic pe Partajați… (lângă iconița Dropbox).
  3. Faceți clic pe Adăugați persoane, introduceți adresele de e-mail și setați permisiunile la Poate edita.
  4. Faceți clic pe Partajați pentru a trimite invitația.

Google Drive

Google Drive for Desktop oferă două moduri de sincronizare. Pentru Kanban Pro, modul Fișiere oglindă este foarte recomandat, deoarece menține o copie locală completă a proiectului dumneavoastră — garantând acces instant fără întârzieri de descărcare.

Comutarea la modul Oglindă

  1. Faceți clic pe iconița Google Drive din bara dumneavoastră de meniu.
  2. Deschideți Preferințe.
  3. Sub « Opțiuni de sincronizare a Unității mele », selectați Fișiere oglindă.
  4. Google Drive va descărca toate fișierele pe Mac-ul dumneavoastră. Aceasta poate dura ceva timp pentru biblioteci mari.

Avertisment

Modul implicit « Fișiere în streaming » descarcă fișiere la cerere, ceea ce poate cauza latență perceptibilă atunci când Kanban Pro citește fișiere de bilete. Comutați la modul Oglindă pentru cea mai bună experiență.

Partajarea unui folder Google Drive

  1. Faceți clic dreapta pe folderul proiectului în Finder (în montarea dumneavoastră Google Drive).
  2. Faceți clic pe Partajați.
  3. Introduceți adresele de e-mail ale colaboratorilor și setați accesul la Editor.
  4. Faceți clic pe Partajați pentru a trimite invitația.

OneDrive

OneDrive for Mac funcționează bine cu Kanban Pro. Ca și alte servicii cloud, OneDrive oferă o caracteristică Fișiere la cerere care poate elimina fișiere din stocarea locală. Pentru cei mai buni rezultati, setați folderul proiectului la Păstrați întotdeauna pe acest dispozitiv.

Păstrarea fișierelor disponibile local

  1. Deschideți Finder și navigați la folderul dumneavoastră OneDrive.
  2. Faceți clic dreapta pe folderul proiectului.
  3. Selectați Păstrați întotdeauna pe acest dispozitiv.
  4. O iconiță cu bifare verde confirmă că folderul va rămâne descărcat.

Partajarea unui folder OneDrive

  1. Faceți clic dreapta pe folderul proiectului în Finder.
  2. Selectați Partajați → Partajați cu OneDrive.
  3. Introduceți adresele de e-mail ale colaboratorilor și setați permisiunile la Poate edita.
  4. Faceți clic pe Trimiteți.

Sfat

Evitați caractere speciale în numele de foldere sau fișiere (:, *, ?, |) — OneDrive nu le acceptă și pot cauza erori de sincronizare.

Unități de rețea și NAS

Kanban Pro funcționează cu orice volum de rețea montat (SMB, AFP, NFS). Asigurați-vă că unitatea rămâne montată în timp ce lucrați. Dacă conexiunea de rețea cade, Kanban Pro va întrerupe monitorizarea fișierelor și va relua atunci când volumul este din nou disponibil.

Bune practici

  • Păstrați folderele de proiect disponibile offline. Marcați folderul proiectului ca « Disponibil offline », « Fișiere oglindă », « Păstrați întotdeauna pe acest dispozitiv » sau « Păstrați descărcat » în funcție de furnizorul dumneavoastră de cloud. Aceasta evită întârzierile cauzate de descărcări de fișiere la cerere.
  • Păstrați structura folderului plată. Evitați directoare profund imbricate — o structură plată îmbunătățește fiabilitatea sincronizării pe toți furnizorii.
  • Verificați starea sincronizării înainte de a închide Mac-ul. Căutați iconițe de sincronizare în curs în Finder sau bara de meniu. Oprirea în mijlocul sincronizării poate lăsa fișiere parțiale care derutează colaboratorii.
  • Mențineți spațiul de stocare liber. Păstrați cel puțin 10–15% spațiu liber pe Mac-ul dumneavoastră și cel puțin 20% stocare în cloud liberă. Stocarea scăzută poate opri sincronizarea sau declanșa eliminarea fișierelor.
  • Utilizați același furnizor de cloud pe întreaga echipă. Amestecarea furnizonilor (de exemplu o persoană pe iCloud, alta pe Dropbox) necesită ca fiecare persoană să aibă propria copie — nu se vor sincroniza între ele.

Depanare

  • Schimbările nu apar: Verificați că furnizorul dumneavoastră de cloud se sincronizează activ. Căutați iconițe de stare a sincronizării în Finder sau iconița din bara de meniu a furnizorului de cloud. Kanban Pro se reîmprospătează în câteva secunde de la detectarea unei schimbări de fișier — dacă fișierul nu a fost încă sincronizat, aplicația nu poate să îl vadă.
  • Bilet blocat ca blocat: Vedeți secțiunea de lacate depășite mai sus. Puteți forța deblocarea din aplicație (pentru lacate mai vechi de 24 de ore) sau ștergeți manual fișierul de blocare din .kanban/locks/.
  • Bilete dispărute după sincronizare: Unii furnizori de cloud întârzie sincronizarea fișierelor noi. Așteptați ceva timp și verificați starea sincronizării furnizorului. Dacă problema persistă, verificați dacă folderul este setat pentru sincronizarea offline. Pe iCloud Drive, verificați dacă fișierele nu au fost înlocuite cu fișiere substituente .icloud.
  • Încărcare inițială lentă: Dacă furnizorul dumneavoastră de cloud transmite fișiere la cerere, încărcarea inițială poate dura mai mult în timp ce fișierele sunt descărcate. Comutați la modul offline sau oglindă pentru cea mai bună performanță.
  • Sincronizare întreruptă neașteptat: Unii furnizori de cloud întrerup sincronizarea atunci când Mac-ul funcționează cu baterie sau are puțin spațiu pe disc. Verificați iconița din bara de meniu a furnizorului pentru indicatori de pauză și relansați sincronizarea dacă este necesar.
  • Fișiere de copie conflictă care apar: Dacă vedeți fișiere numite cu « copie conflictă » în Finder, probabil doi oameni au editat același fișier offline. Deschideți ambele fișiere pentru a compara, păstrați versiunea corectă și ștergeți copia conflictă.