Shoprimo - منصة التجارة الإلكترونية المتكاملة

Shoprimo - منصة التجارة الإلكترونية المتكاملة

المشكلة والهدف

تحتاج المتاجر الإلكترونية إلى واجهات تصفح سريعة مع معالجة دقيقة للعمليات المالية. يؤدي الاعتماد على بيانات السلة من جانب العميل دون تدقيق الخادم إلى أخطاء في الأسعار وتكرار تسجيل الطلبات عند إعادة إرسال الإشعارات.

تم تطوير Shoprimo كمنظومة تجارة إلكترونية متكاملة تجمع بين واجهة Next.js App Router وخادم Express مع Prisma ORM و MongoDB، وربط بوابة الدفع Stripe بنظام معالجة آمن.

المعمارية البرمجية والحلول التقنية

1. نمذجة البيانات عبر Prisma ORM

• المنتجات (Product): إدارة المخزون والتصنيفات والأسعار وروابط الصور.
• الطلبات (Order و OrderItem): حفظ بيانات العميل، وعنوان الشحن، وسعر المنتج وقت الشراء، وحالة الدفع.
• سجل إشعارات Stripe (StripeEvent): جدول مخصص بفهرس فريد (@@unique([eventId])) لمنع تكرار معالجة الإشعار المالي الواحد.

2. إدارة السلة عبر Redux Toolkit

• إدارة حالة السلة محليًا، وتحديث الكميات وحساب الإجمالي فورًا مع حفظ السلة في التخزين المحلي للمتصفح.

3. دورة الدفع عبر Stripe Payment Intent

• يطلب المتصفح إنشاء PaymentIntent من الخادم بعد إعادة حساب إجمالي السلة من قاعدة البيانات لمنع التلاعب بالأسعار من طرف العميل.
• استخدام Stripe Payment Element لإدخال بيانات البطاقات بأمان دون مرور أرقام البطاقات على خادم التطبيق.

4. التحقق من إشعارات Stripe ومنع التكرار (Idempotency)

• التحقق من التوقيع الرقمي للإشعار (constructEvent) للتأكد من مصدره.
• تسجيل معرف الإشعار (eventId) في قاعدة البيانات؛ وفي حال إعادة إرسال نفس الإشعار من Stripe يتم تجاوزه فورًا دون تكرار إنشاء الطلب أو خصم المخزون مرتين.

التحديات والقرارات الهندسية

• حماية الأسعار: إعادة حساب إجمالي الطلب بالكامل في الخادم من أسعار قاعدة البيانات قبل بدء عملية الدفع.
• إعادة إرسال الإشعارات: منع تكرار إنشاء الطلبات عند انقطاع اتصال الشبكة وإعادة إرسال Stripe لنفس الإشعار عبر جدول المعرفات الفريد.

المراجع والروابط

• التقنيات: NENext.js, STStripe, RERedux Toolkit, PRPrisma ORM, MOMongoDB