تصميم باك ايند لموقع متجر ايرا شوب الالكتروني

تُظهر الصور واجهة مستخدم احترافية لتوثيق API تم بناؤها باستخدام أداة Swagger (OpenAPI). تهدف هذه الواجهة إلى تمكين المطورين من فهم واختبار نقاط النهاية (Endpoints) الخاصة بمتجر إلكتروني متكامل يُدعى EraShop.

المكونات والوظائف الرئيسية:

نظام المصادقة والحسابات (Auth & Account): يوفر الموقع مجموعة واسعة من العمليات تشمل تسجيل الدخول، إنشاء حساب جديد، تأكيد البريد الإلكتروني، وإعادة تعيين كلمة المرور. كما يسمح للمستخدمين المسجلين بتعديل بياناتهم الشخصية وتغيير كلمات المرور.

إدارة المتجر (Products, Brands & Categories): تتيح الواجهة للمطورين التحكم في المنتجات، العلامات التجارية، والتصنيفات من خلال عمليات الإضافة (POST)، العرض (GET)، والتعديل (PUT).

نظام الطلبات والمدفوعات (Order & Payment): يدعم الـ API معالجة الطلبات، تتبع طرق التوصيل، وإتمام عمليات الدفع عبر "BasketId" أو من خلال "Webhooks".

التفاعل مع المنتجات (Reviews & WishList): يمكن للمستخدمين إضافة تقييمات للمنتجات أو إضافتها إلى قائمة الأمنيات الخاصة بهم، مع إمكانية إدارة هذه القوائم بالكامل.

سلة التسوق والفواتير (Basket & Bill): توفر نقاط نهاية لإدارة عناصر سلة التسوق (إضافة، حذف، عرض) وعرض الفواتير المصدرة.

إدارة الأدوار (Roles): يضم النظام قسماً خاصاً للتحكم في أدوار المستخدمين وصلاحياتهم داخل المنصة.

التصميم والتجربة التقنية:

تنظيم منطقي: يتم تجميع العمليات تحت تصنيفات واضحة (مثل Product, Auth, Order) لسهولة التصفح.

أكواد الألوان: تستخدم الواجهة ألواناً معيارية لتمييز نوع الطلب؛ الأخضر لعمليات الإرسال (POST)، الأزرق لعمليات الجلب (GET)، البرتقالي للتحديث (PUT)، والأحمر للحذف (DELETE).

التفاعلية: تتيح الواجهة زر "Authorize" لتجربة طلبات حقيقية مباشرة من المتصفح بعد إدخال بيانات الاعتماد اللازمة.