معمارية معالجة إشعارات تمارا (Tamara BNPL) وبناء آلة حالات دفع غير قابلة للسقوط

الخلاصة التنفيذية (BLUF): انهيار المتاجر والخوادم وقت الفلاش سيل ومواسم العروض بالسعودية والخليج سببه الاعتماد على المعالجة اللحظية المباشرة (Synchronous). الحل الجذري هو فصل الاستقبال عبر طابور انتظار سريع مع أقفال موزعة باستخدام Tamara API, State Machines, Node.js لمنع تكرار الطلبات وضمان استقرار المتجر بنسبة 99.99%.

أعراض المشكلة في بيئة الإنتاج وقت الحملات الكبرى

أثناء مواسم الذروة مثل عروض اليوم الوطني، يوم التأسيس، والجمعة البيضاء، تواجه المتاجر الإلكترونية والأنظمة الوسيطة في الرياض وجدة ودبي اختناقات شديدة تظهر في السيرفر على شكل:

• أخطاء تعليق الطلبات HTTP 504 Gateway Timeout بسبب انتظار استجابة البوابات الخارجية لحظياً.
• تكرار خصم الرصيد أو تكرار حجز المخزون عند وصول طلبات مكررة متزامنة دون وجود قفل برمجي يضمن الـ Idempotency.
• استنزاف اتصالات قاعدة البيانات (Connection Starvation) وانهيار PgBouncer وخوادم PostgreSQL تحت الضغط المتزامن.

السبب الجذري للخلل التقني

الخطأ المعماري الأكثر شيوعاً هو معالجة أحداث الويب هوك أو الفواتير لحظياً داخل نفس الطلب القادم من العميل أو بوابة الدفع. عندما يرتفع الضغط فجأة إلى آلاف الطلبات في الدقيقة، تظل خيوط المعالجة معلقة تنتظر الـ I/O الخارجي، مما يؤدي إلى تراكم استهلاك الرام وتدخل الـ OOM Killer لإيقاف خادم التطبيق فوراً.

المعمارية الهندسية والكود التنفيذي لحل المشكلة

لضمان سرعة استجابة لا تتعدى 100 مللي ثانية وضمان عدم ضياع أي طلب نهائياً، نقوم بفصل الاستقبال عن المعالجة باستخدام طابور انتظار سريع وقفل موزع على مستوى الذاكرة:

export enum TamaraState {
  INITIAL = 'INITIAL',
  AUTHORISED = 'AUTHORISED',
  CAPTURED = 'CAPTURED',
  EXPIRED = 'EXPIRED',
  CANCELLED = 'CANCELLED'
}

المؤشرات التقنية التي يجب مراقبتها في بروميثيوس وجرافانا

للتأكد من استقرار الخوادم تحت الضغط المليوني، راقب المقاييس التالية بدقة:

• p99_latency_seconds < 0.15: زمن معالجة واستقبال الطلب أقل من 150ms في كل الأحوال.
• worker_queue_lag_total == 0: تفريغ طابور العمليات الخلفية بسلاسة دون تراكم.
• idempotency_cache_hit_rate > 0.08: اعتراض الطلبات المكررة بنجاح وحماية قاعدة البيانات.

توصيات ختامية لأصحاب المتاجر ومدراء التقنية

لا تدع متجرك يعالج فواتير زاتكا أو خصم المخزون أو إشعارات واتساب لحظياً على نفس السيرفر. اجعل استقبال الطلب سريعاً ومجرداً في طابور مهام مؤمن، واحمِ قاعدة بياناتك دائماً خلف مجمع اتصالات (Connection Pooler) موثوق.