مؤشر المزامنة

موقع المؤشر

يقع مؤشر المزامنة في الجزء الأيمن من الشريط العلوي (topbar) للتطبيق. وهو مرئي دائماً ويعرض الحالة الحالية للاتصال ومزامنة البيانات.

حالات المؤشر

متصل (أخضر)

الجهاز متصل بالإنترنت، جميع البيانات متزامنة مع الخادم. هذه هي الحالة الطبيعية.

يظهر المؤشر كنقطة خضراء أو أيقونة اتصال.

ما يعنيه ذلك:

• تم إنشاء الاتصال بالخادم
• لا توجد تغييرات معلقة
• جميع البيانات محدّثة

غير متصل (كهرماني)

الجهاز غير متصل بالإنترنت. التطبيق يعمل بالبيانات المحلية.

يظهر المؤشر كنقطة كهرمانية (برتقالية) أو أيقونة عدم اتصال.

ما يعنيه ذلك:

• لا يوجد اتصال بالخادم
• التطبيق يعمل بالبيانات المخزنة مؤقتاً
• جميع التغييرات الجديدة تُحفظ محلياً
• ستبدأ المزامنة تلقائياً عند استعادة الاتصال

قيد المزامنة (متحرك)

عملية المزامنة جارية -- يتم إرسال التغييرات المحلية إلى الخادم.

يظهر المؤشر كأيقونة مزامنة متحركة (نابضة).

ما يعنيه ذلك:

• تم استعادة الاتصال أو تم تشغيل المزامنة يدوياً
• يتم إرسال التغييرات المعلقة إلى الخادم بالترتيب الزمني
• تستغرق العملية عادةً بضع ثوانٍ

عدّاد التغييرات المعلقة

بجانب المؤشر يظهر رقم -- عدد التغييرات التي تنتظر المزامنة. كل إجراء يُنفذ دون اتصال يزيد العدّاد بواحد:

• تسجيل حضور -- +1
• تسجيل دفع يدوي -- +1
• تغيير حالة التسجيل -- +1

أمثلة على العرض:

• نقطة خضراء بدون رقم -- كل شيء متزامن
• نقطة كهرمانية + 3 -- غير متصل، 3 تغييرات تنتظر الإرسال
• حركة + 3 -> 2 -> 1 -> 0 -- المزامنة جارية، يتم إرسال التغييرات

عندما يصل العدّاد إلى الصفر، ينتقل المؤشر إلى الحالة الخضراء.

ما هو pendingSync

كل تغيير يُجرى دون اتصال يحصل على علامة pendingSync=true في قاعدة البيانات المحلية. تعني هذه العلامة:

• تم حفظ التغيير محلياً
• لم يُرسل التغيير إلى الخادم بعد
• سيتم نقله في المزامنة التالية

بعد الإرسال الناجح إلى الخادم تُزال العلامة (pendingSync=false)، ويُعتبر السجل متزامناً.

المزامنة اليدوية

بالإضافة إلى المزامنة التلقائية عند استعادة الاتصال، يمكنك تشغيل المزامنة يدوياً:

1. اضغط على مؤشر المزامنة في الشريط العلوي.
2. ستُفتح لوحة التفاصيل بالمعلومات التالية:
   • حالة الاتصال الحالية
   • عدد التغييرات المعلقة
   • وقت آخر مزامنة ناجحة
3. اضغط على زر مزامنة.

التشغيل اليدوي مفيد عندما:

• تريد التأكد من إرسال جميع البيانات قبل إغلاق التطبيق
• لم تبدأ المزامنة التلقائية بعد استعادة الاتصال
• تريد التحقق من أن المزامنة تعمل بشكل صحيح

إذا كان الجهاز غير متصل، سيكون زر «مزامنة» غير نشط.

إشعارات المزامنة

يعرض التطبيق إشعارات toast عند الأحداث الرئيسية للمزامنة:

التوصيات

• لا تغلق التطبيق فوراً بعد العمل دون اتصال. انتظر حتى يصبح عدّاد التغييرات المعلقة صفراً.
• راقب المؤشر قبل بدء الفعالية. تأكد من أن البيانات محدّثة (الحالة الخضراء).
• عند العمل الطويل دون اتصال تحقق من العدّاد بشكل دوري. عدد كبير من التغييرات المعلقة (50+) قد يبطئ المزامنة عند استعادة الاتصال.