درس من الإنتاج: إزاي خليّنا مزامنة الكاشير أثناء انقطاع النت مايبوظش أي فاتورة

محلات كتير بتشتغل في مناطق فيها انقطاع نت متكرر، والسؤال اللي بيقلق أي صاحب محل: لو النت قطع وأنا بابيع، هل الفاتورة هتضيع ولا هتتسجل مرتين؟ الدرس ده بيحكي إزاي فريق تكة لاقى فرق في السلوك بين مسارين للمزامنة وصلّحه.

المشكلة: مسار الدفعة المجمّعة كان بيتصرف غير مسار البيعة المباشرة

كاشير تكة بيدعم مسارين لتسجيل البيعات: مسار مباشر (البيعة بتتبعت للسيرفر فورًا)، ومسار دفعات مجمّعة (batch job) بيشتغل في الخلفية لما النت يرجع بعد انقطاع، فكل الفواتير اللي اتسجلت أوفلاين بتتبعت دفعة واحدة. فريق تكة اكتشف إن المسار المباشر كان اتصلّح قبل كده ليتعامل بأمان مع "محاولة تسجيل نفس الفاتورة مرتين"، لكن مسار الدفعة المجمّعة ماكانش راجع نفس الإصلاح.

ليه ده كان خطر

النتيجة: لو السيرفر رد بخطأ "نفس الفاتورة مسجلة قبل كده" (وده طبيعي يحصل لو نفس الفاتورة اتبعتت مرتين بسبب إعادة محاولة)، مسار الدفعة المجمّعة كان بيصنّف ده "فشل" بدل "مكرر بالفعل"، فالكاشير كان ممكن يحاول يعيد إرسالها تاني من غير داعي. وكان فيه كمان خطأ برمجي في نوع بيانات المستخدم كان ممكن يوقف تنفيذ الوظيفة بالكامل لأي محل حقيقي.

الحل: نفس صرامة المسار المباشر على الدفعات المجمّعة

فريق تكة عدّل مسار الدفعة المجمّعة ليصنّف حالة "الفاتورة مسجلة بالفعل" صح بدل ما يعتبرها فشل، وصلّح خطأ نوع البيانات، وخلى أي مشكلة مؤقتة في قفل الطلب تفشل الطلب ده بس من غير ما توقف باقي الدفعة. النتيجة: فاتورة اتسجلت أوفلاين بتتزامن مرة واحدة بالظبط لما النت يرجع، من غير تكرار ولا فشل كاذب.

الأرقام بصراحة

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

لو محلك شغال في منطقة فيها انقطاع نت متكرر

كاشير تكة مصمم يكمل تسجيل البيعات محليًا حتى لو النت قاطع، ويزامن تلقائيًا لما النت يرجع. سجّل من store.ttakka.store وجرّب بنفسك.