مختبر البرمجة وقواعد البيانات (13 نونبر 2026): كيف تصمم نظام طوابير بـ SQL ومفاتيح عدم التكرار (Idempotency Keys) يمنع ضياع المعاملات أثناء أعطاب السحابة؟

1. ما هو الخطأ الشائع في المشاريع المبتدئة؟

يقوم المبتدئ بحفظ الطلب في قاعدة بيانات MySQL ثم يحاول في نفس السطر إرسال بريد تأكيد خارجي أو إشعار سحابي؛ فإذا تأخر السيرفر الخارجي لـ 30 ثانية، تنقطع الجلسة (HTTP 504 Timeout) ويضغط المستخدم على زر الإرسال مرة ثانية، مما يؤدي إلى تكرار العملية أو ضياعها!

2. الحل الهندسي النظيف في MySQL 8 و PHP: جدول Outbox Queue ومفتاح Idempotency

يتم حفظ العملية الأساسية ورسالة المزامنة داخل نفس المعاملة الذرية (SQL Transaction) في أقل من 5 أجزاء من الألف من الثانية، بينما يتكفل عامل خلفي (Background Worker) بإعادة المحاولة التدريجية (Exponential Backoff) دون أن يشعر المستخدم بأي بطء:

-- بنية جدول طابور المهام الموثوق (Transactional Outbox) مع منع التكرار:
CREATE TABLE api_outbox_queue (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    idempotency_key VARCHAR(64) NOT NULL UNIQUE,
    event_type VARCHAR(50) NOT NULL,
    payload_json JSON NOT NULL,
    status ENUM('PENDING', 'PROCESSING', 'SENT', 'DEAD_LETTER') DEFAULT 'PENDING',
    attempts TINYINT UNSIGNED NOT NULL DEFAULT 0,
    next_retry_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    INDEX idx_status_retry (status, next_retry_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3. ثلاث فوائد مباشرة في تطبيقات المقاولات والمنصات الرقمية بالمغرب:

• صفر تكرار للعمليات الحساسة: بفضل القيد الفريد UNIQUE (idempotency_key)، حتى لو أعاد المتصفح إرسال الطلب عند ضعف الصبيب، لن تُسجل العملية مرتين أبداً.
• استجابة فورية للواجهة (Sub-50ms UX): يحصل المستخدم على تأكيد فوري، وتُعالج المراسلات الخارجية في الخلفية بأمان.
• قابلية التتبع والتدقيق الكامل: أي مهمة تفشل بعد 5 محاولات تنتقل تلقائياً إلى حالة DEAD_LETTER ليراجعها المطور بضغطة زر دون فقدان أي سطر من البيانات.