أين تتجمّع الأخطاء في مشاريع التكامل؟
في محورين: إنتاج الطلبات المعادة سجلّات مكرّرة وعدم التحقّق من الإشعارات الواردة. فعند انتهاء المهلة الشبكية يعيد العميل إرسال الطلب؛ وإذا عدّه الخادم عملية جديدة نشأ طلب ثانٍ أو فاتورة ثانية أو دفعة ثانية. ونفصّل الموضوعين في دليل مفتاح العملية وأمان استدعاءات الرجوع.
ماذا نفعل؟
- جرد التكامل: أيّ بيانات يُتحقّق منها في أيّ نظام، وأيّها يفوز عند التعارض
- تصميم مفتاح العملية (idempotency) والحماية من التكرار
- التحقّق من توقيع خطّاف الويب ونافذته الزمنية والحماية من إعادة التشغيل
- المعالجة القائمة على الطوابير وسياسة إعادة المحاولة وطابور السجلّات الخاطئة
- تقارير المطابقة وتحليل الفروق
- لوحة مراقبة: الطابور المنتظر، وتأخّر المعالجة، وعدد السجلّات الخاطئة
لا نقبل الإشعار مصدرًا للحقيقة
استدعاء خطّاف الويب الوارد ليس إلّا خبرًا بأنّ «شيئًا ما حدث». أمّا المبلغ والحالة والنتيجة فيُتحقّق منها بقراءتها من جديد من واجهة API لدى المُرسِل. ونقبل الاستدعاء بسرعة ونكتبه في الطابور، ثمّ نُجري منطق العمل انطلاقًا من الطابور؛ وبذلك لا تنشأ مهلة منتهية ولا إعادة إرسال لا لزوم لها لدى المُرسِل.
الأطراف التي نربطها كثيرًا
حركة الحسابات البنكية وأوامر الدفع (التكامل البنكي)، والفاتورة الإلكترونية والأرشيف الإلكتروني، ونقاط البيع الافتراضية، وشركات الشحن، وخدمات الأسواق الإلكترونية، وأنظمة المحاسبة وERP، وأجهزة تسجيل الحضور والانصراف، والتحقّق من الهوية المؤسسية.
«مرّة واحدة بالضبط» وهم
لا يمكن في الأنظمة الموزّعة ضمان وصول الرسالة مرّة واحدة بالضبط. والهدف الواقعي هو وصول الرسالة مرّة واحدة على الأقلّ وإبطال المستقبِل أثرَ التكرار؛ لذلك نبني في جانب المستهلك أيضًا فحصَ تكرار يعتمد معرّف الحدث.
الأسئلة الشائعة
أنستخدم خطّاف الويب أم الاستعلام الدوري؟
إذا كان الحجم منخفضًا وهناك تحمّل للتأخير، فالاستعلام الدوري أبسط وأكثر موثوقية. وفي الأحجام الكبيرة يشيع استخدام الأسلوبين معًا: خطّاف الويب للإشعار السريع، والاستعلام الدوري لتدارك الأحداث الفائتة.
ماذا نفعل إذا لم تكن لنظامنا الحالي واجهة API؟
تُدرس خيارات القراءة على مستوى قاعدة البيانات، أو النقل عبر الملفّات، أو تطوير خدمة وسيطة. ومهما كان الأسلوب المختار، تُبنى الحماية من التكرار وتقرير المطابقة بالطريقة نفسها.
كيف نعرف أنّ التكامل يعمل بسلامة؟
تُتابَع ثلاثة أرقام: طول الطابور المنتظر، ومتوسّط تأخّر المعالجة، وعدد السجلّات التي تسقط في طابور الأخطاء. وإن لم تظهر هذه الثلاثة على اللوحة، فإنّ عمل التكامل يبقى افتراضًا.