Synchronizácia v cloude

Ako funguje synchronizácia v cloude

Kanban Pro je aplikácia orientovaná na miestne úložisko. Každý projekt je priečinok v systéme súborov, ktorý obsahuje súbory Markdown lístkov a adresár konfigurácie .kanban/. Neexistujú žiadne konta, žiadne proprietárne cloudové služby a nie je potrebná registrácia.

Aby ste mohli spolupracovať s ostatnými, jednoducho umiestnite priečinok projektu do adresára synchrónizovaného v cloude — iCloud Drive, Dropbox, Google Drive, OneDrive alebo akýkoľvek sieťový pogon. Každý účastník otvára ten istý priečinok v Kanban Pro a zmeny sa automaticky šíria prostredníctvom synchronizácie súborov poskytovateľa cloudu.

Nastavenie zdieľaného projektu

1. Vyberte priečinok v cloude. Otvorte Finder a prejdite do adresára synchronizácie poskytovateľa cloudu (napr. ~/Library/Mobile Documents/com~apple~CloudDocs/ pre iCloud Drive, ~/Dropbox/ pre Dropbox alebo pripojenie Google Drive / OneDrive na bočnom paneli Findera).
2. Vytvorte priečinok projektu. Vytvorte nový priečinok pre váš projekt, napr. Team Board.
3. Otvorte ho v Kanban Pro. Spustite Kanban Pro, kliknite na Otvoriť priečinok a vyberte priečinok, ktorý ste práve vytvorili. Kanban Pro inicializuje adresár .kanban/ a môžete začať pridávať stĺpce a lístky.
4. Zdieľajte priečinok. Použite funkcie zdieľania poskytovateľa cloudu a pozvite spolupracovníkov. V iCloud Drive kliknite pravým tlačítkom na priečinok a vyberte Zdieľať. V Dropboxe alebo Google Drive použite dialógové okno zdieľania. V OneDrive kliknite pravým tlačítkom a vyberte Zdieľať → Zdieľať s OneDrive. Každý spolupracovník by potom mal otvoriť ten istý synchrónizovaný priečinok v svojej vlastnej kópii Kanban Pro.

Odporúčaná štruktúra priečinkov

Keď Kanban Pro inicializuje projekt, vytvorí nasledujúcu štruktúru v zvolenom priečinku:

Každý lístek je jednoduchý súbor Markdown s YAML frontmatter na metadáta (stav, priorita, pridelená osoba, značky, vlastné polia). Tieto súbory môžete čítať, upravovať alebo zálohovať pomocou akéhokoľvek nástroja — vrátane AI agentov, ktorí pracujú priamo so systémom súborov.

Synchronizácia v reálnom čase a úpravy bez konfliktov

Kanban Pro monitoruje priečinok projektu na zmeny systému súborov pomocou pozorovateľa súborov v reálnom čase. Keď spolupracovník uloží lístek alebo aktualizuje konfiguráciu dosky, zmena sa detekuje v priebehu niekoľkých sekúnd a užívateľské rozhranie sa automaticky obnoví.

Ako sa vyhýbajú konfliktom

• Zamykanie lístkov: Keď otvorite lístek na úpravy, Kanban Pro vytvorí malý súbor zámku v .kanban/locks/. Ďalší používatelia vidia lístek ako zamknutý a nemôžu prepísať vaše zmeny. Súbory zámkov sa synchrónizujú prostredníctvom poskytovateľa cloudu, takže všetci spolupracovníci vidia ten istý stav zámku.
• Atomické zápisy: Každý lístek je jeden súbor Markdown. Kanban Pro najskôr zapisuje do dočasného súboru a potom ho premenuje — zabránenie čiastkovým aktualizáciám, aj keď poskytovateľ cloudu synchrónizuje počas písania.
• Detekcia ukončenia zápisu: Kanban Pro čaká, kým sa súbory stabilizujú (2 sekundy pre lístky, 1 sekunda pre konfiguráciu dosky), skôr ako ich prečíta. Tým sa zabezpečí, že synchronizácia v cloude bola dokončená, skôr ako aplikácia spracuje zmenu.
• Posledný zápis zvíťazí pre konfigurácií dosky: Poradie stĺpcov, nastavenia a definície vlastných polí sa ukladajú do board.json. Ak dvaja používatelia súčasne zmenia nastavenia dosky, posledný zápis zvíťazí — ale v praxi je to vzácne, pretože konfigurácia dosky sa zriedka mení.

Porozumenie súborom zámkov

Adresár .kanban/locks/ obsahuje dočasné súbory zámkov, ktoré naznačujú, ktoré lístky sa práve upravujú a kto ich upravuje. Každý súbor zámku je malý dokument JSON:

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

Súbory zámkov sa vytvoria, keď sa lístek otvorí na úpravu, a odstrania sa, keď sa editor zavrie. Umožňujú Kanban Pro zobraziť vizuálny indikátor na zamknutých lístkoch, aby spolupracovníci vedeli, že niekto na nich pracuje.

Riešenie starých zámkov

Ak Kanban Pro spadne alebo zariadenie prejde do offline režimu, súbor zámku môže zostať bez čistenia. To sa nazýva starý zámok.

Kanban Pro tiež detekuje zámky staršie ako 24 hodín a označuje ich ako potenciálne staré v užívateľskom rozhraní, čo vám dáva možnosť vynútiť odomknutie priamo z aplikácie.

Poznámky poskytovateľa cloudu

Osvedčené postupy

• Udržiavajte priečinky projektov dostupné offline. Označte priečinok projektu ako "Dostupný offline", "Zrkadlené súbory", "Vždy ponechaj na tomto zariadení" alebo "Ponechaj stiahnuté" v závislosti od poskytovateľa cloudu. Tým sa vyhne oneskoreniam spôsobeným sťahovaním súborov na požiadavku.
• Udržiavajte štruktúru priečinkov plochú. Vyhýbajte sa hlboko vnoreným adresárom — plochá štruktúra zlepšuje spoľahlivosť synchronizácie u všetkých poskytovateľov.
• Skontrolujte stav synchronizácie pred zatvorením Macu. Hľadajte ikony synchronizácie v priebehu v Finderi alebo na paneli menu. Vypnutie počas synchronizácie môže zanechať čiastkové súbory, ktoré mätú spolupracovníkov.
• Udržiavajte voľné úložisko. Udržiavajte aspoň 10–15% voľného miesta na disku na Macu a aspoň 20% voľného cloudového úložiska. Nízke úložisko môže zastaviť synchronizáciu alebo spustiť vyradenie súboru.
• Používajte rovnakého poskytovateľa cloudu v celom tíme. Miešanie poskytovateľov (napr. jedna osoba v iCloud, ďalšia v Dropboxe) vyžaduje, aby mal každý svoju kópiu — navzájom sa nebudú synchrónizovať.

Riešenie problémov

• Zmeny sa neobjavujú: Skontrolujte, či poskytovateľ cloudu aktívne synchrónizuje. Hľadajte ikony stavu synchronizácie v Finderi alebo v ikone panelu menu poskytovateľa. Kanban Pro sa obnoví v priebehu niekoľkých sekúnd od zistenia zmeny súboru — ak súbor ešte nie je synchrónizovaný, aplikácia ho nemôže vidieť.
• Lístek zostáva zamknutý: Pozrite si sekciu starých zámkov vyššie. Môžete vynútiť odomknutie z aplikácie (pre zámky staršie ako 24 hodín) alebo ručne vymazať súbor zámku v .kanban/locks/.
• Lístky chýbajú po synchronizácií: Niektorí poskytovatelia cloudu oneskorujú synchronizáciu nových súborov. Počkajte chvíľu a skontrolujte stav synchronizácie poskytovateľa. Ak problém pretrváva, skontrolujte, či je priečinok nastavený na offline synchronizáciu. V iCloud Drive skontrolujte, či súbory neboli nahradené .icloud zástupnými symbolmi.
• Pomalé počiatočné načítanie: Ak poskytovateľ cloudu streamuje súbory na požiadavku, prvé načítanie môže trvať dlhšie pri sťahovaní súborov. Prepnite sa na offline alebo režim zrkadlenia na dosiahnutie najlepšieho výkonu.
• Synchronizácia sa neočakávane pozastavila: Niektorí poskytovatelia cloudu pozastavujú synchronizáciu, keď je Mac na batérii alebo má málo miesta na disku. Skontrolujte ikonu poskytovateľa na paneli menu na indikátory pozastavenia a v prípade potreby obnovte synchronizáciu.
• Súbory s názvom "conflicted copy" sa objavujú: Ak vidíte súbory pomenované "conflicted copy" v Finderi, dvaja ľudia pravdepodobne upravovali ten istý súbor offline. Otvorte oba súbory a porovnajte ich, ponechajte správnu verziu a vymažte konfliktný súbor.