مزامنة السحابة

كيف تعمل مزامنة السحابة

Kanban Pro هي تطبيق موجه محليًا. كل مشروع عبارة عن مجلد على نظام الملفات الخاص بك يحتوي على ملفات تذاكر Markdown وديريكتوري تكوين .kanban/. لا توجد حسابات، ولا خدمات سحابية خاصة، ولا عمليات تسجيل.

للتعاون مع الآخرين، ضع ببساطة مجلد مشروعك داخل ديريكتوري مزامن سحابي — iCloud Drive أو Dropbox أو Google Drive أو OneDrive أو أي محرك شبكة. يفتح كل مشارك نفس المجلد في 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 بتهيئة مشروع، فإنه ينشئ الهيكل التالي داخل المجلد الذي اخترته:

كل تذكرة هي ملف Markdown عادي مع frontmatter YAML للبيانات الوصفية (الحالة والأولوية والمكلف والعلامات والحقول المخصصة). يمكنك قراءة أو تحرير أو نسخ احتياطي لهذه الملفات باستخدام أي أداة — بما في ذلك وكلاء ترميز الذكاء الاصطناعي الذين يعملون مباشرة مع نظام الملفات.

المزامنة في الوقت الفعلي والتحرير الخالي من التضارب

يراقب Kanban Pro مجلد المشروع للتغييرات في نظام الملفات باستخدام مراقب ملفات في الوقت الفعلي. عندما يحفظ متعاون تذكرة أو يحدث تكوين اللوحة، يتم اكتشاف التغيير في غضون ثوانٍ وتحديث الواجهة تلقائيًا.

كيف يتم تجنب التضارب

• قفل التذكرة: عندما تفتح تذكرة للتحرير، ينشئ Kanban Pro ملف قفل صغير داخل .kanban/locks/. يرى المستخدمون الآخرون التذكرة مقفلة ولا يمكنهم الكتابة فوق تغييراتك. تتم مزامنة ملفات الأقفال من خلال موفر السحابة الخاص بك بحيث يرى جميع المتعاونين نفس حالة القفل.
• الكتابات الذرية: كل تذكرة هي ملف Markdown واحد. يكتب Kanban Pro إلى ملف مؤقت أولاً، ثم يعيد تسميته في المكان — مما يمنع التحديثات الجزئية حتى لو كان موفر السحابة يقوم بمزامنة mid-write.
• كشف الكتابة: ينتظر Kanban Pro استقرار الملفات (ثانيتان للتذاكر، ثانية واحدة لتكوين اللوحة) قبل قراءتها. هذا يضمن انتهاء المزامنة السحابية من الكتابة قبل أن تعالج التطبيق التغيير.
• آخر كتابة تفوز لتكوين اللوحة: يتم تخزين ترتيب الأعمدة والإعدادات وتعريفات الحقول المخصصة في board.json. إذا قام مستخدمان بتغيير إعدادات اللوحة في نفس الوقت، فإن آخر كتابة تفوز — لكن هذا نادر في الممارسة العملية حيث يتم تغيير تكوين اللوحة بشكل غير متكرر.

فهم ملفات الأقفال

يحتوي ديريكتوري .kanban/locks/ على ملفات أقفال مؤقتة تشير إلى التذاكر التي تتم تحريرها حاليًا ومن قبل من. كل ملف قفل هو مستند JSON صغير:

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

يتم إنشاء ملفات الأقفال عند فتح تذكرة للتحرير وإزالتها عند إغلاق المحرر. تمكّن Kanban Pro من إظهار مؤشر مرئي على التذاكر المقفلة بحيث يعرف المتعاونون أن شخصًا ما يعمل عليها.

حل الأقفال القديمة

إذا توقف Kanban Pro أو ذهب جهاز ما في وضع عدم الاتصال، قد يبقى ملف قفل بدون تنظيف. يُطلق على هذا قفل قديم.

يكتشف Kanban Pro أيضًا الأقفال الأقدم من 24 ساعة ويعلمها كقديمة محتملة في الواجهة، مما يتيح لك خيار إرغام فتح القفل مباشرة من التطبيق.

ملاحظات موفر السحابة

أفضل الممارسات

• احفظ مجلدات المشروع متاحة في وضع عدم الاتصال. ضع علامة على مجلد المشروع الخاص بك كـ "متاح في وضع عدم الاتصال" أو "Mirror files" أو "الاحتفاظ دائمًا بهذا الجهاز" أو "الاحتفاظ بالتحميل" اعتمادًا على موفر السحابة الخاص بك. هذا يتجنب التأخيرات الناجمة عن تنزيلات الملفات عند الطلب.
• احفظ هيكل المجلد ضحلاً. تجنب الأدلة المتداخلة بعمق — يحسن التخطيط المسطح موثوقية المزامنة عبر جميع الموفرين.
• تحقق من حالة المزامنة قبل إغلاق جهاز Mac الخاص بك. ابحث عن رموز المزامنة الجارية في Finder أو شريط القوائم. قد يؤدي الإيقاف الفوري أثناء المزامنة إلى ترك ملفات جزئية تربك المتعاونين.
• الحفاظ على مساحة تخزين مجانية. احتفظ بنسبة 10-15٪ على الأقل من مساحة القرص المجانية على جهاز Mac والعديد من التخزين السحابي 20٪ على الأقل. قد توقف سعة التخزين المنخفضة المزامنة أو تؤدي إلى حذف الملفات.
• استخدم نفس موفر السحابة في الفريق. قد يؤدي خلط الموفرين (على سبيل المثال شخص واحد على iCloud وآخر على Dropbox) إلى الحاجة إلى أن يكون لكل شخص نسختهم الخاصة — لن تتزامن مع بعضهم البعض.

استكشاف الأخطاء

• التغييرات لا تظهر: تحقق من أن موفر السحابة الخاص بك يقوم بمزامنة فعالة. ابحث عن رموز حالة المزامنة في Finder أو رمز قائمة موفر السحابة. يحدّث Kanban Pro في غضون ثوانٍ من اكتشاف تغيير الملف — إذا لم تتم مزامنة الملف حتى الآن، فلا يمكن للتطبيق رؤيته.
• التذكرة عالقة كمقفلة: انظر قسم الأقفال القديمة أعلاه. يمكنك إرغام فتح القفل من التطبيق (للأقفال الأقدم من 24 ساعة) أو حذف ملف القفل يدويًا في .kanban/locks/.
• التذاكر المفقودة بعد المزامنة: قد يؤخر بعض موفري السحابة مزامنة الملفات الجديدة. انتظر لحظة وتحقق من حالة مزامنة موفرك. إذا استمرت المشكلة، تحقق من أن المجلد مُعيّن للمزامنة في وضع عدم الاتصال. على iCloud Drive، تحقق من أن الملفات لم تُستبدل بملفات نائبة .icloud.
• التحميل الأولي بطيء: إذا كان موفر السحابة الخاص بك يدفق الملفات عند الطلب، فقد يستغرق التحميل الأول وقتًا أطول أثناء تنزيل الملفات. قم بالتبديل إلى وضع عدم الاتصال أو وضع المرآة للحصول على أفضل أداء.
• توقفت المزامنة بشكل غير متوقع: قد توقف بعض موفري السحابة المزامنة عندما يكون جهاز Mac الخاص بك على بطارية أو بمساحة قرص منخفضة. تحقق من رمز شريط موفرك للحصول على مؤشرات الإيقاف واستئناف المزامنة إذا لزم الأمر.
• ظهور ملفات نسخة متنازع عليها: إذا رأيت ملفات بأسماء "نسخة متنازع عليها" في Finder، فقد قام شخصان بتحرير نفس الملف أثناء وضع عدم الاتصال. افتح كلا الملفين للمقارنة واحتفظ بالإصدار الصحيح وحذف النسخة المتنازع عليها.