Kanban Pro

Синхронізація хмари

Дізнайтеся, як ділитися папками хмари та спільно працювати в реальному часі.

Як працює синхронізація хмари

Kanban Pro — це програма з локальним пріоритетом. Кожен проект — це папка у вашій файловій системі, яка містить файли квитків Markdown та каталог конфігурації .kanban/. Немає облікових записів, немає власних хмарних сервісів і немає реєстрацій.

Для спільної роботи з іншими просто поміщайте папку проекту в каталог, синхронізований з хмарою — iCloud Drive, Dropbox, Google Drive, OneDrive або будь-який мережевий диск. Кожен учасник відкриває одну й ту ж папку в Kanban Pro, а зміни автоматично поширюються через служби синхронізації файлів постачальника хмари.

Підказка

Облік Kanban Pro не потрібен. Синхронізація використовує файлову систему безпосередньо — якщо ваш постачальник хмари може синхронізувати папку, Kanban Pro працює з нею.

Налаштування спільного проекту

  1. Виберіть папку хмари. Відкрийте Finder і перейдіть до каталогу синхронізації вашого постачальника хмари (наприклад, ~/Library/Mobile Documents/com~apple~CloudDocs/ для iCloud Drive, ~/Dropbox/ для Dropbox або монтування Google Drive / OneDrive на бічну панель Finder).
  2. Створіть папку проекту. Створіть нову папку для вашого проекту, наприклад Дошка команди.
  3. Відкрийте її в Kanban Pro. Запустіть Kanban Pro, натисніть Відкрити папку і виберіть щойно створену папку. Kanban Pro ініціалізує каталог .kanban/ і ви можете почати додавати стовпці та квитки.
  4. Поділіться папкою. Використовуйте функції спільного доступу вашого постачальника хмари для запрошення співавторів. На iCloud Drive клацніть правою кнопкою миші на папку й виберіть Поділитися. На Dropbox або Google Drive використовуйте діалогове вікно спільного доступу. На OneDrive клацніть правою кнопкою миші й виберіть Поділитися → Поділитися через OneDrive. Кожен співавтор повинен відкрити одну й ту ж синхронізовану папку у власній копії Kanban Pro.

Підказка

При спільному доступі установіть дозволи на Може редагувати (не Може переглядати), щоб співавтори могли створювати й оновлювати квитки.

Рекомендована структура папок

Коли Kanban Pro ініціалізує проект, він створює таку структуру в обраній папці:

Дошка команди/
  .kanban/ — конфігурація проекту
    board.json — стовпці, параметри, спеціальні поля
    locks/ — активні блокування редагування (див. нижче)
    activity/ — записи журналу активності
  attachments/ — завантажені зображення та файли
  KAN-1.md — квиток (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Кожен квиток — це простий файл Markdown із YAML frontmatter для метаданих (статус, пріоритет, призначена особа, теги, спеціальні поля). Ви можете читати, редагувати або створювати резервні копії цих файлів будь-яким інструментом — включаючи агентів кодування ШІ, які працюють безпосередньо з файловою системою.

Синхронізація в реальному часі та редагування без конфліктів

Kanban Pro стежить за папкою проекту на предмет змін у файловій системі за допомогою спостерігача файлів у реальному часі. Коли співавтор зберігає квиток або оновлює конфігурацію дошки, зміна виявляється протягом секунд і інтерфейс користувача автоматично оновлюється.

Як уникнути конфліктів

  • Блокування квитка: Коли ви відкриваєте квиток для редагування, Kanban Pro створює невеликий файл блокування всередину .kanban/locks/. Інші користувачі бачать квиток як заблокований і не можуть перезаписати ваші зміни. Файли блокування синхронізуються через вашого постачальника хмари, тому всі співавтори бачать один і той же стан блокування.
  • Атомарні записи: Кожен квиток — це один файл Markdown. Kanban Pro спочатку записує у тимчасовий файл, а потім перейменовує його на місце — запобігаючи частковим оновленням, навіть якщо постачальник хмари синхронізується під час запису.
  • Виявлення завершення запису: Kanban Pro чекає стабілізації файлів (2 секунди для квитків, 1 секунда для конфігурації дошки) перед їхнім читанням. Це гарантує, що хмарна синхронізація завершила запис перед обробкою програмою змін.
  • Остання запис перемагає для конфігурації дошки: Порядок стовпців, параметри та визначення спеціальних полів зберігаються в board.json. Якщо два користувачі одночасно змінюють параметри дошки, остання запис перемагає — але це рідко в практиці, оскільки конфігурація дошки змінюється нечасто.

Розуміння файлів блокування

Каталог .kanban/locks/ містить тимчасові файли блокування, які вказують, які квитки в даний час редагуються і кимось. Кожен файл блокування — це невеликий документ JSON:

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

Файли блокування створюються при відкритті квитка для редагування й видаляються при закритті редактора. Вони дозволяють Kanban Pro відображати візуальний індикатор на заблокованих квитках, щоб співавтори знали, що хтось над ними працює.

Дозвіл старих блокувань

Якщо Kanban Pro потрапить в аварію або пристрій перейде в режим без мережі, файл блокування може залишитися без очищення. Це називається старим блокуванням.

Старе блокування?

Якщо квиток виглядає заблокованим, але ніхто його не редагує, ви можете безпечно видалити відповідний файл в .kanban/locks/ за допомогою Finder або терміналу. Kanban Pro виявить видалення й розблокує квиток.

Kanban Pro також виявляє блокування старші за 24 години й позначає їх як потенційно старі в інтерфейсі, даючи вам можливість примусово розблокувати прямо з програми.

Примітки постачальника хмари

iCloud Drive

iCloud Drive безпроблемно працює з Kanban Pro. macOS тримає недавно завантажені файли завантаженими локально, тому ваша дошка завантажується миттєво. Якщо файл квитка було вилучено з локального сховища (відображається як невеликий файл заповнювача .icloud у Finder), macOS завантажує його за запитом — ви можете помітити невелику затримку при відкриванні дуже великих проектів вперше.

Спільне використання папки iCloud Drive

  1. Відкрийте Finder і перейдіть до папки iCloud Drive на бічній панелі.
  2. Клацніть правою кнопкою миші на папку проекту й виберіть Поділитися → Співпраця.
  3. Установіть дозволи на «Лише запрошені люди» і «Може робити зміни».
  4. Введіть адреси електронної пошти ваших співавторів і натисніть Поділитися.

Підказка

Щоб файли проекту завжди були доступні на вашому Mac, клацніть правою кнопкою миші на папку проекту у Finder й виберіть Збереження завантаженим. Це запобігає видаленню файлів macOS для економії місця.

Dropbox

Dropbox добре працює з Kanban Pro, але функція Smart Sync може видалити файли квитків для економії місця на диску. Для найкращої продуктивності позначте папку проекту як Доступна в режимі без мережі, щоб усі файли залишилися на вашому Mac.

Налаштування автономного доступу

  1. Відкрийте Finder і перейдіть до папки Dropbox.
  2. Клацніть правою кнопкою миші на папку проекту.
  3. Виберіть Доступна в режимі без мережі.
  4. Зелена галочка підтверджує, що папка тепер зберігається локально.

Спільне використання папки Dropbox

  1. Клацніть правою кнопкою миші на папку проекту у Finder.
  2. Натисніть Поділитися… (поруч зі значком Dropbox).
  3. Натисніть Додати людей, введіть адреси електронної пошти й установіть дозволи на Може редагувати.
  4. Натисніть Поділитися для надсилання запрошення.

Google Drive

Google Drive for Desktop пропонує два режими синхронізації. Для Kanban Pro режим Mirror файлів настійно рекомендується, тому що він зберігає повну локальну копію вашого проекту — забезпечуючи миттєвий доступ без затримок завантаження.

Перемикання в режим Mirror

  1. Натисніть на значок Google Drive на рядку меню.
  2. Відкрийте Параметри.
  3. В розділі «Параметри синхронізації My Drive» виберіть Mirror файлів.
  4. Google Drive завантажить усі файли на ваш Mac. Це може зайняти багато часу для великих бібліотек.

Попередження

Режим «Потокова передача файлів» за замовчуванням завантажує файли за запитом, що може спричинити помітну затримку, коли Kanban Pro читає файли квитків. Переключіться в режим Mirror для найкращого досвіду.

Спільне використання папки Google Drive

  1. Клацніть правою кнопкою миші на папку проекту у Finder (всередину монтування Google Drive).
  2. Натисніть Поділитися.
  3. Введіть адреси електронної пошти співавторів і установіть доступ на Редактор.
  4. Натисніть Поділитися для надсилання запрошення.

OneDrive

OneDrive for Mac добре працює з Kanban Pro. Як і інші хмарні сервіси, OneDrive пропонує функцію «Файли за запитом», яка може видалити файли з локального сховища. Для найкращих результатів установіть папку проекту на Завжди зберігати на цьому пристрої.

Збереження файлів доступних локально

  1. Відкрийте Finder і перейдіть до папки OneDrive.
  2. Клацніть правою кнопкою миші на папку проекту.
  3. Виберіть Завжди зберігати на цьому пристрої.
  4. Зелена галочка підтверджує, що папка залишиться завантаженою.

Спільне використання папки OneDrive

  1. Клацніть правою кнопкою миші на папку проекту у Finder.
  2. Виберіть Поділитися → Поділитися через OneDrive.
  3. Введіть адреси електронної пошти співавторів і установіть дозволи на Може редагувати.
  4. Натисніть Надіслати.

Підказка

Уникайте спеціальних символів в імені папок чи файлів (:, *, ?, |) — OneDrive їх не підтримує, і вони можуть спричинити помилки синхронізації.

Мережеві диски та NAS

Kanban Pro працює з будь-яким змонтованим мережевим томом (SMB, AFP, NFS). Переконайтеся, що диск залишається змонтованим під час роботи. Якщо мережеве з'єднання впаде, Kanban Pro призупинить спостереження за файлами й відновить роботу, коли том стане доступним знову.

Найкращі практики

  • Тримайте папки проекту доступними в режимі без мережі. Позначте папку проекту як «Доступна в режимі без мережі», «Mirror файлів», «Завжди зберігати на цьому пристрої» або «Збереження завантаженим» залежно від вашого постачальника хмари. Це запобігає затримкам, спричиненим завантаженням файлів за запитом.
  • Тримайте структуру папок ненацього. Уникайте глибоко вкладених каталогів — плоска структура покращує надійність синхронізації у всіх постачальників.
  • Перевірте статус синхронізації перед закриттям Mac. Шукайте значки синхронізації в процесі у Finder або на рядку меню. Вимкнення під час синхронізації може залишити часткові файли, які заплутають співавторів.
  • Підтримуйте вільне місце для сховища. Залишайте не менше 10-15% вільного місця на диску Mac і не менше 20% вільного хмарного сховища. Низьке сховище може зупинити синхронізацію або запустити видалення файлів.
  • Використовуйте одного постачальника хмари в команді. Змішування постачальників (наприклад, одна людина на iCloud, інша на Dropbox) вимагає, щоб кожна людина мала власну копію — вони не синхронізуватимуться одна з одною.

Розв'язування проблем

  • Зміни не відображаються: Перевірте, що ваш постачальник хмари активно синхронізується. Шукайте значки стану синхронізації у Finder або на значку меню постачальника хмари. Kanban Pro оновлюється протягом секунд від виявлення змін файлу — якщо файл ще не синхронізовано, програма не може його побачити.
  • Квиток застряє як заблокований: Див. розділ про старі блокування вище. Ви можете примусово розблокувати з програми (для блокувань старших за 24 години) або вручну видалити файл блокування в .kanban/locks/.
  • Відсутні квитки після синхронізації: Деякі постачальники хмари затримують синхронізацію нових файлів. Почекайте і перевірте статус синхронізації вашого постачальника. Якщо проблема зберігається, переконайтеся, що папка установлена для синхронізації в режимі без мережі. На iCloud Drive переконайтеся, що файли не були замінені файлами заповнювача .icloud.
  • Повільне вихідне завантаження: Якщо ваш постачальник хмари потоком файлів за запитом, початкове завантаження може займати більше часу при завантаженні файлів. Переключіться на режим без мережі або дзеркало для найкращої продуктивності.
  • Синхронізація несподівано призупинена: Деякі постачальники хмари призупиняють синхронізацію, коли ваш Mac працює від батареї або на диску мало місця. Перевірте значок меню вашого постачальника на предмет індикаторів паузи й відновіть синхронізацію за необхідності.
  • Відображаються файли конфліктної копії: Якщо у Finder видно файли з назвою «Конфліктна копія», дві люди, ймовірно, редагували один файл в режимі без мережі. Відкрийте обидва файли для порівняння, збережіть правильну версію й видаліть конфліктну копію.