# JOKMODEL — Enterprise Multi-Vendor E-Commerce Marketplace

**JOKMODEL** هو نظام متكامل ومتقدم للتجارة الإلكترونية والأسواق الرقمية متعددة البائعين مبني على أحدث تقنيات **Laravel 12** و **Livewire Flux UI**. يوفر النظام تجربة تسوق تفاعلية وسريعة وفائقة السلاسة دون الحاجة لإعادة تحميل الصفحات، مع بنية تحتية مرنة تدعم نمو الأعمال وتعدد المتاجر والعملات واللغات. **JOKMODEL** is a modern, enterprise-grade multi-vendor e-commerce platform crafted with **Laravel 12** and **Livewire Flux UI**. It delivers an instantaneous, reactive shopping experience for customers alongside robust vendor management workflows, commission calculations, payouts tracking, and administrative governance. ## المميزات والخصائص الرئيسية / Key Features ### 1. واجهة المتجر وتجربة العميل (Customer Storefront) - **كتالوج منتجات تفاعلي ديناميكي**: تصفح المنتجات بتصميم عصري وجذاب مع فلاتر حسب الفئة والأسعار وحالة الخصومات والأكثر مبيعاً (`best_seller`, `trending`). - **بحث فوري وسريع**: بحث في الوقت الفعلي مع اقتراحات مباشرة ونتائج سريعة. - **صفحة تفاصيل المنتج (Product Detail Page)**: معرض صور تفاعلي متقدم يدعم الصور المتعددة، عرض السعر الأساسي ومقارنة الخصومات (`compare_at_price`)، رمز المنتج (`SKU`)، وتفاصيل التوفر في المخزن. - **التفاعل الاجتماعي والتقييمات**: - نظام الإعجاب بالمنتجات (`Product Likes`) - المفضلة وقائمة الرغبات (`Wishlist / Favorites`) - احتساب وتتبع عدد المشاهدات (`Product Views`) - المراجعات والتعليقات بالنجوم (`Ratings & Reviews`) مع نظام موافقة إداري للحفاظ على جودة المحتوى. - **سلة تسوق حية (Reactive Cart)**: إضافة وتعديل كميات وحذف المنتجات فورياً دون تحديث الصفحة مدعومة بـ `CartService`. - **صفحة دفع آمنة (Checkout)**: دعم خيارات دفع متعددة، إدخال ملاحظات وتفاصيل التوصيل وعنوان الشحن والفواتير، واحتساب الضرائب والشحن تلقائياً. ### 2. بوابة ومميزات التجار (Multi-Vendor Marketplace) - **التسجيل الذاتي للتجار (`/vendor/register`)**: إمكانية تقديم طلب انضمام كبائع بسهولة وإدخال بيانات المتجر، الرابط المخصص (`store_slug`)، الشعار والبانر، وبيانات التواصل والعنوان. - **مسار مراجعة وقبول المتاجر**: صفحة انتظار حالة الطلب (`/vendor/pending`) مع تحكم إداري كامل للموافقة (`Approve`)، الرفض (`Reject`)، أو التعليق (`Suspend`). - **لوحة تحكم خاصة لكل تاجر (`/vendor/dashboard`)**: - إحصائيات فورية للأرباح، المبيعات، الطلبات المعلقة، وإجمالي المنتجات. - إدارة منتجات التاجر بالكامل (إضافة، تعديل، حذف). - دعم إدخال بيانات المنتجات باللغتين العربية والإنجليزية. - رفع صور متعددة وتحديد الصورة الرئيسية وترتيب العرض. - **إدارة الطلبات والعمولات**: - تتبع طلبات التاجر (`VendorOrder`). - حساب نسبة عمولة المنصة تلقائياً (`Commission`). - تتبع مستحقات التاجر وحالات الدفع (`Payouts`). ### 3. دورة حياة وتتبع الطلبات (Order Tracking & Lifecycle) - **نظام تتبع عام ومباشر (`/track-order`)**: يمكن لأي عميل الاستعلام عن حالة طلبه باستخدام رقم الطلب (مثل `ORD-XXXXXXXX`) دون الحاجة لتسجيل الدخول. - **خط زمني تفاعلي لحالة الطلب**: `Pending (قيد الانتظار)` ➔ `Confirmed (مؤكد)` ➔ `Processing (قيد المعالجة)` ➔ `Shipped (تم الشحن)` ➔ `Delivered (تم التسليم)` ➔ `Cancelled (ملغي)`. - **بوابة "طلباتي" للعملاء المسجلين (`/my-orders`)**: استعراض سجل الطلبات السابقة، المنتجات، الفواتير، وحالة التوصيل. - **إشعارات بريد إلكتروني آلية**: - بريد تأكيد الطلب للعميل عند الشراء. - إشعار فوري للإدارة بوجود طلب جديد. - تنبيه العميل فور تغيير وتحديث حالة الطلب. ### 4. لوحة الإدارة والتحكم (Admin Control Center) - **لوحة تحكم إحصائية شاملة (`/admin/dashboard`)**: عرض مؤشرات الأداء، المبيعات، ومعدلات النمو. - **إدارة المنتجات والتصنيفات**: CRUD كامل للمنتجات والفئات مع التحكم في الأسهم، الصور، والحالات النشطة. - **إدارة الطلبات**: تحديث الحالات، مراجعة بيانات الشحن والدفع، وطباعة الفواتير. - **إدارة التجار والعمولات**: مراجعة طلبات التسجيل، تحديد نسب العمولات، إدارة طلبات السحب وصرف الأرباح. - **إدارة المستخدمين والصلاحيات**: التحكم في الحسابات، ترقية المستخدمين لمسؤولين، وإدارة حالات الحسابات. - **إشراف ومراقبة التقييمات والرسائل**: - مراجعة واعتماد أو حذف تعليقات وتقييمات العملاء. - صندوق وارد لرسائل "اتصل بنا" مع تصنيف المقروء وغير المقروء. ### 5. تعدد اللغات والترجمة الحية (i18n & Localization) - **دعم كامل للغتين العربية (RTL) والإنجليزية (LTR)**. - **مبدل لغة تفاعلي (Language Switcher)** يحفظ تفضيل العميل تلقائياً في الجلسة. - **نظام ترجمة هجين (Hybrid Translation)**: - ملفات لغة مهيكلة (`lang/ar` و `lang/en`). - جدول ترجمات حي بقاعدة البيانات (`translations`) مع إمكانية تعديل النصوص واستيرادها من لوحة التحكم (`/admin/translations`).

Technologies Used