# تحديث Vehicle Verify — الإصدار v2

## خطوات النشر (بالترتيب)
1. **قاعدة البيانات**: من phpMyAdmin استورد `database/schema_admin_v2.sql`
   (بعد `schema.sql` و`schema_admin.sql`). آمن وقابل لإعادة التشغيل.
2. **الملفات**: ارفع الملفات مع الحفاظ على نفس المسارات (استبدال الموجود).
3. لا حاجة لأي إعداد إضافي.

## ما الجديد في هذا التحديث
1. **إضافة ضابط**: زر "👮 إضافة ضابط" في صفحة إدارة المستخدمين (admin/users.php).
2. **وثائق المالك الشخصية**: صفحة جديدة `وثائقي الشخصية` (owner/personal.php) لرفع رخصة السياقة وأي وثيقة شخصية (نطاق "سائق").
3. **عرض الوثائق**: زر 🔗 لفتح ملف الوثيقة في كل الصفحات (المالك، السائق، الإدارة، صفحة التحقق).
4. **تنبيه قبل انتهاء الصلاحية**: مدّة التنبيه تؤخذ من إعدادات المنصة (`expiry_warn_days`)، مع لوحة تنبيهات في لوحتي المالك والمدير.
5. **صفحة التحقق (QR)**: تعرض الآن أنواع وثائق السيارة ديناميكيًا + كل الوثائق الشخصية للسائق الحالي (رخصة السياقة وغيرها).
6. **بحث شامل للمدير**: صفحة `admin/search.php` للبحث بالاسم/البريد/الهاتف/لوحة السيارة، مع تحسين بحث صفحة السيارات.
7. **تحليلات المدير**: صفحة `admin/analytics.php` برسوم بيانية (Chart.js): المستخدمون حسب الدور، الوثائق حسب الحالة/النوع، التسجيلات والمداخيل الشهرية، المخالفات، أكثر المُلّاك سيارات.
8. **نقل الملكية**: 
   - الإدارة: زر 🔁 في `admin/vehicles.php`.
   - المالك: زر 🔁 في `owner/vehicles.php`.
   - عند النقل: يتغيّر المالك، يُلغى السائق الحالي والسائقون المرتبطون، **وتنتهي صلاحية كل وثائق السيارة تلقائيًا** لضمان عدم بقاء وثائق باسم المالك السابق. يُسجَّل كل نقل في `ownership_transfers` وسجل النشاطات.

## الملفات الجديدة
- `database/schema_admin_v2.sql`
- `app/Models/Transfer.php`
- `public/owner/personal.php`, `public/admin/search.php`, `public/admin/analytics.php`

## الملفات المعدّلة
- `config/app.php` (مدّة التنبيه من الإعدادات)
- `config/translations.php` (مفاتيح ع/إن/فر جديدة)
- `app/Views/shared/layout.php` (روابط القائمة)
- `app/Models/Document.php`, `Vehicle.php`, `Admin.php`
- `public/verify.php`, `owner/{documents,dashboard,vehicles}.php`, `driver/license.php`, `admin/{dashboard,users,vehicles}.php`

## ملاحظة خصوصية
ملفات الوثائق في `public/uploads/` يمكن فتحها بالرابط المباشر (أسماؤها عشوائية يصعب تخمينها). إن رغبت بحماية أقوى لاحقًا، يمكن إضافة سكربت وسيط يتحقق من الصلاحيات قبل عرض الملف.
