Initial V2 commit 4

routes/api.php

@@ -1,5 +1,19 @@
 <?php
 
+/**
+ * ملف مسارات الـ API (API Routes)
+ * 
+ * الغرض من الملف:
+ * تعريف جميع "العناوين" (Endpoints) التي يمكن للتطبيقات (راكب، سائق، لوحة تحكم) التواصل معها.
+ * يعمل كخريطة تدل النظام على أي "Controller" يجب استدعاؤه لكل طلب.
+ * 
+ * كيفية العمل:
+ * 1. المسارات العامة (Public): مثل تسجيل الدخول وإنشاء الحساب، لا تحتاج لتشفير مسبق.
+ * 2. المسارات المحمية (Protected): تتطلب وجود رمز التحقق (JWT) وتوقيع (HMAC) لضمان الأمان.
+ * 3. المسارات مقسمة لمجموعات (Prefixes) مثل /v2/auth و /v2/rides لتسهيل التنظيم.
+ * 4. يستخدم الوسيط (Middleware) للتحقق من هوية المستخدم وصلاحياته قبل تنفيذ الطلب.
+ */
+
 use Illuminate\Support\Facades\Route;
 use App\Http\Controllers\AuthController;
 use App\Http\Controllers\RideController;