Synchronizace cloudu

Jak funguje synchronizace cloudu

Kanban Pro je aplikace zaměřená na místní úložiště. Každý projekt je složka ve vašem systému souborů obsahující soubory lístků Markdown a adresář konfigurace .kanban/. Nejsou zde žádné účty, žádné proprietární cloudové služby a není třeba se registrovat.

Chcete-li spolupracovat s ostatními, jednoduše umístěte svou složku projektu do adresáře synchronizovaného v cloudu — iCloud Drive, Dropbox, Google Drive, OneDrive nebo jakoukoli síťovou jednotkou. Každý účastník otevře stejnou složku v Kanban Pro a změny se automaticky šíří prostřednictvím synchronizace souborů poskytovatele cloudu.

Nastavení sdíleného projektu

1. Vyberte složku v cloudu. Otevřete Finder a přejděte na adresář synchronizace vašeho poskytovatele cloudu (např. ~/Library/Mobile Documents/com~apple~CloudDocs/ pro iCloud Drive, ~/Dropbox/ pro Dropbox nebo připojení Google Drive / OneDrive v postranním panelu Finderu).
2. Vytvořte složku projektu. Vytvořte novou složku pro váš projekt, např. Team Board.
3. Otevřete ji v Kanban Pro. Spusťte Kanban Pro, klikněte na Otevřít složku a vyberte složku, kterou jste právě vytvořili. Kanban Pro inicializuje adresář .kanban/ a můžete začít přidávat sloupce a lístky.
4. Sdílejte složku. Použijte funkce sdílení svého poskytovatele cloudu a pozvěte spolupracovníky. U iCloud Drive klikněte pravým tlačítkem na složku a vyberte Sdílet. U Dropboxu nebo Google Drive použijte dialog sdílení. V OneDrive klikněte pravým tlačítkem a vyberte Sdílet → Sdílet s OneDrive. Každý spolupracovník by měl následně otevřít stejnou synchronizovanou složku ve své vlastní kopii Kanban Pro.

Doporučená struktura složek

Když Kanban Pro inicializuje projekt, vytvoří v zvolené složce následující strukturu:

Každý lístek je prostý soubor Markdown s YAML frontmatter pro metadata (stav, priorita, přiřazená osoba, značky, vlastní pole). Tyto soubory můžete číst, upravovat nebo zálohovat s jakýmkoli nástrojem — včetně agentů AI, kteří pracují přímo se systémem souborů.

Synchronizace v reálném čase a editace bez konfliktů

Kanban Pro sleduje složku projektu na změny systému souborů pomocí sledovače souborů v reálném čase. Když spolupracovník uloží lístek nebo aktualizuje konfiguraci desky, změna je zaznamenána během několika sekund a uživatelské rozhraní se automaticky obnoví.

Jak se vyhýbají konfliktům

• Zámkování lístků: Když otevřete lístek k úpravě, Kanban Pro vytvoří malý soubor zámku v .kanban/locks/. Ostatní uživatelé vidí lístek jako uzamčený a nemohou přepsat vaše změny. Soubory zámků se synchronizují prostřednictvím vašeho poskytovatele cloudu, takže všichni spolupracovníci vidí stejný stav zámku.
• Atomické zápisy: Každý lístek je jeden soubor Markdown. Kanban Pro nejprve zapisuje do dočasného souboru a poté jej přejmenuje — zabránění částečným aktualizacím, i když poskytovatel cloudu synchronizuje během zápisu.
• Detekce konce zápisu: Kanban Pro počká, dokud se soubory nestabilizují (2 sekundy pro lístky, 1 sekunda pro konfiguraci desky), než je přečte. To zajišťuje, že synchronizace v cloudu byla dokončena, než aplikace změnu zpracuje.
• Poslední zápis vyhrává pro konfiguraci desky: Pořadí sloupců, nastavení a definice vlastních polí jsou uloženy v board.json. Pokud dva uživatelé zároveň změní nastavení desky, poslední zápis vyhraje — ale v praxi je to vzácné, protože konfigurace desky se mění zřídka.

Porozumění souborům zámků

Adresář .kanban/locks/ obsahuje dočasné soubory zámků, které označují, které lístky se právě upravují a kým. Každý soubor zámku je malý dokument JSON:

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

Soubory zámků se vytvoří, když se lístek otevře k úpravě, a odeberou se, když se editor zavře. Umožňují Kanban Pro zobrazit vizuální indikátor na uzamčených lístcích, takže spolupracovníci vědí, že na nich někdo pracuje.

Řešení zastaralých zámků

Pokud Kanban Pro spadne nebo se zařízení odpojí, soubor zámku může zůstat bez vyčištění. To se nazývá zastaralý zámek.

Kanban Pro také detekuje zámky starší než 24 hodin a v uživatelském rozhraní je označí jako potenciálně zastaralé, což vám dává možnost zámek vynutit odemknout přímo z aplikace.

Poznámky k poskytovatelům cloudu

Osvědčené postupy

• Udržujte složky projektů dostupné offline. Označte svou složku projektu jako "Dostupné offline", "Zrcadlové soubory", "Vždy uchovávat na tomto zařízení" nebo "Udržovat stažené" v závislosti na vašem poskytovateli cloudu. To zabrání zpoždění způsobeným stahováními souborů na vyžádání.
• Udržujte strukturu složek mělkou. Vyhněte se hluboko vnořeným adresářům — ploché rozložení zlepšuje spolehlivost synchronizace u všech poskytovatelů.
• Zkontrolujte stav synchronizace před zavřením Macu. Hledejte ikony synchronizace v probíhajícím stavu v Finderu nebo v řádku menu. Vypnutí během synchronizace může zanechat částečné soubory, které zmátou spolupracovníky.
• Udržujte volné úložiště. Uchovávejte alespoň 10–15 % volného místa na disku na Macu a alespoň 20 % volného cloudového úložiště. Nízké úložiště může zastavit synchronizaci nebo spustit vyloučení souborů.
• Používejte stejného poskytovatele cloudu v celém týmu. Míchání poskytovatelů (např. jeden člověk v iCloud, druhý v Dropboxu) vyžaduje, aby měl každý svou vlastní kopii — nebudou se navzájem synchronizovat.

Řešení potíží

• Změny se neobjevují: Zkontrolujte, zda váš poskytovatel cloudu aktivně synchronizuje. Hledejte ikony stavu synchronizace v Finderu nebo v ikoně v řádku menu poskytovatele cloudu. Kanban Pro se obnoví během několika sekund od detekce změny souboru — pokud soubor ještě není synchronizován, aplikace jej nemůže vidět.
• Lístek zůstává uzamčený: Viz část zastaralých zámků výše. Můžete vynutit odemčení z aplikace (pro zámky starší než 24 hodin) nebo ručně smazat soubor zámku v .kanban/locks/.
• Chybějící lístky po synchronizaci: Někteří poskytovatelé cloudu odkládají synchronizaci nových souborů. Počkejte chvíli a zkontrolujte stav synchronizace poskytovatele. Pokud potíž přetrvává, ověřte, že je složka nastavena na synchronizaci offline. U iCloud Drive zkontrolujte, že soubory nebyly nahrazeny zástupnými soubory .icloud.
• Pomalé počáteční načítání: Pokud váš poskytovatel cloudu streamuje soubory na vyžádání, první načtení může trvat déle, zatímco se soubory stahují. Přepněte na režim offline nebo mirror pro nejlepší výkon.
• Synchronizace se neočekávaně pozastavila: Někteří poskytovatelé cloudu pozastaví synchronizaci, když je váš Mac na baterii nebo má málo místa na disku. Zkontrolujte ikonu vašeho poskytovatele v řádku menu na indikátory pozastavení a v případě potřeby obnovte synchronizaci.
• Soubory s názvem "conflicted copy" se objevují: Pokud vidíte soubory pojmenované s "conflicted copy" v Finderu, dva lidé pravděpodobně upravili stejný soubor offline. Otevřete oba soubory, aby jste je porovnali, zachovejte správnou verzi a odstraňte soubor s konfliktem.