منصة المرحومي لكتالوج المنتجات وطلبات عروض الأسعار

نظرة عامة\n\nمنصة كتالوج وطلبات عروض أسعار مخصصة لمؤسسة المرحومي للأواني المنزلية وتجهيزات الفنادق والمطاعم. تفصل المنصة بين تجربة العميل العامة وعمليات الإدارة الداخلية، وتستبدل الشراء المباشر بمسار طلب تجاري قابل للمتابعة.\n\n## التحديات\n\n- تمثيل منتجات تحتوي على عدة موديلات، ولكل موديل صور ومواصفات وقواعد كمية وحالة توفر مستقلة.\n- دعم واجهة عربية وإنجليزية متجاوبة مع صفحات قابلة للفهرسة ومحركات البحث.\n- الحفاظ على بيانات الطلب كما كانت وقت الإرسال حتى بعد تعديل المنتج أو الموديل لاحقاً.\n- إدارة الصور الأصلية والنسخ المنشورة بأمان دون تعطيل الواجهة البرمجية أثناء المعالجة.\n- توفير دورة تشغيل إدارية تشمل التعيين والتواصل والإشعارات والتقارير والتدقيق.\n\n## الحل\n\nاعتمدت الواجهة العامة على React وVite مع عرض من الخادم للمسارات العامة، وبيانات SEO وStructured Data وخريطة موقع ديناميكية. يدير الباك إند الكتالوج وسلال عروض الأسعار والطلبات داخل PostgreSQL، مع التحقق من انتقالات الحالة والكميات ومفاتيح منع التكرار. تحفظ عناصر الطلب نسخاً من أسماء المنتجات والموديلات والمواصفات وقواعد الكمية لضمان سلامة السجل التجاري.\n\n## البنية التقنية\n\n- واجهة متجر React تدعم RTL وLTR والعربية والإنجليزية.\n- لوحة إدارة React مع صلاحيات حسب الدور ووضعين فاتح وداكن.\n- API مبني بـ NestJS وPostgreSQL مع توثيق OpenAPI.\n- تخزين متوافق مع S3 ومعالجة صور مستقلة باستخدام Sharp وPostgreSQL jobs.\n- نشر عبر Docker مع Nginx للوحة الإدارة وخادم Node.js للعرض من الخادم.\n- حماية عبر Helmet وCORS وقواعد تحديد المعدل والتحقق الصارم من المدخلات وسجل تدقيق.\n\n## الوحدات الأساسية\n\n- الأقسام والعلامات التجارية والمنتجات والموديلات والمواصفات.\n- مقارنة الموديلات والملفات الفنية والصور المرتبة.\n- سلة عرض السعر وإرسال الطلب والتتبع العام.\n- إدارة الطلبات وجهات الاتصال والملاحظات وسجل الحالات والتواصل.\n- مكتبة الوسائط ومعالجة WebP والعلامة المائية وإعادة المعالجة.\n- الإشعارات والتحليلات والتقارير والفريق والأدوار وسجل العمليات.\n- استيراد وتصدير الكتالوج باستخدام ملفات Excel.\n\n## النتائج\n\nأنتج المشروع قاعدة تقنية واضحة لنظام RFQ قابل للتشغيل والنشر، مع فصل مسؤوليات الواجهة العامة ولوحة الإدارة والخدمات الخلفية، وتغطية مسارات العمل الأساسية باختبارات للتحقق من العقود والأمان وسلامة البيانات