منصة ساج (SAJ Platform)

منصة متكاملة للتجارة الإلكترونية والخدمات الرقمية.

المميزات

• نظام متكامل للتجارة الإلكترونية
• إدارة المتاجر والتجار
• نظام الدفع الإلكتروني
• نظام التوصيل والخدمات اللوجستية
• نظام المحفظة الإلكترونية
• نظام الإشعارات
• نظام المراسلة الداخلية
• لوحة تحكم متكاملة
• واجهة برمجة التطبيقات (API)
• تطبيق جوال

هيكل المسارات

تم تنظيم مسارات النظام في ملفات منفصلة لتسهيل الصيانة والتطوير:

routes/
├── web.php            # ملف المسارات الرئيسي (يقوم بتضمين جميع الملفات الأخرى)
├── api.php            # مسارات واجهة برمجة التطبيقات
├── account.php        # مسارات إدارة الحساب
├── support.php        # مسارات نظام الدعم
└── web/               # مجلد مسارات الويب المنظمة
    ├── public.php     # المسارات العامة
    ├── auth.php       # مسارات المصادقة
    ├── user.php       # مسارات لوحة تحكم المستخدم العادي
    ├── merchant.php   # مسارات لوحة تحكم التاجر
    ├── delivery.php   # مسارات لوحة تحكم مندوب التوصيل
    ├── supervisor.php # مسارات لوحة تحكم المشرف
    └── admin.php      # مسارات لوحة تحكم المدير

المتطلبات

• PHP 8.1 أو أحدث
• MySQL 5.7 أو أحدث
• Composer
• Node.js و npm
• Redis (اختياري)

التثبيت

1. استنساخ المشروع:

git clone https://github.com/saj/saj.git
cd saj

2. تثبيت التبعيات:

composer install
npm install

3. نسخ ملف البيئة:

cp env.example .env

4. إنشاء مفتاح التطبيق:

php artisan key:generate

5. تكوين قاعدة البيانات في ملف .env

6. تشغيل الهجرات:

php artisan migrate

7. تشغيل البذور:

php artisan db:seed

8. تشغيل الخادم:

php artisan serve

الهيكل

saj/
├── app/                # التطبيق الرئيسي
├── src/                # المكونات الأساسية
├── config/             # ملفات التكوين
├── database/           # قاعدة البيانات
├── public/             # الملفات العامة
├── resources/          # الموارد
├── routes/             # المسارات
├── storage/            # التخزين
├── tests/              # الاختبارات
└── vendor/             # التبعيات

المساهمة

نرحب بمساهماتكم! يرجى اتباع الخطوات التالية:

1. Fork المشروع
2. إنشاء فرع للميزة (git checkout -b feature/AmazingFeature)
3. Commit التغييرات (git commit -m 'إضافة ميزة رائعة')
4. Push إلى الفرع (git push origin feature/AmazingFeature)
5. فتح طلب Pull Request

الترخيص

هذا المشروع مرخص تحت رخصة MIT - انظر ملف LICENSE للتفاصيل.

الدعم

للحصول على الدعم، يرجى التواصل عبر:

• البريد الإلكتروني: support@saj.com
• الموقع: https://saj.com/support
• الواتساب: +966123456789

نظام SAJ - خريطة المسارات الرئيسية

المسارات العامة

المسار	الإسم	الوصف
/	home	الصفحة الرئيسية
/about	about	صفحة من نحن
/services	services	صفحة الخدمات الرئيسية
/contact	contact	صفحة اتصل بنا
/terms	terms	شروط الاستخدام
/privacy	privacy	سياسة الخصوصية
/faq	faq	الأسئلة الشائعة
/products	products	عرض المنتجات
/blog	blog	المدونة

مسارات الخدمات التفصيلية

المسار	الإسم	الوصف
/services/digital-marketing	services.digital-marketing	التسويق الرقمي
/services/social-media	services.social-media	وسائل التواصل الاجتماعي
/services/web-development	services.web-development	تطوير الويب
/services/mobile-apps	services.mobile-apps	تطبيقات الموبايل
/services/ecommerce	services.ecommerce	التجارة الإلكترونية
/services/payment	services.payment	خدمات الدفع

مسارات الشركاء

المسار	الإسم	الوصف
/partners/bank-of-khartoum	partners.bank-of-khartoum	بنك الخرطوم
/partners/sudanese-telecom	partners.sudanese-telecom	شركة الاتصالات السودانية
/partners/express-company	partners.express-company	شركة التوصيل السريع
/partners/tech-innovators	partners.tech-innovators	شركة المبتكرين التقنيين

مسارات المصادقة

المسار	الإسم	الوصف
/login	login	تسجيل الدخول
/register/user	register.user	تسجيل مستخدم عادي جديد
/register/merchant	register.merchant	تسجيل تاجر جديد
/register/delivery	register.delivery	تسجيل مندوب توصيل جديد
/verify	verify	التحقق من البريد الإلكتروني والهاتف
/password/reset	password.reset	طلب إعادة تعيين كلمة المرور
/password/reset/{token}	password.reset.token	إعادة تعيين كلمة المرور
/logout	logout	تسجيل الخروج

لوحة تحكم المستخدم العادي

المسار	الإسم	الوصف
/user/dashboard	user.dashboard	اللوحة الرئيسية
/user/profile	user.profile	الملف الشخصي
/user/orders	user.orders	الطلبات
/user/wallet	user.wallet	المحفظة
/user/messages	user.messages	الرسائل
/user/settings	user.settings	الإعدادات
/user/notifications	user.notifications	الإشعارات
/user/addresses	user.addresses	العناوين
/user/wishlist	user.wishlist	المفضلة

لوحة تحكم التاجر

المسار	الإسم	الوصف
/merchant/dashboard	merchant.dashboard	اللوحة الرئيسية
/merchant/profile	merchant.profile	الملف الشخصي
/merchant/products	merchant.products	المنتجات
/merchant/orders	merchant.orders	الطلبات
/merchant/customers	merchant.customers	العملاء
/merchant/wallet	merchant.wallet	المحفظة
/merchant/messages	merchant.messages	الرسائل
/merchant/analytics	merchant.analytics	التحليلات
/merchant/settings	merchant.settings	الإعدادات
/merchant/staff	merchant.staff	الموظفين

لوحة تحكم مندوب التوصيل

المسار	الإسم	الوصف
/delivery/dashboard	delivery.dashboard	اللوحة الرئيسية
/delivery/profile	delivery.profile	الملف الشخصي
/delivery/orders	delivery.orders	الطلبات
/delivery/wallet	delivery.wallet	المحفظة
/delivery/messages	delivery.messages	الرسائل
/delivery/routes	delivery.routes	مسارات التوصيل
/delivery/settings	delivery.settings	الإعدادات
/delivery/ratings	delivery.ratings	التقييمات

لوحة تحكم المشرف

المسار	الإسم	الوصف
/supervisor/dashboard	supervisor.dashboard	اللوحة الرئيسية
/supervisor/merchants	supervisor.merchants	التجار
/supervisor/delivery-agents	supervisor.delivery-agents	مندوبي التوصيل
/supervisor/users	supervisor.users	المستخدمين
/supervisor/orders	supervisor.orders	الطلبات
/supervisor/reports	supervisor.reports	التقارير
/supervisor/messages	supervisor.messages	الرسائل
/supervisor/settings	supervisor.settings	الإعدادات

لوحة تحكم المدير

المسار	الإسم	الوصف
/admin/dashboard	admin.dashboard	اللوحة الرئيسية
/admin/users	admin.users	المستخدمين
/admin/merchants	admin.merchants	التجار
/admin/delivery-agents	admin.delivery-agents	مندوبي التوصيل
/admin/supervisors	admin.supervisors	المشرفين
/admin/settings	admin.settings	الإعدادات
/admin/roles	admin.roles	الأدوار
/admin/permissions	admin.permissions	الصلاحيات
/admin/system-logs	admin.system-logs	سجلات النظام
/admin/backup	admin.backup	النسخ الاحتياطي
/admin/notifications	admin.notifications	الإشعارات
/admin/analytics	admin.analytics	التحليلات
/admin/wallet-management	admin.wallet-management	إدارة المحافظ
/admin/countries	admin.countries	الدول
/admin/currencies	admin.currencies	العملات
/admin/languages	admin.languages	اللغات