# 👤 دليل المستخدم - نظام AUTO TESTER

## 🎯 نظرة عامة

مرحباً بك في نظام AUTO TESTER! هذا الدليل سيساعدك على استخدام جميع ميزات النظام بكفاءة وسهولة.

---

## 🚀 البدء السريع

### 1. تسجيل الدخول

1. افتح المتصفح وانتقل إلى: `http://localhost/autotestersystem111/public/auth/login.html`
2. أدخل بريدك الإلكتروني وكلمة المرور
3. اضغط على "تسجيل الدخول"

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

بعد تسجيل الدخول، سيتم توجيهك إلى لوحة التحكم المناسبة لدورك:

- **👑 المدير العام** → `public/admin/dashboard.html`
- **👔 المشرف** → `public/supervisor/dashboard-new.html`
- **🔧 الفاحص** → صفحة الفحوصات المخصصة
- **👤 العميل** → صفحة طلبات الفحص

---

## 📋 حسب الدور

### 👑 المدير العام (Admin)

#### الصفحة الرئيسية
**الوصول:** `public/admin/dashboard.html`

#### المميزات المتاحة:

##### 📊 الإحصائيات العامة
- عرض إجمالي المستخدمين والفاحصين
- إحصائيات الفحوصات المنجزة والمعلقة
- إحصائيات الإيرادات والتقييمات
- رسوم بيانية تفاعلية

##### 👥 إدارة المستخدمين
- **إضافة مستخدم جديد:**
  1. اذهب إلى "المستخدمين" من القائمة الجانبية
  2. اضغط على "إضافة مستخدم جديد"
  3. املأ بيانات المستخدم (الاسم، البريد، الدور، إلخ)
  4. اختر الدور المناسب (مشرف، فاحص، عميل)
  5. اضغط "حفظ"

- **تعديل مستخدم:**
  1. ابحث عن المستخدم في جدول المستخدمين
  2. اضغط على أيقونة التعديل بجانب اسم المستخدم
  3. عدل البيانات المطلوبة
  4. اضغط "تحديث"

- **حذف مستخدم:**
  1. اضغط على أيقونة الحذف بجانب المستخدم
  2. أكد الحذف في نافذة التأكيد

##### 🏢 إدارة المراكز
- **إضافة مركز جديد:**
  1. اذهب إلى "المراكز"
  2. اضغط "إضافة مركز جديد"
  3. املأ بيانات المركز (الاسم، العنوان، المدير، إلخ)
  4. أدخل إحداثيات GPS (خط العرض والطول)
  5. اضغط "حفظ"

- **عرض الخريطة:**
  1. اضغط على "عرض الخريطة" لرؤية جميع المراكز على خريطة تفاعلية
  2. استخدم الفلاتر لعرض المراكز النشطة فقط

##### 📊 التقارير
- **التقارير الشاملة:**
  1. اذهب إلى "التقارير"
  2. اختر نوع التقرير (فحوصات، مستخدمين، إيرادات)
  3. حدد الفترة الزمنية
  4. اضغط "عرض التقرير"
  5. يمكنك تصدير التقرير كـ PDF أو Excel

- **سجل النشاطات:**
  1. اذهب إلى "سجل النشاطات"
  2. استخدم الفلاتر للبحث عن نشاطات محددة
  3. عرض تفاصيل كل نشاط

---

### 👔 المشرف (Supervisor)

#### الصفحة الرئيسية
**الوصول:** `public/supervisor/dashboard-new.html`

#### المميزات المتاحة:

##### 📊 لوحة التحكم
- عرض إحصائيات منطقتك (الفاحصين، الفحوصات، المراكز)
- متابعة الفحوصات المعلقة التي تحتاج موافقتك
- عرض أداء الفاحصين في منطقتك
- رسوم بيانية تفاعلية

##### 👥 إدارة الفاحصين
- **إضافة فاحص جديد:**
  1. اذهب إلى "الفاحصون" من القائمة الجانبية
  2. اضغط "إضافة فاحص جديد"
  3. املأ بيانات الفاحص (الاسم، البريد، الرقم، المنطقة، الراتب)
  4. اضغط "حفظ"

- **عرض الأداء:**
  1. من القائمة الجانبية، اختر "الأداء"
  2. عرض إحصائيات أداء كل فاحص
  3. تصدير تقارير الأداء

- **تفعيل/تعطيل الفاحصين:**
  1. من جدول الفاحصين، اضغط على أيقونة الحالة
  2. اختر "تفعيل" أو "تعطيل"
  3. أكد التغيير

##### 📋 إدارة الفحوصات
- **عرض جميع الفحوصات:**
  1. اذهب إلى "الفحوصات"
  2. استخدم الفلاتر (الحالة، الأولوية، التاريخ)
  3. اضغط "تطبيق الفلاتر"

- **اعتماد الفحوصات:**
  1. من جدول الفحوصات المعلقة، اضغط "اعتماد"
  2. راجع تفاصيل الفحص
  3. اضغط "تأكيد الاعتماد"

- **رفض الفحوصات:**
  1. اضغط "رفض" بجانب الفحص
  2. أدخل سبب الرفض
  3. اضغط "تأكيد الرفض"

- **تعيين فاحص للفحص:**
  1. من الفحوصات المعلقة، اضغط "تعيين فاحص"
  2. اختر الفاحص المناسب من القائمة
  3. أضف ملاحظات إذا لزم
  4. اضغط "تعيين"

##### 🏢 إدارة المراكز
- **عرض مراكز منطقتك:**
  1. اذهب إلى "المراكز"
  2. اعرض جميع المراكز التابعة لمنطقتك
  3. استخدم الفلاتر للبحث عن مراكز محددة

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

##### 📊 التقارير
- **تقارير الفاحصين:**
  1. اذهب إلى "التقارير"
  2. اختر "تقارير الفاحصين"
  3. حدد الفترة والفاحص
  4. اضغط "عرض التقرير"

- **تقارير الفحوصات:**
  1. اختر "تقارير الفحوصات"
  2. حدد الفترة والحالة
  3. اضغط "عرض التقرير"

---

### 🔧 الفاحص (Inspector)

#### الصفحة الرئيسية
**الوصول:** صفحة الفحوصات المخصصة للفاحص

#### المميزات المتاحة:

##### 📋 الفحوصات المكلف بها
- **عرض جدول الفحوصات:**
  1. عرض جميع الفحوصات المكلف بها
  2. عرض حالة كل فحص (معلق، قيد التنفيذ، مكتمل)
  3. عرض تفاصيل السيارة والعميل

- **تحديث حالة الفحص:**
  1. اضغط على الفحص لعرض التفاصيل
  2. اضغط "بدء الفحص" لتغيير الحالة إلى "قيد التنفيذ"
  3. اضغط "إكمال الفحص" عند الانتهاء

- **إدخال نتائج الفحص:**
  1. من تفاصيل الفحص، اضغط "إضافة تقرير"
  2. املأ بيانات الفحص (المحرك، الفرامل، السلامة، إلخ)
  3. ارفع صور الفحص
  4. اضغط "حفظ التقرير"

##### 📅 جدول الأعمال
- **عرض المواعيد:**
  1. اذهب إلى "جدول الأعمال"
  2. عرض جميع المواعيد القادمة
  3. عرض تفاصيل كل موعد (العميل، السيارة، النوع)

- **تأكيد الحضور:**
  1. اضغط على "تأكيد الحضور" بجانب الموعد
  2. اضغط "تأكيد" في نافذة التأكيد
  3. سيتم تحديث حالة الموعد

##### 📊 التقارير الشخصية
- **عرض أدائك:**
  1. اذهب إلى "التقارير"
  2. اختر "تقارير الأداء"
  3. عرض إحصائيات الفحوصات المنجزة
  4. عرض متوسط التقييمات

---

### 👤 العميل (Client)

#### الصفحة الرئيسية
**الوصول:** `public/auth/login.html` (بعد تسجيل الدخول كعميل)

#### المميزات المتاحة:

##### 📋 طلب فحص جديد
- **إنشاء طلب فحص:**
  1. بعد تسجيل الدخول، اضغط "طلب فحص جديد"
  2. املأ بيانات السيارة (الماركة، الموديل، السنة، رقم اللوحة)
  3. اختر نوع الفحص المطلوب
  4. اختر المركز المفضل والتاريخ المناسب
  5. أضف ملاحظات إضافية
  6. اضغط "إرسال الطلب"

- **اختيار المركز:**
  1. اضغط على "عرض المراكز"
  2. استخدم الخريطة للعثور على أقرب مركز
  3. اعرض تفاصيل كل مركز (العنوان، ساعات العمل، الهاتف)

##### 📊 متابعة الطلبات
- **عرض حالة الطلب:**
  1. من لوحة التحكم، اعرض "طلباتي"
  2. عرض حالة كل طلب (معلق، معتمد، قيد التنفيذ، مكتمل)
  3. عرض تاريخ وتفاصيل كل طلب

- **عرض تقارير الفحوصات:**
  1. اضغط على أي فحص مكتمل لعرض التقرير
  2. عرض نتائج الفحص بالتفصيل
  3. تحميل التقرير كـ PDF

##### 👤 الملف الشخصي
- **تعديل البيانات الشخصية:**
  1. اذهب إلى "الملف الشخصي"
  2. عدل الاسم، البريد، رقم الهاتف
  3. اضغط "حفظ التغييرات"

- **تغيير كلمة المرور:**
  1. من الملف الشخصي، اضغط "تغيير كلمة المرور"
  2. أدخل كلمة المرور الحالية والجديدة
  3. اضغط "تحديث كلمة المرور"

---

## 🎨 الميزات العامة

### 📱 التصميم المتجاوب
- يعمل على جميع الأجهزة (Desktop، Tablet، Mobile)
- واجهة متكيفة مع حجم الشاشة
- قائمة جانبية قابلة للطي في الأجهزة المحمولة

### 🌐 دعم اللغة العربية
- واجهة بالكامل باللغة العربية
- اتجاه النص من اليمين إلى اليسار (RTL)
- خط Cairo المحسن للنصوص العربية

### 📊 الرسوم البيانية التفاعلية
- رسوم بيانية ديناميكية للإحصائيات
- تصدير البيانات كـ PDF و Excel
- فلاتر متقدمة للبحث والعرض

### 🗺️ الخرائط التفاعلية
- خرائط تفاعلية للمراكز والفحوصات
- تجميع العلامات للعرض الأفضل
- بحث متقدم على الخريطة

---

## 🔐 الأمان

### 🔑 المصادقة
- تسجيل دخول آمن باستخدام JWT
- انتهاء صلاحية الجلسة التلقائي
- حماية كلمة المرور

### 🛡️ الصلاحيات
- صلاحيات حسب الدور
- لا يمكن الوصول إلى بيانات أعلى من دور المستخدم
- سجل كامل لجميع العمليات

### 🔒 حماية البيانات
- تشفير البيانات الحساسة
- حماية ضد هجمات SQL Injection
- CSRF Protection للنماذج

---

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

### 🆘 التواصل
- **البريد الإلكتروني:** support@autotester.com
- **الهاتف:** +966 50 123 4567
- **WhatsApp:** +966 50 123 4567

### 📚 الوثائق
- **دليل المستخدم:** هذا الملف
- **وثائق API:** `API_DOCUMENTATION.md`
- **الهيكل التنظيمي:** `SYSTEM_ARCHITECTURE.md`

### 🐛 الإبلاغ عن المشاكل
- عند مواجهة أي مشكلة، يرجى:
  1. وصف المشكلة بالتفصيل
  2. تحديد الخطوات التي أدت إلى المشكلة
  3. إضافة لقطة شاشة إن أمكن
  4. إرسال البلاغ إلى: support@autotester.com

---

## 📱 التطبيقات المحمولة

### 📱 تطبيق الأندرويد
- قم بتحميل التطبيق من Google Play Store
- تسجيل الدخول بنفس بيانات الويب
- الوصول إلى جميع الميزات من جهازك المحمول

### 📱 تطبيق iOS
- قم بتحميل التطبيق من App Store
- واجهة محسنة لأجهزة iOS
- إشعارات فورية للتحديثات الهامة

---

## 🔧 نصائح الاستخدام

### 💡 نصائح عامة
- استخدم متصفح حديث (Chrome، Firefox، Safari، Edge)
- تأكد من اتصال الإنترنت المستقر
- احفظ بيانات تسجيل الدخول في مكان آمن
- سجل الخروج عند استخدام أجهزة مشتركة

### ⚡ تحسين الأداء
- امسح ذاكرة التخزين المؤقت للمتصفح بانتظام
- استخدم اتصال إنترنت سريع للخرائط التفاعلية
- أغلق التبويب غير المستخدمة لتحسين الأداء

### 🔍 البحث والتصفية
- استخدم فلاتر البحث للعثور السريع على البيانات
- استخدم التصنيفات لتنظيم البيانات
- احفظ البحثات المتكررة

---

## 📈 التحديثات الجديدة

### 🆕 ما الجديد في الإصدار 1.0
- واجهة مستخدم جديدة بالكامل
- نظام صلاحيات متقدم
- خرائط تفاعلية محسنة
- تقارير متقدمة مع التصدير
- تطبيقات محمولة جديدة

### 📅 خارطة الطريق
- **الإصدار 1.1:** إشعارات فورية، تحليلات متقدمة
- **الإصدار 1.2:** تكامل مع أنظمة أخرى، API مفتوح
- **الإصدار 2.0:** ذكاء اصطناعي للفحوصات

---

## 🎯 الخلاصة

نظام AUTO TESTER هو حل متكامل لإدارة الفحوصات الفنية يوفر:

✅ **سهولة الاستخدام** مع واجهة مستخدم بديهية  
✅ **أمان عالي** مع حماية البيانات الكاملة  
✅ **مرونة كاملة** مع دعم جميع الأجهزة  
✅ **تقارير متقدمة** مع خيارات تصدير متعددة  
✅ **خرائط تفاعلية** لتتبع المراكز والفحوصات  
✅ **دعم فني** كامل مع وثائق شاملة  

**شكراً لاستخدامك نظام AUTO TESTER!** 🚀
