كتالوج متعدد اللغات
المنتجات والفئات والبراندات تدعم العربية والإنجليزية مع حالات التفعيل والتمييز والخصم وملخص التقييمات.
API v1
Laravel Sanctum
لوحة التحكم
API واحد يدير متجرك من أول منتج لحد آخر طلب
هذا الـ API مخصص لإدارة متجر إلكتروني متكامل، بداية من المصادقة والمستخدمين، مرورًا بالمنتجات والفئات والبراندات، وحتى السلة والعناوين والكوبونات والطلبات، مع صلاحيات واضحة للإدارة والبائعين.
مسار جاهز للشراء
تجربة الـ checkout الحالية تشمل السلة والعناوين والمحافظات والكوبونات وبيانات الطلب بتفاصيل أوضح.
صلاحيات أوضح
الهيكل الحالي يفصل بشكل واضح بين المستخدم والبائع و Super Admin مع حماية الحظر.
تحليلات وإدارة
لوحة الإدارة ومسارات التحليلات تعكس الآن أحدث منطق لإدارة المتجر والعمليات.
أحدث شكل
ما الذي تم عكسه داخل الصفحة
بدل الصفحة القديمة المحدودة، أصبح المحتوى الحالي مبنيًا على البنية الفعلية للمشروع والواجهات المضافة حديثًا.
دعم كامل للبراندات
الكتالوج الحالي أصبح يشمل إدارة البراندات بالكامل داخل الـ API ولوحة التحكم.
المحافظات والعناوين
الطلبات تدعم الآن المحافظات والعناوين، وهذا يجعل تجربة الشراء أقرب لسلوك الإنتاج الفعلي.
منظومة الكوبونات
أصبحت الصفحة تعكس وجود التحقق من الكوبونات وإدارتها ضمن تدفق الشراء.
واجهات البائع
تم تمثيل مسارات البائع بشكل مستقل بدون خلطها مع إجراءات المشرف الأعلى.
التقييمات والمراجعة
تمت إضافة تقييمات الشراء المؤكد مع دورة اعتماد ورفض قبل إظهارها بشكل عام داخل الكتالوج.
تسعير الخصومات
استجابات المنتجات أصبحت تعرض السعر الأساسي وقيمة الخصم والسعر النهائي ومنطق صلاحية الخصم الزمني.
حماية أقوى للمستخدمين
أصبحت الصفحة تعكس middleware الحظر والصلاحيات بشكل أدق داخل المنظومة الحالية.
التحليلات الإدارية
تم إدراج مسارات الملخصات والتحليلات الخاصة بالمستخدمين والمنتجات والطلبات والفئات.
أبرز الإضافات
التقييمات والخصومات أصبحت جزءًا من استجابة المنتج
الإضافات الأخيرة داخل الـ backend تسمح للعميل بإرسال تقييم موثّق بعد الشراء، وتسمح للمنتج بعرض التسعير بعد الخصم بدون كسر المسارات الحالية.
تقييمات موثقة
يمكن للعميل إنشاء تقييم واحد لكل منتج بعد طلب مكتمل، مع إمكانية ربط Variant واختيار تعليق اختياري، ثم انتظار اعتماد الإدارة قبل الظهور العام.
POST /api/v1/products/{id}/reviews
PUT /api/v1/products/{id}/reviews
DELETE /api/v1/products/{id}/reviews
GET /api/v1/products/{id}/reviews
تسعير آمن للخصومات
المنتج يحسب has_discount و discount_amount و final_price داخل فترة الخصم الصحيحة مع منع نزول السعر إلى قيمة سالبة.
discount_type: percentage | fixed discount_value: رقم discount_start_at: datetime اختياري discount_end_at: datetime اختياري
مثال من استجابة المنتج
{
"price": 500,
"final_price": 450,
"has_discount": true,
"average_rating": 4.5,
"reviews_count": 12
}
منطق لوحة التحكم
منطق الواجهة الحالية في لوحة التحكم
الصفحة الرئيسية أصبحت أقرب لروح لوحة التحكم الموجودة فعليًا داخل المشروع، ولم تعد تبدو منفصلة عنها.
لوحة المالك
إحصائيات سريعة وطلبات حديثة ومستخدمون ومنتجات وفئات داخل شاشة موحدة.
إدارة المنتجات
المنتجات أصبحت تشمل البراند والصورة الرئيسية وحالة التمييز وحالة التفعيل.
إدارة الفئات
الفئات العربية والإنجليزية أصبحت تظهر بوضوح مع الوصف وحالة النشر الحالية.
إدارة الطلبات
اللوحة الحالية تتيح متابعة أسهل للطلبات وتغيير الحالة وقراءة التفاصيل بشكل أفضل.
مجموعات الـ API
مجموعات الـ API الحالية
هذه البطاقات مبنية على المسارات الحقيقية داخل routes/api.php وليس على التوثيق القديم، لذلك فهي تعكس البنية الأحدث للمشروع.
المصادقة والمستخدم
مسارات التسجيل وتسجيل الدخول وتحديث الملف الشخصي وتسجيل الخروج وحذف الحساب.
عام
Sanctum
not_banned
-
POST
/api/v1/register
إنشاء حساب جديد
-
POST
/api/v1/login
تسجيل الدخول مع تقييد المعدل
-
POST
/api/v1/logout
إنهاء الجلسة الحالية
-
POST
/api/v1/update
تحديث ملف المستخدم الحالي
-
DELETE
/api/v1/deleteUser
حذف الحساب الحالي
-
GET
/api/v1/users
عرض المستخدمين للمشرف الأعلى فقط
الكتالوج العام
عرض المنتجات والفئات والبراندات والمحافظات ضمن طبقة الكتالوج الحالية.
مستخدم مسجل
Super Admin للكتابة
-
GET
/api/v1/products
عرض المنتجات العامة
-
GET
/api/v1/products/{id}/reviews
عرض التقييمات المعتمدة الخاصة بالمنتج
-
POST
/api/v1/products/{id}/reviews
إرسال تقييم مرتبط بشراء مؤكد
-
GET
/api/v1/categories
عرض الفئات الحالية
-
GET
/api/v1/brands
عرض البراندات المتاحة
-
GET
/api/v1/governorates
عرض المحافظات ومناطق الشحن
-
POST
/api/v1/products
إنشاء منتج رئيسي مع حقول خصم اختيارية
-
PUT
/api/v1/products/{id}
تعديل منتج رئيسي وقواعد التسعير الخاصة به
السلة والشراء
السلة والعناوين والكوبونات والطلبات أصبحت ممثلة كمسار شراء أوضح داخل الصفحة.
Sanctum
not_banned
-
GET
/api/v1/cart
جلب عناصر السلة الحالية
-
POST
/api/v1/cart
إضافة منتج أو variant إلى السلة
-
PUT
/api/v1/cart/{id}
تعديل الكمية أو حالة العنصر
-
GET
/api/v1/addresses
إدارة عناوين الشحن
-
POST
/api/v1/coupons/validate
التحقق من كود الكوبون
-
POST
/api/v1/orders
إنشاء طلب جديد
منطقة البائع
مسارات مخصصة للبائع لإدارة المنتجات والطلبات بدون تعارض مع إدارة المشرف الأعلى.
seller middleware
-
GET
/api/v1/seller/products
عرض منتجات البائع
-
POST
/api/v1/seller/products
إنشاء منتج جديد للبائع
-
PUT
/api/v1/seller/products/{id}
تحديث منتج البائع
-
DELETE
/api/v1/seller/products/{id}
حذف منتج البائع
-
GET
/api/v1/seller/orders
متابعة طلبات البائع
الإدارة والتحليلات
تشمل صلاحيات المشرف الأعلى التحليلات وإسناد الأدوار وإدارة المنتجات المعلقة والتحكم المتقدم في الطلبات.
super_admin
-
GET
/api/v1/admin/analytics/summary
تحميل ملخص النظام
-
GET
/api/v1/admin/products/pending
عرض المنتجات المعلقة
-
PUT
/api/v1/admin/products/{id}/activate
تفعيل منتج معلق
-
PATCH
/api/v1/admin/products/{productId}/reviews/{reviewId}/status
اعتماد أو رفض تقييم منتج
-
POST
/api/v1/roles/assign
إسناد دور لمستخدم
-
GET
/api/v1/orders/Admin/GetAll
عرض جميع الطلبات للمراجعة الإدارية
-
POST
/api/v1/users/{id}/ban
حظر مستخدم من الوصول للمسارات المحمية
لا توجد نتائج مطابقة لعبارة البحث الحالية.
بداية سريعة
بداية سريعة
مقتطفات قصيرة تساعد على بدء اختبار الـ API بسرعة مع بقاء الصفحة منظمة وسهلة القراءة.
1. اضبط الـ Base URL
BASE_URL=http://127.0.0.1:8000 API_PREFIX=/api/v1
2. سجّل الدخول وخذ التوكن
POST /api/v1/login
{
"email": "owner@example.com",
"password": "secret"
}
3. استخدم التوكن في الطلبات المحمية
Authorization: Bearer {token}
Accept: application/json
الموارد
روابط سريعة وملفات جاهزة
روابط مباشرة للملفات المتاحة حاليًا داخل المشروع ونقطة الدخول إلى لوحة التحكم.