Initial V2 commit 4

app/Models/Driver.php

@@ -5,10 +5,16 @@ namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 
 /**
- * Driver Model (Primary DB)
+ * نموذج السائق (Driver Model)
  * 
- * Note: Primary key is `idn` (auto-increment), but the business ID is `id` (varchar).
- * All endpoints use `id` (varchar) for lookups, not `idn`.
+ * الغرض من الملف:
+ * إدارة بيانات السائقين (الكباتن) في النظام.
+ * 
+ * كيفية العمل:
+ * 1. يرتبط بجدول (driver) في قاعدة البيانات الأساسية (primary).
+ * 2. يحتوي على قائمة بالحقول المشفرة (ENCRYPTED_FIELDS) التي يتم تخزينها بشكل آمن وتحتاج لفك تشفير عند العرض.
+ * 3. يدير العلاقات الكثيرة للسائق مثل: السيارة، المستندات، التقييمات، الموقع الحالي، والصورة الشخصية.
+ * 4. يوفر دوال مساعدة مثل حساب متوسط التقييم (getAverageRating).
  */
 class Driver extends Model
 {