Kanban Pro

Bulut Senkronizasyonu

Bulut klasörlerini nasıl paylaşacağınızı ve gerçek zamanlı olarak nasıl işbirliği yapacağınızı öğrenin.

Bulut Sinkronizasyonu Nasıl Çalışır?

Kanban Pro yerel-birinci bir uygulamadır. Her proje, dosya sisteminizde Markdown bilet dosyaları ve bir .kanban/ yapılandırma dizini içeren bir klasördür. Hesap yok, tescilli bulut hizmetleri yok, kayıt yok.

Diğerleriyle işbirliği yapmak için, proje klasörünüzü basitçe bulut senkronize edilmiş bir dizine yerleştirin — iCloud Drive, Dropbox, Google Drive, OneDrive veya herhangi bir ağ sürücüsü. Her katılımcı aynı klasörü Kanban Pro'da açar ve değişiklikler bulut sağlayıcısının dosya sinkronizasyonu aracılığıyla otomatik olarak yayılır.

İpucu

Kanban Pro hesabı gerekli değildir. Sinkronizasyon dosya sistemini doğrudan kullanır — bulut sağlayıcınız bir klasörü senkronize edebiliyorsa, Kanban Pro onunla çalışır.


Paylaşılan Proje Kurulumu

  1. Bulut klasörü seçin. Finder'ı açın ve bulut sağlayıcınızın sinkronizasyon dizinine gidin (örneğin iCloud Drive için ~/Library/Mobile Documents/com~apple~CloudDocs/, Dropbox için ~/Dropbox/ veya Finder kenar çubuğunda Google Drive / OneDrive montajı).
  2. Proje klasörü oluşturun. Projeniz için yeni bir klasör oluşturun, ör. Takım Panosu.
  3. Bunu Kanban Pro'da açın. Kanban Pro'yu başlatın, Klasörü Aç'ı tıklatın ve yeni oluşturduğunuz klasörü seçin. Kanban Pro .kanban/ dizinini başlatacak ve sütun ve bilet eklemeye başlayabilirsiniz.
  4. Klasörü paylaşın. Bulut sağlayıcınızın paylaşım özellikleri kullanarak işbirliğine katılmaya davet edin. iCloud Drive'da, klasörü sağ tıklatın ve Paylaş'ı seçin. Dropbox veya Google Drive'da paylaşım iletişim kutusunu kullanın. OneDrive'da sağ tıklatın ve Paylaş → OneDrive ile Paylaş'ı seçin. Her işbirlikçi Kanban Pro'nın kendi kopyasında aynı senkronize edilmiş klasörü açmalıdır.

İpucu

Paylaşırken, izinleri Düzenleyebilir (Yalnızca Görüntüleyebilir değil) olarak ayarlayın, böylece işbirliğine katılanlar bilet oluşturabilir ve güncelleyebilir.


Önerilen Klasör Düzeni

Kanban Pro bir projeyi başlattığında, seçtiğiniz klasörün içinde aşağıdaki yapıyı oluşturur:

Takım Panosu/
  .kanban/ — proje yapılandırması
    board.json — sütunlar, ayarlar, özel alanlar
    locks/ — etkin düzenleme kilitlemesi (aşağıya bakın)
    activity/ — etkinlik günlüğü girdileri
  attachments/ — yüklenen resimler ve dosyalar
  KAN-1.md — bilet (Markdown + YAML ön konu)
  KAN-2.md
  KAN-3.md

Her bilet, meta veriler (durum, öncelik, atanmış, etiketler, özel alanlar) için YAML ön konulu düz bir Markdown dosyasıdır. Bu dosyaları herhangi bir araç ile okuyabilir, düzenleyebilir veya yedekleyebilirsiniz — dosya sistemiyle doğrudan çalışan yapay zeka kodlama aracıları da dahil olmak üzere.


Gerçek Zamanlı Senkronizasyon ve Çatışmasız Düzenleme

Kanban Pro, gerçek zamanlı bir dosya izleyici kullanarak proje klasörünü dosya sistemi değişiklikleri için izler. Bir işbirliğine katılan bilet kaydettiğinde veya pano yapılandırmasını güncellediğinde, değişiklik saniyeler içinde algılanır ve kullanıcı arayüzü otomatik olarak yenilenir.

Çatışmalar nasıl engellenir

  • Bilet kilitleme: Bir bileti düzenlemeye açtığınızda, Kanban Pro .kanban/locks/ içinde küçük bir kilit dosyası oluşturur. Diğer kullanıcılar bileti kilitli olarak görürler ve değişikliklerinizin üzerine yazamazlar. Kilit dosyaları bulut sağlayıcınız üzerinden senkronize edilir, böylece tüm işbirliğine katılanlar aynı kilit durumunu görür.
  • Atomik yazma: Her bilet tek bir Markdown dosyasıdır. Kanban Pro önce geçici bir dosyaya yazar, sonra yerinde yeniden adlandırır — bulut sağlayıcı yazma sırasında senkronize olsa bile kısmi güncellemeleri engeller.
  • Yazma bitiş algılaması: Kanban Pro dosyaları okumadan önce istikrar için bekler (biletler için 2 saniye, pano konfigürasyonu için 1 saniye). Bu, bulut senkronizasyonunun uygulamanın değişikliği işlemesinden önce yazma işlemini bitirmesini sağlar.
  • Pano yapılandırması için son yazma kazanır: Sütun sırası, ayarlar ve özel alan tanımları board.json içinde depolanır. İki kullanıcı aynı anda pano ayarlarını değiştirirse, son yazma kazanır — ancak bu pratikte nadir olabilir çünkü pano konfigürasyonu nadiren değişir.

Kilit Dosyalarını Anlama

.kanban/locks/ dizini, hangi biletlerin şu anda düzenlendiğini ve kimin tarafından düzenlendiğini gösteren geçici kilit dosyaları içerir. Her kilit dosyası küçük bir JSON belgesidir:

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

Kilit dosyaları bir bilet düzenlemeye açıldığında oluşturulur ve düzenleyici kapatıldığında kaldırılır. Kanban Pro'nun kilitli biletlerde görsel bir gösterge gösterebilmesini sağlarlar, böylece işbirliğine katılanlar birinin üzerinde çalıştığını bilir.

Eski kilitlenmeler çözümü

Kanban Pro kilitlenirse veya bir cihaz çevrimdışı olursa, kilit dosyası temizlenmeden kalabilir. Buna eski kilit denir.

Eski kilit?

Bir bilet kilitli görünüyorsa ancak hiç kimse onu düzenlemiyorsa, Finder veya terminali kullanarak .kanban/locks/ dosyasını güvenle silebilirsiniz. Kanban Pro kaldırışı algılayacak ve bileti kilidini açacaktır.

Kanban Pro ayrıca 24 saatten daha eski kilitlenmeleri algılar ve kullanıcı arayüzünde potansiyel olarak eski olarak işaretler, bu da doğrudan uygulamadan kilidi açmayı zorla seçeneği sunar.


Bulut Sağlayıcı Notları

iCloud Drive

iCloud Drive, Kanban Pro ile sorunsuz bir şekilde çalışır. macOS yakın zamanda erişilen dosyaları yerel olarak indirilmiş tutar, böylece panonuz anında yüklenir. Bir bilet dosyası yerel depodan çıkarılırsa (Finder'da .icloud yer tutucu olarak gösterilir), macOS bunu talep üzerine indir — çok büyük projeleri ilk kez açarken kısa bir gecikme fark edebilirsiniz.

iCloud Drive klasörü paylaşma

  1. Finder'ı açın ve kenar çubukta iCloud Drive klasörüne gidin.
  2. Sağ tıklayın proje klasörüne ve Paylaş → İşbirliği Yap'ı seçin.
  3. İzinleri ayarlayın "Sadece davet edilen insanlar" ve "Değişiklik yapabilir".
  4. İş ortakları e-posta adreslerini girin ve Paylaş'ı tıklatın.

İpucu

Proje dosyalarını her zaman Mac'inizde kullanılabilir tutmak için Finder'da proje klasörüne sağ tıklayın ve İndir tutuştur'u seçin. Bu, macOS'un yer kazanmak için dosyaları kaldırmasını engeller.

Dropbox

Dropbox Kanban Pro ile iyi çalışır, ancak Smart Sync özelliği disk alanı tasarrufu için bilet dosyalarını kaldırabilir. En iyi performans için, proje klasörünüzü Çevrimdışı Kullanılabilir olarak işaretleyin, böylece tüm dosyalar Mac'inizde kalır.

Çevrimdışı erişim kurma

  1. Finder'ı açın ve Dropbox klasörüne gidin.
  2. Sağ tıklayın proje klasörüne.
  3. Çevrimdışı Yap'ı seçin.
  4. Yeşil işaret simgesi klasörün artık yerel olarak tutulduğunu doğrular.

Dropbox klasörü paylaşma

  1. Sağ tıklayın Finder'daki proje klasörüne.
  2. Paylaş…'ı tıklatın (Dropbox simgesinin yanında).
  3. Kişi Ekle'yi tıklatın, e-posta adreslerini girin ve izinleri Düzenleyebilir olarak ayarlayın.
  4. Paylaş'ı tıklatın daveti göndermek için.

Google Drive

Google Drive for Desktop iki sinkronizasyon modu sunar. Kanban Pro için, Mirror dosyaları modu önemle önerilir çünkü projenizin tam yerel bir kopyasını tutar — anında erişimi sağlar ve indirme gecikmesi yoktur.

Mirror moduna geçiş

  1. Menü çubuğunuzda Google Drive simgesini tıklatın.
  2. Tercihler'i açın.
  3. "My Drive sinkronizasyon seçenekleri" altında, Mirror dosyaları'nı seçin.
  4. Google Drive tüm dosyaları Mac'inizde indir. Büyük kitaplıklar için bu uzun sürebilir.

Uyarı

Varsayılan "Akış dosyaları" modu dosyaları talep üzerine indir, bu da Kanban Pro bilet dosyaları okuduğunda gözle görülür gecikmeye neden olabilir. En iyi deneyim için Mirror moduna geçin.

Google Drive klasörü paylaşma

  1. Sağ tıklayın Finder'daki proje klasörüne (Google Drive montaj içinde).
  2. Paylaş'ı tıklatın.
  3. İş ortağı e-posta adreslerini girin ve erişimi Düzenleyici olarak ayarlayın.
  4. Paylaş'ı tıklatın daveti göndermek için.

OneDrive

OneDrive for Mac Kanban Pro ile iyi çalışır. Diğer bulut hizmetleri gibi, OneDrive, dosyaları yerel depolamadan kaldırabilen Dosyalar İsteğe Bağlı olarak bir özellik sunar. En iyi sonuçlar için, proje klasörünüzü Bu Cihazda Her Zaman Tut'a ayarlayın.

Dosyaları yerel olarak kullanılabilir tutma

  1. Finder'ı açın ve OneDrive klasörüne gidin.
  2. Sağ tıklayın proje klasörüne.
  3. Bu Cihazda Her Zaman Tut seçin.
  4. Yeşil işaret simgesi klasörün indirilmiş kalacağını doğrular.

OneDrive klasörü paylaşma

  1. Sağ tıklayın Finder'daki proje klasörüne.
  2. Paylaş → OneDrive ile Paylaş seçin.
  3. İş ortağı e-posta adreslerini girin ve izinleri Düzenleyebilir olarak ayarlayın.
  4. Gönder'i tıklatın.

İpucu

Klasör veya dosya adlarında özel karakterleri (:, *, ?, |) kullanmaktan kaçının — OneDrive bunları desteklemez ve sinkronizasyon hatalarına neden olabilir.

Ağ Sürücüleri ve NAS

Kanban Pro herhangi bir monte ağ birimi ile çalışır (SMB, AFP, NFS). Çalışma sırasında sürücünün monte edilmiş olarak kalmasını sağlayın. Ağ bağlantısı kesilirse, Kanban Pro dosya izlemeyi duraklatır ve birim yeniden kullanılabilir olduğunda devam eder.


En İyi Uygulamalar

  • Proje klasörlerini çevrimdışı olarak kullanılabilir tutun. Proje klasörünüzü bulut sağlayıcınıza bağlı olarak "Çevrimdışı Kullanılabilir", "Mirror dosyaları", "Bu Cihazda Her Zaman Tut" veya "İndir"' olarak işaretleyin. Bu, talep üzerine dosya indirmesinden kaynaklanan gecikmeleri engeller.
  • Klasör yapısını sığ tutun. Derin içiçe dizinlerden kaçının — düz düzen tüm sağlayıcılar arasında senkronizasyon güvenilirliğini artırır.
  • Mac'inizi kapatmadan önce sinkronizasyon durumunu kontrol edin. Finder veya menü çubuğunda sinkronizasyon-devam eden simgeleri arayın. Mid-sync kapatmak, işbirliğine katılanları karıştıran kısmi dosyalar bırakabilir.
  • Boş depolama alanını koruyun. Mac'inize en az %10-15 boş disk alanı ve en az %20 boş bulut depolama alanı tutun. Düşük depolama sinkronizasyonu durdurabilir veya dosya kaldırmasını tetikleyebilir.
  • Tüm takım genelinde aynı bulut sağlayıcıyı kullanın. Sağlayıcıları karıştırmak (örneğin bir kişi iCloud, diğeri Dropbox) her kişinin kendi kopyasına sahip olmasını gerektirir — birbirleriyle senkronize olmayacaklardır.

Sorun Giderme

  • Değişiklikler görünmüyor: Bulut sağlayıcınızın aktif olarak senkronize olduğunu kontrol edin. Finder veya bulut sağlayıcının menü çubuğu simgesinde sinkronizasyon durumu simgeleri arayın. Kanban Pro, bir dosya değişikliğini algıladığında saniyeler içinde yenilenir — dosya henüz senkronize edilmemişse, uygulama bunu göremez.
  • Bilet kilitli olarak takılmış: Yukarıdaki eski kilit bölümüne bakın. Uygulamadan kilidi açmayı zorlayabilir (24 saatten daha eski kilitlemeler için) veya kilit dosyasını .kanban/locks/ içinde manuel olarak silebilirsiniz.
  • Sinkronizasyondan sonra eksik biletler: Bazı bulut sağlayıcılar yeni dosyaları senkronize etmeyi geciketir. Bir an bekleyin ve sağlayıcınızın sinkronizasyon durumunu kontrol edin. Sorun devam ederse, klasörün çevrimdışı sinkronize etmek için ayarlandığını doğrulayın. iCloud Drive'da dosyaların .icloud yer tutucu dosyalarıyla değiştirilmediğini kontrol edin.
  • Yavaş ilk yük: Bulut sağlayıcınız dosyaları talep üzerine akış sırasında, ilk yükleme dosyalar indirilirken daha uzun sürebilir. En iyi performans için çevrimdışı veya mirror moduna geçin.
  • Senkronizasyon beklenmedik şekilde duraklatıldı: Bazı bulut sağlayıcılar Mac'iniz pil gücüyken veya disk alanı az olduğunda senkronizasyonu duraklatır. Duraklatma göstergeleri için sağlayıcınızın menü çubuğu simgesini kontrol edin ve gerekirse sinkronizasyonu sürdürün.
  • Çatışmalı kopya dosyaları görünüyor: Finder'da "çatışmalı kopya" adlı dosyalar görürseniz, iki kişi muhtemelen çevrimdışı iken aynı dosyayı düzenledi. Her iki dosyayı açarak karşılaştırın, doğru sürümü tutun ve çatışmalı kopyayı silin.