Synchronizacja chmury

Jak działa synchronizacja chmury

Kanban Pro to aplikacja zorientowana na pamięć lokalną. Każdy projekt to folder w systemie plików zawierający pliki biletów Markdown i katalog konfiguracji .kanban/. Nie ma kont, brak zastrzeżonych usług w chmurze i nie jest wymagana rejestracja.

Aby współpracować z innymi, po prostu umieść folder projektu w katalogu zsynchronizowanym w chmurze — iCloud Drive, Dropbox, Google Drive, OneDrive lub dowolny dysk sieciowy. Każdy uczestnik otwiera ten sam folder w Kanban Pro, a zmiany rozprzestrzeniają się automatycznie poprzez synchronizację plików dostawcy chmury.

Konfigurowanie udostępnionego projektu

1. Wybierz folder w chmurze. Otwórz Finder i przejdź do katalogu synchronizacji dostawcy chmury (np. ~/Library/Mobile Documents/com~apple~CloudDocs/ dla iCloud Drive, ~/Dropbox/ dla Dropbox lub Google Drive / OneDrive montaż na pasku bocznym Findera).
2. Utwórz folder projektu. Utwórz nowy folder dla projektu, np. Team Board.
3. Otwórz go w Kanban Pro. Uruchom Kanban Pro, kliknij na Otwórz folder i wybierz folder, który właśnie utworzyłeś. Kanban Pro zainicjalizuje katalog .kanban/ i możesz zacząć dodawać kolumny i bilety.
4. Udostępnij folder. Użyj funkcji udostępniania dostawcy chmury i zaproś współpracowników. W iCloud Drive kliknij prawym przyciskiem myszy na folder i wybierz Udostępnij. W Dropbox lub Google Drive użyj okna dialogowego udostępniania. W OneDrive kliknij prawym przyciskiem myszy i wybierz Udostępnij → Udostępnij z OneDrive. Każdy współpracownik powinien następnie otworzyć ten sam folder zsynchronizowany w swojej kopii Kanban Pro.

Zalecana struktura folderów

Gdy Kanban Pro inicjalizuje projekt, tworzy następującą strukturę w wybranym folderze:

Każdy bilet to zwykły plik Markdown z YAML frontmatter na potrzeby metadanych (stan, priorytet, przypisana osoba, znaczniki, pola niestandardowe). Możesz czytać, edytować lub tworzyć kopie zapasowe tych plików za pomocą dowolnego narzędzia — w tym agentów AI, którzy pracują bezpośrednio z systemem plików.

Synchronizacja w czasie rzeczywistym i edycja bez konfliktów

Kanban Pro monitoruje folder projektu pod kątem zmian systemu plików za pomocą obserwatora plików w czasie rzeczywistym. Gdy współpracownik zapisze bilet lub zaktualizuje konfigurację tablicy, zmiana zostanie wykryta w ciągu kilku sekund, a interfejs użytkownika zostanie automatycznie odświeżony.

Jak unika się konfliktów

• Blokowanie biletów: Po otwarciu biletu do edycji Kanban Pro tworzy mały plik blokady w .kanban/locks/. Inni użytkownicy widzą bilet jako zablokowany i nie mogą nadpisać zmian. Pliki blokady synchronizują się przez dostawcę chmury, więc wszyscy współpracownicy widzą ten sam stan blokady.
• Zapisy atomowe: Każdy bilet to jeden plik Markdown. Kanban Pro najpierw pisze do pliku tymczasowego, a następnie go zmienia — zapobiegając aktualizacjom częściowym, nawet jeśli dostawca chmury synchronizuje się podczas pisania.
• Detekcja ukończenia zapisu: Kanban Pro czeka, aż pliki się ustabilizują (2 sekundy dla biletów, 1 sekunda dla konfiguracji tablicy), zanim je przeczyta. Zapewnia to, że synchronizacja chmury została zakończona, zanim aplikacja przetworzy zmianę.
• Ostatni zapis zwycięża dla konfiguracji tablicy: Kolejność kolumn, ustawienia i definicje pól niestandardowych są przechowywane w board.json. Jeśli dwaj użytkownicy jednocześnie zmienią ustawienia tablicy, ostatni zapis wygrywa — ale w praktyce jest to rzadkie, ponieważ konfiguracja tablicy zmienia się rzadko.

Zrozumienie plików blokady

Katalog .kanban/locks/ zawiera tymczasowe pliki blokady wskazujące, które bilety są aktualnie edytowane i przez kogo. Każdy plik blokady to mały dokument JSON:

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

Pliki blokady są tworzone po otwarciu biletu do edycji i usuwane po zamknięciu edytora. Umożliwiają Kanban Pro wyświetlanie wizualnego wskaźnika na zablokowanych biletach, aby współpracownicy wiedzieli, że ktoś nad nimi pracuje.

Rozwiązywanie starych blokad

Jeśli Kanban Pro się zawali lub urządzenie przejdzie do trybu offline, plik blokady może pozostać bez czyszczenia. Nazywa się to starą blokadą.

Kanban Pro wykrywa również blokady starsze niż 24 godziny i oznacza je jako potencjalnie stare w interfejsie użytkownika, dając możliwość wymuszenia odblokowania bezpośrednio z aplikacji.

Notatki dostawcy chmury

Najlepsze praktyki

• Przechowuj foldery projektów dostępne offline. Oznacz folder projektu jako "Dostępny offline", "Dubluj pliki", "Zawsze przechowuj na tym urządzeniu" lub "Przechowuj pobrane" w zależności od dostawcy chmury. Unika to opóźnień spowodowanych pobieraniem plików na żądanie.
• Utrzymuj strukturę folderów płaską. Unikaj głęboko zagnieżdżonych katalogów — struktura płaska poprawia niezawodność synchronizacji u wszystkich dostawców.
• Sprawdzaj stan synchronizacji przed zamknięciem Maca. Poszukaj ikon synchronizacji w toku w Finderze lub pasku menu. Zamykanie podczas synchronizacji może pozostawić pliki częściowe, które mylą współpracowników.
• Utrzymuj wolne miejsce do magazynowania. Przechowuj co najmniej 10–15% wolnego miejsca na dysku na Macu i co najmniej 20% wolnego magazynu w chmurze. Niska pojemność magazynu może wstrzymać synchronizację lub wyzwolić usunięcie pliku.
• Używaj tego samego dostawcy chmury w całym zespole. Mieszanie dostawców (np. jedna osoba w iCloud, inna w Dropbox) wymaga, aby każdy miał własną kopię — nie będą się synchronizować ze sobą.

Rozwiązywanie problemów

• Zmiany się nie pojawiają: Sprawdź, czy dostawca chmury aktywnie synchronizuje. Poszukaj ikon stanu synchronizacji w Finderze lub ikonie paska menu dostawcy. Kanban Pro odświeża się w ciągu kilku sekund od wykrycia zmiany pliku — jeśli plik nie został jeszcze zsynchronizowany, aplikacja go nie widzi.
• Bilet pozostaje zablokowany: Zobacz sekcję starych blokad powyżej. Możesz wymusić odblokowanie z aplikacji (dla blokad starszych niż 24 godziny) lub ręcznie usunąć plik blokady w .kanban/locks/.
• Brakuje biletów po synchronizacji: Niektórzy dostawcy chmury opóźniają synchronizację nowych plików. Poczekaj chwilę i sprawdź stan synchronizacji dostawcy. Jeśli problem się utrzymuje, sprawdź, czy folder jest ustawiony na synchronizację offline. Na iCloud Drive sprawdź, czy pliki nie zostały zastąpione symbolami zastępczymi .icloud.
• Powolne załadowanie początkowe: Jeśli dostawca chmury przesyła pliki na żądanie, pierwsze załadowanie może trwać dłużej podczas pobierania plików. Przełącz się na tryb offline lub dublowania, aby uzyskać najlepszą wydajność.
• Synchronizacja nieoczekiwanie się wstrzymuje: Niektórzy dostawcy chmury wstrzymują synchronizację, gdy Mac jest na baterii lub ma mało miejsca na dysku. Sprawdzę ikonę dostawcy na pasku menu, aby sprawdzić wskaźniki wstrzymania i w razie potrzeby wznów synchronizację.
• Pojawiają się pliki o nazwie "conflicted copy": Jeśli widzisz pliki o nazwie "conflicted copy" w Finderze, prawdopodobnie dwie osoby edytowały ten sam plik offline. Otwórz oba pliki, aby je porównać, zachowaj poprawną wersję i usuń plik w konflikcie.