Kanban Pro

Sinhronizacija oblaka

Naučite dijeliti mape u oblaku i surađivati u stvarnom vremenu.

Kako funkcionira sinhronizacija oblaka

Kanban Pro je aplikacija usmjerena na lokalnu pohranu. Svaki projekt je mapa u vašem datotečnom sustavu koja sadrži Markdown datoteke karata i direktorij .kanban/ za konfiguraciju. Nema računa, nema vlasničkih oblačnih usluga i nema potrebe za registracijom.

Kako biste surađivali s drugima, jednostavno stavite mapu projekta u direktorij sinhroniziran u oblaku — iCloud Drive, Dropbox, Google Drive, OneDrive ili bilo koji mrežni pogon. Svaki sudionik otvara istu mapu u Kanban Prou, a promjene se automatski šire kroz sinhronizaciju datoteka davatelja oblačne usluge.

Savjet

Račun Kanban Pro nije potreban. Sinhronizacija koristi datotečni sustav izravno — ako vaš davatelj oblačne usluge može sinhronizirati mapu, Kanban Pro s njom funkcionira.

Postavljanje zajedničkog projekta

  1. Odaberite mapu u oblaku. Otvorite Finder i prijeđite na direktorij sinhronizacije davatelja oblačne usluge (npr. ~/Library/Mobile Documents/com~apple~CloudDocs/ za iCloud Drive, ~/Dropbox/ za Dropbox ili Google Drive / OneDrive montažu u bočnoj traci Findera).
  2. Stvorite mapu projekta. Stvorite novu mapu za svoj projekt, npr. Team Board.
  3. Otvorite je u Kanban Prou. Pokrenite Kanban Pro, kliknite na Otvorite mapu i odaberite mapu koju ste upravo stvorili. Kanban Pro će inicijalizirati direktorij .kanban/ i možete početi dodavati stupce i kartice.
  4. Podijelite mapu. Koristite značajke dijeljenja davatelja oblačne usluge i pozvite suradnike. Na iCloud Driveu desnom tipkom kliknite na mapu i odaberite Dijeli. Na Dropboxu ili Google Driveu koristite dijaloški okvir dijeljenja. Na OneDriveu desnom tipkom kliknite i odaberite Dijeli → Dijeli s OneDrivea. Svaki suradnik bi trebao zatim otvoriti istu sinhroniziranu mapu u svojoj vlastitoj kopiji Kanban Proa.

Savjet

Tijekom dijeljenja postavite dozvole na Može uređivati (ne Može gledati) kako bi suradnici mogli stvoriti i ažurirati kartice.

Preporučena struktura mapa

Kada Kanban Pro inicijalizira projekt, stvara sljedeću strukturu u odabranoj mapi:

Team Board/
  .kanban/ — konfiguracija projekta
    board.json — stupci, postavke, prilagođena polja
    locks/ — aktivne zaključane datoteke (vidi dolje)
    activity/ — stavke dnevnika aktivnosti
  attachments/ — učitane slike i datoteke
  KAN-1.md — kartica (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Svaka kartica je obična Markdown datoteka s YAML frontmatterom za metapodatke (stanja, prioritet, dodijeljena osoba, oznake, prilagođena polja). Možete čitati, uređivati ili sigurnosno kopirati te datoteke bilo kojim alatom — uključujući AI agente koji rade izravno s datotečnim sustavom.

Sinhronizacija u stvarnom vremenu i bez sukoba uređivanja

Kanban Pro prati mapu projekta za promjene datotečnog sustava koristeći nadzirač datoteka u stvarnom vremenu. Kada suradnik spremi karticu ili ažurira konfiguraciju ploče, promjena se detektira u roku od nekoliko sekundi i korisničko sučelje se automatski osvježi.

Kako se izbjegavaju sukobi

  • Zaključavanje kartica: Kada otvorite karticu za uređivanje, Kanban Pro stvara malu zaključanu datoteku u .kanban/locks/. Ostali korisnici vide karticu kao zaključanu i ne mogu prebrisati vaše promjene. Zaključane datoteke sinhroniziraju se kroz davatelja oblačne usluge tako da svi suradnici vide isto stanje zaključavanja.
  • Atomske upise: Svaka kartica je jedna Markdown datoteka. Kanban Pro prvo piše u privremenu datoteku, zatim je preimenova — sprječavanje parcijalnih ažuriranja čak i ako davatelj oblačne usluge sinhronizira tijekom pisanja.
  • Detekcija završetka pisanja: Kanban Pro čeka dok se datoteke ne stabiliziraju (2 sekunde za kartice, 1 sekunda za konfiguraciju ploče) prije čitanja. To osigurava da je sinhronizacija u oblaku dovršena prije nego što aplikacija obradi promjenu.
  • Posljednje pisanje pobjeđuje za konfiguraciju ploče: Redoslijed stupaca, postavke i definicije prilagođenih polja pohranjuju se u board.json. Ako dva korisnika istovremeno promijene postavke ploče, posljednje pisanje pobjeđuje — ali je to u praksi rijetko jer se konfiguracija ploče rijetko mijenja.

Razumijevanje zaključanih datoteka

Direktorij .kanban/locks/ sadrži privremene zaključane datoteke koje označavaju koje kartice se trenutno uređuju i od strane koga. Svaka zaključana datoteka je mali JSON dokument:

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

Zaključane datoteke stvaraju se kada se kartica otvori za uređivanje i uklanjaju se kada se uređivač zatvori. Omogućuju Kanban Prou da prikaže vizualni pokazatelj na zaključanim karticama kako bi suradnici znali da netko na njima radi.

Rješavanje zastarjelih zaključavanja

Ako Kanban Pro padne ili se uređaj odslijedi, zaključana datoteka može ostati bez čišćenja. To se zove zastarjelo zaključavanje.

Zastarjelo zaključavanje?

Ako kartica izgleda zaključana ali je nitko ne uređuje, možete sigurno izbrisati odgovarajuću datoteku u .kanban/locks/ koristeći Finder ili terminal. Kanban Pro će otkriti brisanje i otključati karticu.

Kanban Pro također otkriva zaključavanja starija od 24 sata i označava ih kao potencijalno zastarjela u korisničkom sučelju, što vam daje mogućnost prisilnog otključavanja izravno iz aplikacije.

Napomene davatelja oblačne usluge

iCloud Drive

iCloud Drive nesmetano funkcionira s Kanban Proul. macOS održava nedavno pristupljene datoteke preuzete lokalno, pa se vaša ploča učitava odmah. Ako je datoteka kartice izbrisana iz lokalne pohrane (prikazuje se kao mali .icloud rezervirani znak u Finderu), macOS je preuzima na zahtjev — možda ćete primijetiti kratko kašnjenje pri otvaranju vrlo velikih projekata prvi put.

Dijeljenje mape iCloud Drivea

  1. Otvorite Finder i prijeđite na mapu iCloud Drivea u bočnoj traci.
  2. Desnom tipkom kliknite na mapu projekta i odaberite Dijeli → Suradnja.
  3. Postavite dozvole na "Samo pozvane osobe" i "Može promijeniti".
  4. Unesite e-mailove adrese suradnika i kliknite na Dijeli.

Savjet

Kako biste datoteke projekta održali dostupnima na Macu, desnom tipkom kliknite na mapu projekta u Finderu i odaberite Drži preuzeto. To sprječava da macOS izbriše datoteke kako bi uštedjela mjesto.

Dropbox

Dropbox dobro funkcionira s Kanban Proul, ali njegova Smart Sync značajka može izbrisati datoteke kartica kako bi uštedjela prostor diska. Za najbolje performanse označite mapu projekta kao Dostupna offline kako bi sve datoteke ostale na vašem Macu.

Postavljanje offline pristupa

  1. Otvorite Finder i prijeđite na mapu Dropboxa.
  2. Desnom tipkom kliknite na mapu projekta.
  3. Odaberite Učini dostupnom offline.
  4. Zeleni simbol potvrde potvrđuje da je mapa sada pohranjena lokalno.

Dijeljenje mape Dropboxa

  1. Desnom tipkom kliknite na mapu projekta u Finderu.
  2. Kliknite na Dijeli… (pored ikonom Dropboxa).
  3. Kliknite na Dodaj ljude, unesite e-mailove adrese i postavite dozvole na Može uređivati.
  4. Kliknite na Dijeli i pošalji poziv.

Google Drive

Google Drive for Desktop nudi dva moda sinhronizacije. Za Kanban Pro, mod Zrcali datoteke je snažno preporučen jer čuva kompletnu lokalnu kopiju vašeg projekta — osiguravajući trenutni pristup bez kašnjenja preuzimanja.

Prebacivanje na mod zrcalenja

  1. Kliknite na ikonu Google Drivea u traci izbornika.
  2. Otvorite Preferences.
  3. U "Mogućnosti sinhronizacije Moj pogon" odaberite Zrcali datoteke.
  4. Google Drive će preuzeti sve datoteke na vaš Mac. Za velike biblioteke to može potrajati.

Upozorenje

Zadani mod "Strujaj datoteke" preuzima datoteke na zahtjev, što može uzrokovati primjetno kašnjenje kada Kanban Pro čita datoteke kartica. Prebacite se na mod zrcalenja za najbolje iskustvo.

Dijeljenje mape Google Drivea

  1. Desnom tipkom kliknite na mapu projekta u Finderu (unutar Google Drive montaže).
  2. Kliknite na Dijeli.
  3. Unesite e-mailove adrese suradnika i postavite pristup na Urednik.
  4. Kliknite na Dijeli i pošalji poziv.

OneDrive

OneDrive za Mac dobro funkcionira s Kanban Proul. Kao i druge oblačne usluge, OneDrive nudi značajku Datoteke na zahtjev koja može izbrisati datoteke iz lokalne pohrane. Za najbolje rezultate postavite mapu projekta na Uvijek drži na ovom uređaju.

Održavanje datoteka dostupnima lokalno

  1. Otvorite Finder i prijeđite na mapu OneDrivea.
  2. Desnom tipkom kliknite na mapu projekta.
  3. Odaberite Uvijek drži na ovom uređaju.
  4. Zeleni simbol potvrde potvrđuje da će mapa ostati preuzeta.

Dijeljenje mape OneDrivea

  1. Desnom tipkom kliknite na mapu projekta u Finderu.
  2. Odaberite Dijeli → Dijeli s OneDrivea.
  3. Unesite e-mailove adrese suradnika i postavite dozvole na Može uređivati.
  4. Kliknite na Pošalji.

Savjet

Izbjegavajte posebne znakove u nazivima mapa ili datoteka (:, *, ?, |) — OneDrive ih ne podržava i mogu uzrokovati greške sinhronizacije.

Mrežni pogoni i NAS

Kanban Pro radi s bilo kojim montiranim mrežnim volumenom (SMB, AFP, NFS). Pazite da pogon ostane montiran tijekom rada. Ako mrežna veza padne, Kanban Pro će pauzirati nadzor datoteka i nastaviti kada je volumen opet dostupan.

Najbolje prakse

  • Održavajte mape projekta dostupnima offline. Označite vašu mapu projekta kao "Dostupna offline", "Zrcali datoteke", "Uvijek drži na ovom uređaju" ili "Drži preuzeto" ovisno o davatelju oblačne usluge. To izbjegava kašnjenja uzrokovan preuzimanjem datoteka na zahtjev.
  • Učinite strukturu mape ravnom. Izbjegavajte duboko ugniježđene direktorije — ravna postavka poboljšava pouzdanost sinhronizacije kod svih davatelja.
  • Provjerite stanje sinhronizacije prije nego što zatvorite Mac. Potražite ikone sinhronizacije u tijeku u Finderu ili traci izbornika. Gašenje tijekom sinhronizacije može ostaviti parcijalne datoteke koje zbunjuju suradnike.
  • Održavajte slobodno skladište. Zadr žite najmanje 10–15% slobodnog prostora na disku na Macu i najmanje 20% slobodnog pohrane u oblaku. Niska pohrana može zaustaviti sinhronizaciju ili pokrenuti brisanje datoteka.
  • Koristite istog davatelja oblačne usluge tijekom cijelog tima. Miješanje davatelja (npr. jedna osoba na iCloudu, druga na Dropboxu) zahtijeva da svaki ima vlastitu kopiju — oni se međusobno neće sinhronizirati.

Otklanjanje grešaka

  • Promjene se ne pojavljuju: Provjerite aktivno sinhronizira li davatelj oblačne usluge. Potražite ikone stanja sinhronizacije u Finderu ili ikoni davatelja u traci izbornika. Kanban Pro osvježi u roku od nekoliko sekundi od detekcije promjene datoteke — ako datoteka još nije sinhronizirana, aplikacija je ne može vidjeti.
  • Kartica ostaje zaključana: Vidi odjeljak o zastarjelim zaključavanjima gore. Možete prisilno otključati iz aplikacije (za zaključavanja starija od 24 sata) ili ručno izbrisati zaključanu datoteku u .kanban/locks/.
  • Kartice nedostaju nakon sinhronizacije: Neki davatelji oblačne usluge odgađaju sinhronizaciju novih datoteka. Čekajte malo i provjerite stanje sinhronizacije davatelja. Ako se problem nastavi, provjerite je li mapa postavljena na sinhronizaciju offline. Na iCloud Driveu provjerite da datoteke nisu zamijenjene .icloud rezerviranim znakovima.
  • Spora početna učitavanja: Ako davatelj oblačne usluge struja datoteke na zahtjev, prvo učitavanje može trajati duže dok se datoteke preuzimaju. Prebacite na offline ili mod zrcalenja za najbolje performanse.
  • Sinhronizacija se neočekivano pauzira: Neki davatelji oblačne usluge pauziraju sinhronizaciju kada je Mac na bateriji ili ima malo prostora na disku. Provjerite ikonu davatelja u traci izbornika za indikatore pauze i nastavite sinhronizaciju ako je potrebno.
  • Datoteke s nazivom "conflicted copy" se pojavljuju: Ako vidite datoteke s nazivom "conflicted copy" u Finderu, dvije osobe su vjerojatno uređivale istu datoteku offline. Otvorite obje datoteke da biste ih usporedili, zadržite ispravnu verziju i izbrišite konfliktnu datoteku.