# 📚 دليل المستخدم والإدارة الشامل - Q ROVER

## نظام تأجير المركبات الفاخرة

---

## 📋 فهرس المحتويات

1. [نظرة عامة على النظام](#نظرة-عامة-على-النظام)
2. [دليل المستخدم](#دليل-المستخدم)
3. [دليل لوحة التحكم الإدارية](#دليل-لوحة-التحكم-الإدارية)
4. [التوثيق التقني](#التوثيق-التقني)
5. [توثيق سير العمل](#توثيق-سير-العمل)
6. [استكشاف الأخطاء وإصلاحها](#استكشاف-الأخطاء-وإصلاحها)

---

## 🌟 نظرة عامة على النظام

### ما هو Q ROVER؟

Q ROVER هو نظام متطور لتأجير المركبات الفاخرة يوفر تجربة مستخدم متميزة مع واجهة ثنائية اللغة (العربية والإنجليزية) وتصميم فاخر بتقنية Glass Morphism.

### الميزات الرئيسية:

-   ✅ واجهة مستخدم فاخرة مع تصميم Glass Morphism
-   ✅ دعم كامل للغتين العربية والإنجليزية (RTL/LTR)
-   ✅ نظام حجز متطور مع إدارة التوفر
-   ✅ لوحة تحكم إدارية شاملة
-   ✅ إدارة متقدمة للمركبات والصور
-   ✅ نظام تقارير وإحصائيات
-   ✅ تصميم متجاوب لجميع الأجهزة

### مستويات الوصول:

-   **👨‍💼 المدير العام (Admin)**: صلاحيات كاملة
-   **👥 الموظف (Staff)**: إدارة الحجوزات والمركبات
-   **👤 العميل (Customer)**: تصفح وحجز المركبات

---

## 👤 دليل المستخدم

### 1. تصفح والبحث عن المركبات

#### الوصول إلى صفحة المركبات:

```
الرابط: http://localhost:8000/vehicles
القائمة: الصفحة الرئيسية → أسطولنا
```

#### خيارات البحث والتصفية:

1. **البحث النصي**:

    - ابحث بالماركة أو الموديل
    - مثال: "BMW", "Mercedes", "تويوتا"

2. **تصفية السعر**:

    - أقل سعر: حدد الحد الأدنى للسعر اليومي
    - أعلى سعر: حدد الحد الأقصى للسعر اليومي

3. **ترتيب النتائج**:
    - حسب السعر (من الأقل إلى الأعلى)
    - حسب السنة (الأحدث أولاً)
    - حسب الماركة (أبجدياً)

#### عرض تفاصيل المركبة:

-   انقر على "عرض التفاصيل" لرؤية:
    -   معرض الصور التفاعلي
    -   المواصفات الكاملة
    -   الميزات والخدمات
    -   الأسعار (يومي، أسبوعي، شهري)
    -   المركبات المشابهة

### 2. عملية التسجيل وتسجيل الدخول

#### إنشاء حساب جديد:

```
الرابط: http://localhost:8000/register
```

**المعلومات المطلوبة**:

-   الاسم الكامل
-   البريد الإلكتروني
-   رقم الهاتف
-   كلمة المرور (8 أحرف على الأقل)
-   تأكيد كلمة المرور

#### تسجيل الدخول:

```
الرابط: http://localhost:8000/login
```

**بيانات الدخول**:

-   البريد الإلكتروني
-   كلمة المرور

### 3. عملية الحجز والدفع

#### خطوات الحجز:

1. **اختيار المركبة**: من صفحة الأسطول أو التفاصيل
2. **تحديد التواريخ**:

    - تاريخ الاستلام
    - تاريخ التسليم
    - وقت الاستلام والتسليم

3. **اختيار المواقع**:

    - موقع الاستلام
    - موقع التسليم

4. **مراجعة الحجز**:

    - تفاصيل المركبة
    - التواريخ والأوقات
    - إجمالي التكلفة
    - الضمان المطلوب

5. **إتمام الدفع**:
    - معلومات بطاقة الائتمان
    - عنوان الفوترة
    - تأكيد الدفع

#### حالات الحجز:

-   **قيد المراجعة**: في انتظار موافقة الإدارة
-   **مؤكد**: تم قبول الحجز
-   **نشط**: المركبة مستلمة حالياً
-   **مكتمل**: تم إرجاع المركبة
-   **ملغي**: تم إلغاء الحجز

### 4. إدارة الحجوزات الشخصية

#### عرض الحجوزات:

```
الرابط: http://localhost:8000/bookings
```

**المعلومات المتاحة**:

-   تفاصيل المركبة المحجوزة
-   التواريخ والأوقات
-   حالة الحجز
-   إجمالي التكلفة
-   معلومات الاتصال

#### إلغاء أو تعديل الحجز:

-   **الإلغاء**: متاح حتى 24 ساعة قبل الاستلام
-   **التعديل**: اتصل بخدمة العملاء
-   **رسوم الإلغاء**: حسب سياسة الشركة

---

## 🎛️ دليل لوحة التحكم الإدارية

### الوصول إلى لوحة التحكم:

```
الرابط: http://localhost:8000/admin/dashboard
بيانات المدير: admin@qrover.om / admin123
بيانات الموظف: staff@qrover.om / staff123
```

### 1. نظرة عامة على لوحة التحكم

#### الإحصائيات الرئيسية:

-   إجمالي المركبات
-   الحجوزات النشطة
-   إجمالي العملاء
-   الإيرادات الشهرية

#### الحجوزات الأخيرة:

-   قائمة بأحدث الحجوزات
-   حالة كل حجز
-   إمكانية التحديث السريع

#### المركبات الأكثر طلباً:

-   ترتيب المركبات حسب عدد الحجوزات
-   إحصائيات الأداء

### 2. إدارة المركبات

#### إضافة مركبة جديدة:

```
المسار: لوحة التحكم → المركبات → إضافة جديد
```

**المعلومات الأساسية**:

-   الماركة والموديل
-   سنة الصنع
-   اللون (عربي وإنجليزي)
-   رقم اللوحة
-   رقم الهيكل (VIN)

**المواصفات التقنية**:

-   نوع ناقل الحركة (أوتوماتيك/يدوي)
-   نوع الوقود (بنزين/ديزل/هجين/كهربائي)
-   عدد المقاعد
-   عدد الأبواب
-   حجم المحرك
-   المسافة المقطوعة

**التسعير**:

-   السعر اليومي
-   السعر الأسبوعي
-   السعر الشهري
-   مبلغ الضمان

**الوصف والميزات**:

-   الوصف (عربي وإنجليزي)
-   الميزات (عربي وإنجليزي)
-   الفئة
-   حالة المركبة

#### إدارة صور المركبات:

1. **رفع الصور**:

    - اختر ملفات متعددة
    - الحد الأقصى: 10 صور لكل مركبة
    - الأحجام المدعومة: JPG, PNG, WebP
    - الحد الأقصى للحجم: 5MB لكل صورة

2. **ترتيب الصور**:

    - اسحب وأفلت لإعادة الترتيب
    - حدد الصورة الرئيسية
    - أضف نص بديل للصور

3. **تحرير الصور**:
    - قص وتغيير الحجم
    - إضافة علامات مائية
    - تحسين الجودة

#### تحديث حالة المركبة:

-   **متاحة**: جاهزة للحجز
-   **مؤجرة**: محجوزة حالياً
-   **صيانة**: في ورشة الصيانة
-   **غير نشطة**: خارج الخدمة مؤقتاً

### 3. إدارة الحجوزات

#### عرض جميع الحجوزات:

```
المسار: لوحة التحكم → الحجوزات
```

**فلترة الحجوزات**:

-   حسب الحالة
-   حسب التاريخ
-   حسب العميل
-   حسب المركبة

#### تحديث حالة الحجز:

1. **قيد المراجعة → مؤكد**: موافقة على الحجز
2. **مؤكد → نشط**: تسليم المركبة
3. **نشط → مكتمل**: استلام المركبة
4. **أي حالة → ملغي**: إلغاء الحجز

#### إدارة المدفوعات:

-   تتبع حالة الدفع
-   إصدار فواتير
-   معالجة المبالغ المستردة

### 4. إدارة المستخدمين

#### عرض جميع المستخدمين:

```
المسار: لوحة التحكم → المستخدمين
```

**معلومات المستخدم**:

-   الاسم الكامل
-   البريد الإلكتروني
-   رقم الهاتف
-   تاريخ التسجيل
-   عدد الحجوزات
-   الحالة (نشط/معطل)

#### إدارة الصلاحيات:

-   **عميل**: حجز المركبات فقط
-   **موظف**: إدارة الحجوزات
-   **مدير**: صلاحيات كاملة

### 5. إدارة الفئات والمواقع

#### فئات المركبات:

-   اقتصادية
-   فاخرة
-   رياضية
-   دفع رباعي
-   كهربائية

#### مواقع الاستلام والتسليم:

-   المطار
-   الفنادق الرئيسية
-   مراكز التسوق
-   المكاتب

---

## 🔧 التوثيق التقني

### بيانات الدخول الافتراضية:

#### المدير العام:

```
البريد الإلكتروني: admin@qrover.om
كلمة المرور: admin123
الصلاحيات: كاملة
```

#### الموظف:

```
البريد الإلكتروني: staff@qrover.om
كلمة المرور: staff123
الصلاحيات: محدودة
```

#### العميل التجريبي:

```
البريد الإلكتروني: customer@qrover.om
كلمة المرور: customer123
الصلاحيات: عميل
```

### هيكل قاعدة البيانات:

#### جدول المركبات (vehicles):

```sql
- id: المعرف الفريد
- category_id: معرف الفئة
- make: الماركة
- model: الموديل
- year: سنة الصنع
- color_en/color_ar: اللون
- transmission: ناقل الحركة
- fuel_type: نوع الوقود
- seats: عدد المقاعد
- doors: عدد الأبواب
- daily_rate: السعر اليومي
- status: الحالة
- is_featured: مميز في الصفحة الرئيسية
```

#### جدول الحجوزات (bookings):

```sql
- id: المعرف الفريد
- user_id: معرف المستخدم
- vehicle_id: معرف المركبة
- pickup_datetime: تاريخ الاستلام
- dropoff_datetime: تاريخ التسليم
- pickup_location_id: موقع الاستلام
- dropoff_location_id: موقع التسليم
- total_amount: إجمالي المبلغ
- status: حالة الحجز
```

### API Endpoints:

#### المركبات:

```
GET /api/vehicles - جلب جميع المركبات
GET /api/vehicles/{id} - جلب مركبة محددة
POST /api/vehicles - إضافة مركبة جديدة
PUT /api/vehicles/{id} - تحديث مركبة
DELETE /api/vehicles/{id} - حذف مركبة
```

#### الحجوزات:

```
GET /api/bookings - جلب جميع الحجوزات
POST /api/bookings - إنشاء حجز جديد
PUT /api/bookings/{id} - تحديث حجز
DELETE /api/bookings/{id} - إلغاء حجز
```

---

## 📊 توثيق سير العمل

### 1. سير عمل الحجز:

```
العميل يتصفح المركبات
    ↓
يختار مركبة ويحدد التواريخ
    ↓
يملأ معلومات الحجز
    ↓
يتم إرسال طلب الحجز (حالة: قيد المراجعة)
    ↓
الموظف يراجع الطلب
    ↓
موافقة/رفض الطلب
    ↓
إشعار العميل بالقرار
    ↓
في حالة الموافقة: تأكيد الدفع
    ↓
تسليم المركبة (حالة: نشط)
    ↓
استلام المركبة (حالة: مكتمل)
```

### 2. سير عمل إدارة المركبات:

```
إضافة مركبة جديدة
    ↓
رفع الصور والمعلومات
    ↓
مراجعة البيانات
    ↓
تفعيل المركبة (حالة: متاحة)
    ↓
ظهور في قائمة المركبات
    ↓
متابعة الحجوزات والصيانة
    ↓
تحديث الحالة حسب الحاجة
```

---

## ⚠️ استكشاف الأخطاء وإصلاحها

### المشاكل الشائعة والحلول:

#### 1. مشكلة تسجيل الدخول:

**المشكلة**: لا يمكن تسجيل الدخول
**الحلول**:

-   تأكد من صحة البريد الإلكتروني وكلمة المرور
-   امسح ذاكرة التخزين المؤقت للمتصفح
-   تأكد من تفعيل JavaScript
-   جرب متصفح آخر

#### 2. مشكلة رفع الصور:

**المشكلة**: فشل في رفع صور المركبات
**الحلول**:

-   تأكد من حجم الصورة (أقل من 5MB)
-   استخدم تنسيقات مدعومة (JPG, PNG, WebP)
-   تحقق من صلاحيات المجلد
-   تأكد من استقرار الاتصال بالإنترنت

#### 3. مشكلة عرض المركبات:

**المشكلة**: لا تظهر المركبات في الصفحة الرئيسية
**الحلول**:

-   تأكد من وجود مركبات مفعلة
-   تحقق من إعداد "مميز" للمركبات
-   امسح ذاكرة التخزين المؤقت
-   تحقق من حالة قاعدة البيانات

### أفضل الممارسات الأمنية:

1. **كلمات المرور**:

    - استخدم كلمات مرور قوية (12 حرف على الأقل)
    - غيّر كلمات المرور الافتراضية فوراً
    - استخدم مزيج من الأحرف والأرقام والرموز

2. **النسخ الاحتياطي**:

    - انسخ قاعدة البيانات يومياً
    - احفظ نسخ من الصور والملفات
    - اختبر استعادة النسخ الاحتياطية دورياً

3. **التحديثات**:
    - حدّث النظام والإضافات بانتظام
    - راقب التحديثات الأمنية
    - اختبر التحديثات في بيئة تجريبية أولاً

---

## 📞 الدعم والمساعدة

### للحصول على المساعدة:

-   **البريد الإلكتروني**: support@qrover.om
-   **الهاتف**: +968 1234 5678
-   **ساعات العمل**: 8:00 ص - 6:00 م (السبت - الخميس)

### الموارد الإضافية:

-   دليل المطور التقني
-   فيديوهات تعليمية
-   منتدى المجتمع
-   قاعدة المعرفة

---

## 📸 دليل الصور والواجهات المرئية

### واجهة المستخدم الرئيسية:

#### الصفحة الرئيسية:

-   **القسم العلوي (Hero Section)**: عرض ترحيبي فاخر مع شعار الشركة
-   **قسم المركبات المميزة**: عرض دائري للمركبات الأكثر طلباً (6 مركبات)
-   **قسم الخدمات**: عرض الخدمات المتاحة مع أيقونات تفاعلية
-   **قسم الإحصائيات**: عدادات متحركة للعملاء والمركبات والخبرة
-   **قسم آراء العملاء**: شهادات العملاء مع تقييمات نجمية

#### صفحة الأسطول:

-   **شريط البحث والفلترة**: في الأعلى مع خيارات متقدمة
-   **عرض المركبات**: شبكة 3 مركبات في الصف (ديسكتوب)
-   **بطاقة المركبة**: تحتوي على:
    -   صورة المركبة مع تأثيرات hover
    -   اسم المركبة والفئة
    -   المواصفات الأساسية (مقاعد، ناقل حركة، وقود)
    -   السعر اليومي
    -   زر "عرض التفاصيل"

#### صفحة تفاصيل المركبة:

-   **معرض الصور**: عرض تفاعلي مع lightbox
-   **معلومات المركبة**: مواصفات مفصلة
-   **نموذج الحجز**: تحديد التواريخ والمواقع
-   **المركبات المشابهة**: اقتراحات أخرى

### واجهة لوحة التحكم الإدارية:

#### لوحة التحكم الرئيسية:

-   **الشريط الجانبي**: قائمة التنقل الرئيسية
-   **الإحصائيات**: بطاقات ملونة مع أرقام ورسوم بيانية
-   **الجداول**: عرض البيانات مع إمكانيات الفرز والبحث
-   **الأزرار**: تصميم متسق مع ألوان الشركة

#### صفحة إدارة المركبات:

-   **جدول المركبات**: عرض مدمج مع الصور والمعلومات
-   **نموذج إضافة/تعديل**: حقول منظمة في تبويبات
-   **رفع الصور**: منطقة سحب وإفلات مع معاينة

---

## 🔄 إجراءات الصيانة والنسخ الاحتياطي

### النسخ الاحتياطي اليومي:

#### نسخ قاعدة البيانات:

```bash
# إنشاء نسخة احتياطية
php artisan backup:run --only-db

# استعادة من نسخة احتياطية
mysql -u username -p database_name < backup_file.sql
```

#### نسخ الملفات والصور:

```bash
# نسخ مجلد التخزين
cp -r storage/app/public/* /backup/storage/

# نسخ الصور المرفوعة
rsync -av public/storage/ /backup/images/
```

### صيانة النظام:

#### تنظيف ذاكرة التخزين المؤقت:

```bash
# مسح جميع أنواع الكاش
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

# إعادة تحسين الأداء
php artisan config:cache
php artisan route:cache
php artisan view:cache
```

#### تحديث قاعدة البيانات:

```bash
# تشغيل الهجرات الجديدة
php artisan migrate

# إعادة تعبئة البيانات التجريبية
php artisan db:seed
```

### مراقبة الأداء:

#### مراقبة استخدام الخادم:

-   **استخدام المعالج**: يجب ألا يتجاوز 80%
-   **استخدام الذاكرة**: مراقبة استهلاك RAM
-   **مساحة القرص**: تأكد من توفر مساحة كافية
-   **سرعة الاستجابة**: قياس أوقات تحميل الصفحات

#### مراقبة قاعدة البيانات:

-   **حجم قاعدة البيانات**: مراقبة النمو
-   **الاستعلامات البطيئة**: تحسين الفهارس
-   **الاتصالات**: مراقبة عدد الاتصالات المتزامنة

---

## 📱 التوافق مع الأجهزة المحمولة

### التصميم المتجاوب:

#### نقاط التوقف (Breakpoints):

-   **الهواتف الذكية**: 320px - 768px
-   **الأجهزة اللوحية**: 768px - 1024px
-   **أجهزة الكمبيوتر**: 1024px فما فوق

#### تحسينات الهاتف المحمول:

-   **القوائم**: تحويل إلى قائمة منسدلة (hamburger menu)
-   **الأزرار**: حجم أكبر للمس السهل
-   **النصوص**: خطوط أكبر وأوضح
-   **الصور**: تحميل محسن للسرعة

#### اختبار التوافق:

-   **iOS Safari**: iPhone و iPad
-   **Android Chrome**: جميع أحجام الشاشات
-   **Samsung Internet**: أجهزة Samsung
-   **Firefox Mobile**: اختبار إضافي

---

## 🌐 إدارة اللغات والترجمة

### نظام الترجمة:

#### ملفات اللغة:

```
resources/lang/ar/     # الملفات العربية
resources/lang/en/     # الملفات الإنجليزية
```

#### إضافة ترجمات جديدة:

```php
// في ملف resources/lang/ar/messages.php
'welcome' => 'مرحباً بك',
'book_now' => 'احجز الآن',

// في ملف resources/lang/en/messages.php
'welcome' => 'Welcome',
'book_now' => 'Book Now',
```

#### استخدام الترجمات في الكود:

```php
// في ملفات Blade
{{ __('messages.welcome') }}
@lang('messages.book_now')

// في ملفات PHP
__('messages.welcome')
trans('messages.book_now')
```

### دعم RTL (من اليمين إلى اليسار):

#### CSS للعربية:

```css
[dir="rtl"] {
    text-align: right;
    direction: rtl;
}

[dir="rtl"] .margin-left {
    margin-right: 1rem;
    margin-left: 0;
}
```

#### JavaScript للاتجاه:

```javascript
// تحديد اتجاه النص حسب اللغة
if (document.documentElement.lang === "ar") {
    document.documentElement.dir = "rtl";
} else {
    document.documentElement.dir = "ltr";
}
```

---

## 💳 نظام الدفع والفوترة

### طرق الدفع المدعومة:

#### بطاقات الائتمان:

-   **Visa**: جميع الأنواع
-   **Mastercard**: جميع الأنواع
-   **American Express**: مدعومة
-   **Discover**: مدعومة

#### المحافظ الرقمية:

-   **Apple Pay**: للأجهزة المدعومة
-   **Google Pay**: لأجهزة Android
-   **Samsung Pay**: لأجهزة Samsung

#### الدفع المحلي:

-   **التحويل البنكي**: للمبالغ الكبيرة
-   **الدفع عند الاستلام**: حسب السياسة

### معالجة المدفوعات:

#### تأمين المعاملات:

-   **تشفير SSL**: جميع المعاملات مشفرة
-   **PCI DSS**: امتثال لمعايير الأمان
-   **3D Secure**: تحقق إضافي للبطاقات

#### إدارة المبالغ المستردة:

```php
// معالجة استرداد المبلغ
$refund = $payment->refund([
    'amount' => $booking->total_amount,
    'reason' => 'Customer cancellation'
]);
```

---

## 📊 التقارير والتحليلات

### تقارير المبيعات:

#### التقرير اليومي:

-   إجمالي الحجوزات
-   إجمالي الإيرادات
-   المركبات الأكثر حجزاً
-   معدل الإلغاء

#### التقرير الشهري:

-   نمو الإيرادات
-   تحليل العملاء الجدد
-   أداء المركبات
-   تقييم الخدمة

#### التقرير السنوي:

-   الأداء العام
-   التوقعات المستقبلية
-   تحليل السوق
-   خطط التوسع

### مؤشرات الأداء الرئيسية (KPIs):

#### مؤشرات المبيعات:

-   **معدل التحويل**: نسبة الزوار الذين يحجزون
-   **متوسط قيمة الحجز**: إجمالي الإيرادات ÷ عدد الحجوزات
-   **معدل العودة**: نسبة العملاء المتكررين

#### مؤشرات التشغيل:

-   **معدل استغلال الأسطول**: نسبة المركبات المحجوزة
-   **وقت الاستجابة**: سرعة معالجة الطلبات
-   **رضا العملاء**: متوسط التقييمات

---

**تاريخ آخر تحديث**: 1 أغسطس 2025
**إصدار الدليل**: 1.0
**النظام**: Q ROVER - نظام تأجير المركبات الفاخرة