Initial V2 commit 4

app/Http/Controllers/Admin/DriverManagementController.php

@@ -9,10 +9,15 @@ use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\DB;
 
 /**
- * Admin Driver Management Controller
- * Replaces: serviceapp/getDriverByPhone.php, getDriverByNational.php,
- * getDriversWaitingActive.php, getDriverDetailsForActivate.php,
- * updateDriverToActive.php, registerDriverAndCarService.php, etc.
+ * متحكم إدارة السائقين للمسؤولين (Admin Driver Management Controller)
+ * 
+ * الغرض من الملف:
+ * إدارة حسابات السائقين من قبل طاقم الإدارة، بما في ذلك تفعيل السائقين الجدد، البحث عنهم، وإضافتهم للنظام.
+ * 
+ * كيفية العمل:
+ * 1. يسمح بالبحث عن السائقين برقم الهاتف أو الرقم الوطني.
+ * 2. يتيح للمسؤول تفعيل أو إلغاء تفعيل حساب السائق.
+ * 3. يدير إضافة السيارات للسائقين والملاحظات الإدارية عليهم.
  */
 class DriverManagementController extends Controller
 {

app/Http/Controllers/Admin/PassengerManagementController.php

@@ -10,7 +10,14 @@ use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\DB;
 
 /**
- * Admin Passenger Management Controller
+ * متحكم إدارة الركاب للمسؤولين (Admin Passenger Management Controller)
+ * 
+ * الغرض من الملف:
+ * السماح للمسؤولين بالبحث عن الركاب المسجلين في النظام وإدارة حساباتهم.
+ * 
+ * كيفية العمل:
+ * 1. يوفر ميزة البحث عن الركاب حسب رقم الهاتف.
+ * 2. يعرض قائمة الركاب للمسؤول مع إمكانية التصفية (Pagination).
  */
 class PassengerManagementController extends Controller
 {

app/Http/Controllers/Admin/RideManagementController.php

@@ -8,7 +8,14 @@ use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\DB;
 
 /**
- * Admin Ride Management Controller
+ * متحكم إدارة الرحلات للمسؤولين (Admin Ride Management Controller)
+ * 
+ * الغرض من الملف:
+ * منح المسؤولين رؤية شاملة لجميع الرحلات التي تتم عبر المنصة.
+ * 
+ * كيفية العمل:
+ * 1. يعرض قائمة بجميع الرحلات مع تفاصيلها (الموقع، السعر، السائق، الراكب).
+ * 2. يسمح للمسؤول بمتابعة حالة الرحلات الحالية أو مراجعة الرحلات السابقة.
  */
 class RideManagementController extends Controller
 {

app/Http/Controllers/Admin/StatsController.php

@@ -11,6 +11,16 @@ use Illuminate\Support\Facades\DB;
  * Admin Stats Controller
  * Replaces: serviceapp/getRidesStatic.php, getPassengersStatic.php,
  * getEmployeeStatic.php, getdriverstotalMonthly.php, getEditorStatsCalls.php
+ *
+ * متحكم الإحصائيات (Stats Controller)
+ * 
+ * الغرض من الملف:
+ * توليد تقارير وإحصائيات حول أداء المنصة للمسؤولين.
+ * 
+ * كيفية العمل:
+ * 1. يحسب إجمالي عدد الرحلات، السائقين النشطين، والركاب.
+ * 2. يحلل البيانات المالية والنمو الشهري للسائقين.
+ * 3. يعرض ملخصاً سريعاً (Overview) لمؤشرات الأداء الرئيسية.
  */
 class StatsController extends Controller
 {