منصة عمليات للتجزئة

المشكلة

بُنيت هذه المنصة وتُشغَّل لصالح English Home Libya، وهو نشاط تجزئة يخدم عملاء في ليبيا. تصل أسئلة المنتجات باللهجة الليبية عبر Messenger وInstagram Direct، وغالبًا في صورة مرفقة بسؤال «بكم هذا؟». وتعني الإجابة الآمنة تحديد منتج واحد من أكثر من 4,700 منتج في الكتالوج (حتى يوليو 2026)، ونشر المحتوى من دون إرسال مكرر، وعدم اختراع سعر أو حالة تشغيل أبدًا. وقد جاءت المتطلبات من خبرتي المباشرة في إدارة الأنظمة الرقمية للعلامة.

النظام

يراسل العملاء أيًا من القناتين؛ فتحفظ المنصة webhook الموقّع، وتجمّع دفعات الرسائل، وتتعرف على المنتج بالكود أو بالنص بثلاث لغات أو من صورة، ثم تجيب بأسعار تُقرأ من الكتالوج الحي فقط، وتسلّم المحادثة لإنسان عند تحول الطلب إلى شراء أو استرجاع أو شكوى. وتغطي لوحة العمليات ثنائية اللغة، المصممة أولًا للعربية (RTL)، الوارد والتحليلات ومراجعة الصور وضوابط التشغيل واستوديو محتوى يُعِد وينشر منشورات وقصص فيسبوك وإنستغرام.

لا يرد webhook بالنجاح إلا بعد حفظ الحدث. ويتولى عامل منفصل مهامًا دائمة مدعومة بـ PostgreSQL وصندوق إرسال معاملاتي، بحيث يمكن استئناف الردود والمنشورات من دون تكرار صامت. وتبقي جلسات المدراء المتعددة وفحوص الجاهزية وسجل التدقيق حالة التشغيل واضحة.

يغذي هذا الخطّ نظامان فرعيان منشوران كمستودعين مستقلين: أداة جمع كتالوج قابلة للاستئناف جمعت كتالوج صور تجاوز 11 غيغابايت خلال عملية البناء الموثقة، ومحرك مطابقة حتمي ثلاثي اللغات يقرر أي منتج تركي مجموع هو نفسه المنتج المسعّر في الكتالوج العربي/الإنجليزي — المطابقات عالية الثقة فقط تُعتمد تلقائيًا، وكل ما عداها يذهب لمراجعة بشرية. والتعرف من الصور يتبع قاعدة «لا تخمّن أبدًا»: القائمة الفارغة تعيد «لا شيء» لا أقرب منتج سيئ، والتصحيحات البشرية المؤكدة تعلّم المحرك.

قرارات وُلدت من أعطال حقيقية

كل من هذه الضوابط موجود لأن شيئًا ما حدث فعلًا ذات مرة:

• تجميع الدفعات — العملاء يرسلون خمس رسائل قصيرة لا رسالة واحدة؛ نافذة خمس ثوانٍ تمنع خمسة ردود منفصلة.
• حارس التجاوز — استجابة النموذج البطيئة لا يمكنها الكتابة فوق حالة محادثة أحدث.
• إعادة الفحص عند الإرسال — إذا تولى إنسان المحادثة أثناء التوليد، يُسقَط رد الذكاء الاصطناعي ولا يُرسل.
• منقّي المخرجات — صيغ الأدوات البرمجية لا تتسرب أبدًا إلى رسالة عميل.
• تسليم صادق — لا تُعلَّم رسالة كمُسلَّمة إلا بعد تأكيد الواجهة البرمجية.

من الاستضافة المجانية إلى بنية مملوكة

اعتمدت المنصة في البداية على قاعدة بيانات مستضافة مجانية — إلى أن أوقف المزوّد المشروع وأسقط النظام معه. فنقلت كل شيء إلى خادم VPS واحد مُدار ذاتيًا: Postgres 16 والتطبيق والعامل و Caddy عبر Docker Compose، مع نسخ احتياطي ليلي ودليل نشر مكتوب. ويحفظ المستودع هذا العمل كسلسلة ترحيلات مرتبة باتجاه واحد، مع إجراءات مكتوبة للنسخ الاحتياطي والاستعادة.

التحقق والحدود

تغطي اختبارات الوحدة والتكامل والمتصفح سلسلة الترحيلات، وطابور المهام، ومتانة webhook، ومنع التكرار، وحالات التسليم، وقواعد الكتالوج، والمصادقة، وجاهزية القنوات. وما لا أدّعيه: أرقام التشغيل أو الزيارات أو التحويل أو الوصول — فالمستودع لا يحتوي قياسات إنتاجية موثوقة، وهذه الصفحة لا تخترعها.