Initial V2 commit 4

app/Http/Controllers/RideController.php

@@ -16,10 +16,16 @@ use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\DB;
 
 /**
- * Ride Controller
+ * متحكم الرحلات (Ride Controller)
  * 
- * Handles the complete ride lifecycle:
- * create → search drivers → accept → arrive → start → finish/cancel
+ * الغرض من الملف:
+ * إدارة دورة حياة الرحلة بالكامل؛ بدءاً من طلب الراكب للرحلة حتى وصوله ودفعه للأجرة.
+ * 
+ * كيفية العمل:
+ * 1. يستقبل طلبات الرحلات الجديدة ويحفظها في جدول (waitingRides).
+ * 2. يسمح للسائقين بقبول الرحلات المتاحة وتحديث حالتهم.
+ * 3. يدير حالات الرحلة المختلفة: (انتظار، قبول، وصول السائق، بدء الرحلة، انتهاء الرحلة).
+ * 4. يرسل إشعارات فورية للركاب والسائقين عند أي تغيير في حالة الرحلة.
  */
 class RideController extends Controller
 {