نظام E-commerce API
دي نظرة سريعة على اللي بيقدمه الـ API:
نظام إدارة المستخدمين والمصادقة (Authentication & User Management)
•تسجيل حساب جديد: نظام تسجيل متكامل مع تأكيد البريد الإلكتروني (Email Verification) لضمان صحة الإيميلات.
•تسجيل الدخول: باستخدام نظام JWT (Tokens) الآمن، مع إمكانية تجديد الـ Token.
•تسجيل الدخول عبر جوجل (Google Login): دعم كامل لتسجيل الدخول بحسابات جوجل بضغطة زر.
•إدارة الملف الشخصي (Profile): لكل مستخدم بروفايل خاص به يحتوي على معلوماته الأساسية، وعناوينه، وتاريخ مشترياته.
•استعادة كلمة المرور: نظام كامل لإعادة تعيين كلمة المرور عبر البريد الإلكتروني.
•إدارة العناوين: يمكن للمستخدم إضافة حتى 3 عناوين شحن مختلفة.
إدارة المنتجات والمخزون (Product & Inventory Management)
•إضافة وتعديل المنتجات: نظام كامل لإدارة المنتجات (CRUD Operations) مع صلاحيات خاصة للبائعين فقط.
•نظام المخزون الآلي: يتم تحديث كمية المنتج تلقائيًا عند كل عملية بيع، ويصبح المنتج غير متاح (Out of stock) عند نفاد الكمية.
•التصنيفات (Categories): يمكن إضافة وتصنيف المنتجات تحت أقسام مختلفة.
•الخصومات والعروض: يمكن للبائع تفعيل خصومات على المنتجات وتحديد نسبة الخصم، ويقوم النظام بحساب السعر بعد الخصم تلقائيًا.
•نظام تقييم ومراجعات (Reviews): يمكن للمستخدمين إضافة تقييم (من 1 إلى 5 نجوم) وكتابة مراجعة عن كل منتج.
•مواصفات إضافية (Extra Features): إمكانية إضافة مواصفات مخصصة لكل منتج (مثل: اللون، الحجم، الخامة).
•فلترة وبحث متقدم: يمكن فلترة المنتجات حسب (السعر، التصنيف، مدى التوفر، وجود خصم).
•منتجات ذات صلة ومقترحة: عرض المنتجات من نفس التصنيف (Related Products)، اقتراح منتجات للمستخدم بناءً على مشترياته السابقة، عرض المنتجات الأكثر مبيعًا.
عربة التسوق ونظام الطلبات (Cart & Ordering System)
•عربة تسوق (Shopping Cart): لكل مستخدم عربة تسوق خاصة به لإضافة المنتجات وتعديل كمياتها أو حذفها.
•إنشاء الطلبات (Orders): عملية سهلة لإنشاء طلب جديد من المنتجات الموجودة في العربة.
•تتبع حالة الطلب: نظام متكامل لتتبع حالة الطلب (قيد التوصيل، جاري التوصيل، تم التوصيل، فشل التوصيل، تم الاسترجاع).
•تتبع حالة الدفع: نظام لتتبع حالة الدفع (قيد الانتظار، تم الدفع، فشل، تم استرداد المبلغ).
•سجل الطلبات: يمكن للمستخدم مراجعة جميع طلباته السابقة وتفاصيلها.
نظام البائعين (Multi-vendor) ومندوبي التوصيل
•نظام متعدد البائعين (Multi-Vendor): الـ API مصمم ليكون سوقًا إلكترونيًا يضم أكثر من بائع.
•طلبات الانضمام كبائع: يمكن للمستخدمين تقديم طلب ليصبحوا بائعين، مع رفع مستندات للتحقق من هويتهم.
•طلبات الانضمام كمندوب توصيل: نظام مشابه لتقديم طلبات الانضمام كمندوب توصيل مع رفع المستندات المطلوبة.
•لوحة تحكم للموافقة والرفض: يمكن للأدمن مراجعة هذه الطلبات والموافقة عليها أو رفضها مع ذكر السبب.
التسويق والعروض الترويجية (Marketing & Promotions)
•نظام كوبونات (Coupons): إنشاء كوبونات خصم بنسبة مئوية، تحديد فترة صلاحية لكل كوبون، تحديد حد أقصى لعدد مرات استخدام الكوبون، يمكن أن يكون الكوبون عامًا أو خاصًا بمنتجات بائع معين.
•المناسبات (Occasions): نظام لإنشاء مناسبات أو مواسم تخفيضات (مثل تخفيضات الجمعة البيضاء) لها فترة صلاحية محددة.
لوحات التحكم (Dashboards) وإدارة النظام
•لوحة تحكم الأدمن (Admin Dashboard): عرض إحصائيات شاملة (إجمالي المستخدمين، البائعين، المنتجات، الطلبات، والأرباح)، عرض آخر الطلبات وأكثر المنتجات مبيعًا.
•لوحة تحكم البائع (Seller Dashboard): إحصائيات خاصة بالبائع (إجمالي منتجاته، أرباحه، طلباته)، عرض آخر الطلبات الخاصة بمنتجاته ومنتجاته الأكثر مبيعًا.
•لوحة تحكم مندوب التوصيل (Delivery Dashboard): عرض الطلبات المتاحة للتوصيل، إمكانية استلام الطلب لتوصيله، عرض الطلبات الحالية التي يقوم بتوصيلها.
•إدارة كاملة للمستخدمين: يمكن للأدمن عرض جميع المستخدمين والبحث فيهم والاطلاع على تفاصيلهم.
مميزات تقنية إضافية
•نظام إشعارات بالبريد الإلكتروني: إرسال إيميلات تلقائية عند تأكيد الحساب، استعادة كلمة المرور، تأكيد الطلب، تحديث حالة الطلب، والموافقة/الرفض على طلبات الانضمام.
•صلاحيات دقيقة (Permissions): استخدام نظام صلاحيات محكم يضمن أن كل مستخدم (عميل، بائع، مندوب، أدمن) لا يمكنه الوصول إلا للبيانات والوظائف المخصصة له.
•تقسيم الصفحات (Pagination): جميع القوائم تدعم الـ Pagination لعرض البيانات بكفاءة.