حالة المزامنة

صفحة حالة المزامنة (/calendar/sync-status) هي عرض السجل لكل عملية مزامنة تقويم قام Zellbox بإجرائها لحسابك. هي المكان الذي تذهب إليه عندما يبدو شيء غير صحيح: "هل جرت المزامنة الدورية؟"، "لماذا لم يظهر حدث الأمس؟"، "ما الذي حجبه حارس السلامة للتو؟". تصل إليها من:

• تسمية متزامن قبل N على صفحة التقويم،
• رابط عرض سجل المزامنة الكامل ← على شريط حجر مزامنة،
• رابط عرض سجل المزامنة ← تحت Google Calendar في صفحة مزامنة Google (/google-sync)، أو
• بفتح /calendar/sync-status مباشرة.

اختيار نافذة زمنية

بطاقة فلتر في أعلى الصفحة تضيّق العمليات المدرجة. تضبط رقاقات النطاق السريع نوافذ شائعة مسبقًا؛ تتيح حقلا من / إلى ضبط أيٍّ من الجانبين بدقة؛ يُسقط مسح كلا الحدّين. عداد على اليمين بصيغة n عمليات في النافذة يخبرك بعدد مهام المزامنة المطابقة للفلتر الحالي.

الرقاقة	النافذة
آخر ساعة	الآن − 60 دقيقة
آخر 24 ساعة (افتراضي)	الآن − 24 ساعة
آخر 7 أيام	الآن − 7 أيام
آخر 30 يومًا	الآن − 30 يومًا
الكل	بلا حدود — محصور بـ 100 نتيجة، الأحدث أولًا

كل صفّ بطاقة حالة:

✓ Succeeded · Refresh · 2 min ago · 24s · 12 calendars · 1,247 events touched (812 added · 311 updated · 124 cancelled)
  12 done
  ▸ Show calendar details

تخبرك النقطة الملوّنة + رقاقة الحالة بالنتيجة في نظرة:

الحالة	المعنى
Succeeded (أخضر)	استقرّت جميع فروع التقاويم.
Partial (كهرماني)	بعض الفروع نجح وبعضها أخفق. وسّع الصفّ لمعرفة أيّها. يعرض الصفّ أيضًا عدد "محجوز للمراجعة" عندما يحجر حارس السلامة فوجًا.
Failed (أحمر)	كل الفروع أخفقت. عادةً ما يعني أن رمز OAuth منتهي الصلاحية — أعد ربط Google.
Queued / Running (أزرق)	المهمة قيد التنفيذ. تستطلع الصفحة تلقائيًا طالما أن أي مهمة غير منتهية.

يعرض الصفّ أيضًا مصدر التفعيل:

• Initial connect — مهمة البذر بعد OAuth التي تُجرى مرة واحدة عند ربط Google لأول مرة.
• Manual refresh — ضغطت زرّ تحديث على صفحة التقويم.
• Auto-sync — الفحص المجدول كل 5 دقائق.
• New calendar added — علّمت تقويمًا جديدًا في صفحة مزامنة Google؛ يُجري Zellbox مزامنة لمرة واحدة لبذره.

تحت العنوان، يلخّص سطر ثانٍ كيف تتقدّم فروع تقاويم العملية — مفيد للتمييز بين فحص قيد التنفيذ وآخر منتهٍ دون توسيع الصفّ:

8 done · 2 running · 2 queued

إذا لم يُسجَّل بعد أي تقدّم لكل تقويم (شبكة الأمان لأولى لحظات عملية جديدة)، يقرأ السطر لم يُسجَّل بعد تقدّم لكل تقويم.

التفاصيل لكل تقويم

اضغط على صفّ ← وسّع لرؤية التوزيع لكل تقويم. لكل فرع أيقونة حالة + أعداد خاصة به:

✓ primary               · 234 events synced
✓ Dr. Smith — Cardio    · 89 events synced
⚠ Shared — Pediatrics   · 47 cancellations held for review — [Approve]
✗ Dr. Lee — Dermatology · error: token expired (re-connect required)

تُرتَّب الفروع لتأتي المحجوزة والمخفقة أولًا — الأشياء التي تحتاج إلى انتباهك تظهر في الأعلى.

مراجعة إلغاء محجور

عندما يُطلق حارس السلامة، سترى شريطًا أصفر على لوحة التحكم وصفحات التقويم:

⚠ 47 إلغاء حدث في تقويم واحد محجوزة للمراجعة من قبل حارس السلامة.

للحلّ:

1. اضغط على مراجعة على الشريط، أو افتح صفحة حالة المزامنة.
2. وسّع الصفّ مع الفرع المحجوز.
3. اقرأ التشخيص: "X إلغاءات محتملة · حجم المرآة Y · السبب". يفسّر السبب لماذا انطلق الحارس:
   • on-seed — إلغاءات أثناء بذر أوليّ (مشبوه؛ مرآة جديدة لا ينبغي أن يكون فيها شيء يُلغى).
   • abs-limit — أكثر من 25 إلغاء في عملية واحدة.
   • pct-limit — أكثر من 20٪ من المرآة كانت ستُلغى.
4. اضغط على عرض الأحداث المحجوزة ← لتوسيع قائمة الأحداث (راجع أدناه). تفحّص للتأكد من أن الأحداث تبدو تنظيفًا جماعيًا مشروعًا وليس مشكلة اتصال.
5. اضغط على الموافقة على الإلغاءات. يحتوي مربع التأكيد على ثلاثة أقسام:
   • ما الذي سيحدث: العدد + معرّف التقويم.
   • لماذا انطلق الحارس: تفسير خاص بالسبب (نفس تمييز on-seed / pct-limit / abs-limit من الخطوة 3، لكن مصاغ لقرار المشغّل).
   • شبكة الأمان: كل حدث يوشك Zellbox على إلغائه يُلتقط آليًا في صورة إلى جدول النسخ الاحتياطي أولًا. لديك 90 يومًا لاستعادة أيٍّ منها فرديًا من الاسترداد — تعود الأحداث المستعادة بصفة Zellbox-only ولا تُدفع تلقائيًا إلى Google.
6. اضغط على تطبيق الإلغاءات. يدوّر Zellbox مهمة مزامنة جديدة لتقويم واحد مع تجاوز الحارس لذلك التقويم. تُطبَّق الإلغاءات؛ ترى مهمة التجاوز تظهر في أعلى السجل.

إذا فضّلت عدم الموافقة — مثلًا تشك في أن مالك تقويم مشترك حذف كل شيء عن طريق الخطأ — اترك الحجر في مكانه. ستُخلي المزامنة النظيفة التالية الموقع تلقائيًا.

تفصيل الأحداث المحجوزة

تحت سطر التشخيص، يحمّل عرض الأحداث المحجوزة ← بكسل كل حدث رفضه حارس السلامة لذلك الفرع تحديدًا. يحمل كل صفّ العنوان، ووقت البدء (بمنطقة زمنية مساحة العمل)، واسم العميل المرتبط عندما يكون موجودًا، ومعاينة الوصف.

تميّز القائمة نوعين من الصفوف:

• الأحداث المطابقة — Zellbox لا يزال يحتفظ بصف مرآة للحدث. تُعرض كبطاقة بيضاء.
• شواهد قبور — أبلغ Google عن status: cancelled لحدث ليس في مرآتنا (في الغالب: إلغاء حدث قبل اتصال Zellbox بهذا التقويم). تُعرض كبطاقة رمادية مع ملاحظة مائلة "شاهد قبر من Google (لا سجل في Zellbox)".

يعرض سطر الملخّص فوق القائمة ("41 مطابق · 313 شواهد · الإجمالي 354") التوزيع بحيث يتقلّص عدد إجمالي مخيف — في الغالب يتبيّن أن الجزء الأكبر من "354 إلغاء" هو شواهد قبور بلا تأثير حقيقي.

تُظهر الفروع المحجوزة قبل شحن هذه الميزة فقط الأعداد الإجمالية (بلا صفوف لكل حدث في سجل التدقيق). تعرض الحالة الفارغة زرّ استرداد التفاصيل من Google الذي يجلب الفوج من Google مع نفس نافذة البذر ويكتب صفوف التدقيق المفقودة بأثر رجعي. بعد تشغيله، تُملأ القائمة بشكل طبيعي.

ضد ماذا يحمي الحارس

يحمي حارس السلامة من أن يُسبّب تعثّر مزامنة واحد إلغاء الكثير من الأحداث بصمت. أنماط إخفاق ملموسة يلتقطها:

• يعيد Google صفحة تالفة تظهر فيها العديد من الأحداث الحقيقية بحالة status: cancelled.
• تبادل رمز أو تغيير صلاحية تقويم مشترك يجعل Zellbox يعتقد أن التقويم بأكمله فارغ.
• خطأ في تحليلنا يميّز أحداثًا سليمة على أنها ملغاة.

في أي من هذه الحالات يرفض الحارس الدفعة بأكملها ويطلب منك التأكيد قبل التطبيق.