🚗 CarServ - نظام متكامل لخدمات السيارات

📋 نظرة عامة على المشروع

CarServ هو تطبيق متكامل لإدارة خدمات السيارات والصيانة، تم تطويره كمشروع تخرج باستخدام أحدث التقنيات. يوفر التطبيق منصة شاملة للعملاء لإدارة سياراتهم، حجز الخدمات، تتبع الصيانة، والحصول على مساعدة ذكية بدعم من الذكاء الاصطناعي.

🎯 الهدف من المشروع

توفير حل تقني متكامل يربط بين أصحاب السيارات ومقدمي خدمات الصيانة من خلال منصة رقمية سهلة الاستخدام، مع دعم الذكاء الاصطناعي لتقديم توصيات ذكية وصيانة استباقية.

---

🏗️ البنية التقنية للمشروع

المنصات والتقنيات المستخدمة

المنصة	التقنية	الوصف
تطبيق الموبايل	Flutter 3.9.2	التطبيق الرئيسي للعملاء (Android & iOS)
لوحة التحكم	Flutter	لوحة تحكم إدارية (Desktop/Web)
Backend	Firebase Suite	خدمات الخلفية الكاملة
AI Services	Python Flask	خدمات الذكاء الاصطناعي
State Management	flutter_bloc (BLoC Pattern)	إدارة الحالة في التطبيق
Navigation	go_router	التنقل بين الشاشات
Dependency Injection	get_it	حقن التبعيات

⚙️ خدمات Firebase المستخدمة

الخدمة	الاستخدام
Firebase Authentication	تسجيل الدخول والمصادقة
Cloud Firestore	قاعدة البيانات السحابية
Firebase Storage	تخزين الصور والملفات
Firebase Cloud Messaging (FCM)	الإشعارات الفورية
Cloud Functions	التنفيذ الخلفي للعمليات

---

🎨 المميزات الرئيسية للتطبيق

1️⃣ نظام المصادقة والأمان (Authentication System)

الوصف: نظام متكامل وآمن لتسجيل الدخول وإدارة الحسابات.

المميزات:

• ✅ تسجيل دخول آمن بالبريد الإلكتروني وكلمة المرور
• ✅ إنشاء حساب جديد مع التحقق من البيانات
• ✅ استرجاع كلمة المرور
• ✅ حفظ حالة تسجيل الدخول (Remember Me)
• ✅ تشفير البيانات الحساسة
• ✅ Firebase Authentication للأمان العالي

التقنيات المستخدمة:

- firebase_auth: ^6.1.1
- flutter_bloc: ^9.1.1
- shared_preferences: ^2.5.3

الملفات الرئيسية:

• lib/features/auth/presentation/view/login_view.dart
• lib/features/auth/presentation/view/signup_view.dart
• lib/features/auth/presentation/manager/login_cubit/
• lib/features/auth/presentation/manager/signup_cubit/

كيفية التنفيذ:

1. استخدام Firebase Authentication للتسجيل والدخول
2. تخزين بيانات المستخدم في Firestore تحت /users/{uid}
3. حفظ حالة تسجيل الدخول في SharedPreferences
4. استخدام BLoC Pattern لإدارة حالة المصادقة

---

2️⃣ إدارة السيارة (My Car Management)

الوصف: نظام شامل لإدارة معلومات السيارة مع ميزات تصور ثلاثي الأبعاد.

المميزات:

• ✅ إضافة وتعديل بيانات السيارة (العلامة، الموديل، السنة، اللون)
• ✅ عرض نموذج ثلاثي الأبعاد للسيارة (3D Model)
• ✅ تغيير لون السيارة بشكل تفاعلي
• ✅ حفظ صور السيارة
• ✅ تتبع الكيلومترات والمسافة المقطوعة
• ✅ معلومات الرقم التسلسلي (VIN)
• ✅ سجل الصيانة الكامل

التقنيات المستخدمة:

- model_viewer_plus: ^1.7.0  // للنماذج ثلاثية الأبعاد
- flutter_colorpicker: ^1.1.0  // لاختيار الألوان
- image_picker: ^1.1.2  // لرفع الصور
- firebase_storage: ^13.0.3  // لتخزين الصور

الملفات الرئيسية:

• lib/features/my_car/presentation/views/my_car_view.dart
• lib/features/my_car/presentation/views/add_edit_car_view.dart
• lib/features/my_car/presentation/views/car_3d_model_view.dart
• lib/features/my_car/presentation/manager/my_car_cubit/
• lib/features/my_car/presentation/manager/color_visualizer_cubit/
• lib/features/my_car/presentation/manager/model_3d_cubit/

كيفية التنفيذ:

1. استخدام Model Viewer Plus لعرض النماذج ثلاثية الأبعاد
2. تخزين بيانات السيارة في Firestore تحت /users/{uid}/cars/{carId}
3. استخدام Color Visualizer Cubit لتغيير الألوان بشكل تفاعلي
4. رفع الصور إلى Firebase Storage وحفظ الروابط

---

3️⃣ الخدمات والفئات (Services & Categories)

الوصف: عرض شامل لجميع خدمات الصيانة المتوفرة مع تصنيفات منظمة.

المميزات:

• ✅ عرض الخدمات الشائعة
• ✅ تصنيف الخدمات حسب الفئات
• ✅ البحث عن الخدمات
• ✅ تفاصيل كاملة لكل خدمة
• ✅ الأسعار والمدة المتوقعة
• ✅ تقييمات العملاء
• ✅ عروض وخصومات خاصة

الفئات الرئيسية:

• 🔧 صيانة دورية
• 🛠️ إصلاحات
• 🚗 غسيل وتنظيف
• ⚙️ قطع غيار
• 🔋 كهرباء
• 🎨 دهان وتجميل

التقنيات المستخدمة:

- cloud_firestore: ^6.0.3
- cached_network_image: ^3.4.1
- carousel_slider: ^5.1.1

الملفات الرئيسية:

• lib/features/services/presentation/views/all_services_view.dart
• lib/features/services/presentation/views/all_categories_view.dart
• lib/features/services/presentation/views/service_details_view.dart
• lib/features/services/presentation/views/category_services_view.dart
• lib/features/services/presentation/manager/services_cubit/

كيفية التنفيذ:

1. تخزين الخدمات والفئات في Firestore
2. استخدام Cached Network Image للأداء الأفضل
3. تطبيق Carousel Slider للعروض الخاصة
4. البحث باستخدام Firestore Queries

---

4️⃣ نظام الحجوزات (Bookings System)

الوصف: نظام متكامل لحجز وإدارة مواعيد الصيانة.

المميزات:

• ✅ حجز موعد صيانة جديد
• ✅ اختيار الخدمة والتاريخ والوقت
• ✅ تتبع حالة الحجز (قيد الانتظار، مؤكد، جاري التنفيذ، مكتمل، ملغي)
• ✅ عرض الحجوزات القادمة والسابقة
• ✅ إشعارات تذكيرية قبل الموعد
• ✅ تقييم الخدمة بعد الانتهاء
• ✅ تاريخ كامل للحجوزات

حالات الحجز:

• 🟡 Pending: قيد الانتظار
• 🟢 Confirmed: مؤكد
• 🔵 In Progress: جاري التنفيذ
• ✅ Completed: مكتمل
• ❌ Cancelled: ملغي

التقنيات المستخدمة:

- flutter_bloc: ^9.1.1
- cloud_firestore: ^6.0.3
- firebase_messaging (للإشعارات)

الملفات الرئيسية:

• lib/features/bookings/presentation/views/bookings_view.dart
• lib/features/bookings/presentation/views/add_booking_view.dart
• lib/features/bookings/presentation/manager/bookings_cubit/
• lib/features/bookings/presentation/manager/booking_actions_cubit/
• lib/features/bookings/presentation/manager/booking_rating_cubit/

كيفية التنفيذ:

1. تخزين الحجوزات في Firestore تحت /bookings/{bookingId}
2. استخدام StreamBuilder لتحديث البيانات في الوقت الفعلي
3. إرسال إشعارات FCM عند تغيير حالة الحجز
4. نظام تقييم باستخدام Rating Cubit

---

5️⃣ المساعدة الطارئة (Emergency Assistance)

الوصف: خدمة طوارئ للمساعدة الفورية عند تعطل السيارة.

المميزات:

• ✅ طلب مساعدة طارئة
• ✅ تحديد الموقع الجغرافي تلقائياً
• ✅ وصف المشكلة ورفع الصور
• ✅ تتبع حالة طلب المساعدة
• ✅ تقدير الوقت المتوقع للوصول
• ✅ سجل طلبات المساعدة السابقة

التقنيات المستخدمة:

- geolocator: ^12.0.0  // تحديد الموقع
- geocoding: ^3.0.0  // تحويل الإحداثيات لعنوان
- flutter_map: ^7.0.2  // عرض الخرائط
- latlong2: ^0.9.1  // التعامل مع الإحداثيات
- permission_handler: ^11.3.1  // طلب الأذونات

الملفات الرئيسية:

• lib/features/emergency_assistance/presentation/views/emergency_assistance_view.dart
• lib/features/emergency_assistance/presentation/manager/emergency_cubit/

كيفية التنفيذ:

1. استخدام Geolocator للحصول على الموقع الحالي
2. Geocoding لتحويل الإحداثيات إلى عنوان قابل للقراءة
3. حفظ طلب المساعدة في Firestore مع الموقع
4. إرسال إشعار فوري لمقدمي الخدمة

---

6️⃣ المساعد الافتراضي الذكي (AI ChatBot)

الوصف: مساعد ذكي يعمل بتقنيات الذكاء الاصطناعي لتقديم الدعم والإجابة على الأسئلة.

المميزات:

• ✅ دعم كامل للعربية والإنجليزية
• ✅ الإجابة على استفسارات الصيانة
• ✅ توصيات شخصية بناءً على بيانات السيارة
• ✅ تحليل سجل الصيانة السابق
• ✅ معلومات عن الحجوزات والخدمات
• ✅ محادثة سلسة ومستمرة
• ✅ متوفر 24/7

إمكانيات المساعد:

• 💬 الإجابة على الأسئلة حول الصيانة
• 📊 تحليل بيانات السيارة
• 🔔 تذكيرات بمواعيد الصيانة
• 💰 تقدير تكلفة الخدمات
• 🛠️ نصائح للعناية بالسيارة

التقنيات المستخدمة:

- NLP Engine للمحادثات الذكية
- Cloud Firestore لحفظ المحادثات
- Firebase Cloud Functions للربط مع AI

الملفات الرئيسية:

• lib/features/chat_bot/presentation/views/chat_bot_view.dart

كيفية التنفيذ:

1. إرسال رسالة المستخدم إلى Cloud Function
2. Cloud Function يستدعي AI Service (NLP)
3. AI Service يحلل السياق ويولد الرد
4. حفظ المحادثة في Firestore لاستمرارية السياق
5. عرض الرد في واجهة المحادثة

راجع: AI_INTEGRATION.md لتفاصيل أكثر عن نظام الذكاء الاصطناعي

---

7️⃣ الصيانة التنبؤية بالذكاء الاصطناعي (AI Predictive Maintenance)

الوصف: نظام ذكاء اصطناعي يتنبأ باحتياجات الصيانة قبل حدوث الأعطال.

المميزات:

• ✅ تحليل 19 معلمة مختلفة للسيارة
• ✅ التنبؤ بضرورة الصيانة
• ✅ نسبة دقة تصل إلى 95%+
• ✅ تقدير تكلفة الصيانة المتوقعة
• ✅ توصيات مخصصة لكل سيارة

المعلومات التي يتم تحليلها:

بيانات السيارة:

• العلامة التجارية والموديل
• السنة وعدد الكيلومترات
• حجم المحرك ونوع الوقود
• نوع ناقل الحركة

سجل الصيانة:

• عدد مرات الصيانة السابقة
• المشاكل المسجلة
• تاريخ الحوادث
• معدل الالتزام بالصيانة

حالة المكونات:

• حالة الإطارات
• حالة الفرامل
• حالة البطارية
• كفاءة استهلاك الوقود
• الأداء العام

نتائج التنبؤ:

• ✅ حالة السيارة: جيدة / تحتاج صيانة
• 📊 نسبة الثقة: 0-100%
• 💵 التكلفة المتوقعة: بالجنيه المصري
• 📋 التوصيات: خطوات العمل المطلوبة

التقنيات المستخدمة:

- Machine Learning Classification Model
- Python Flask API
- Cloud Functions للربط
- SharedPreferences للتخزين المحلي

كيفية التنفيذ:

1. جمع بيانات السيارة من التطبيق
2. إرسال البيانات إلى ML Model API
3. تحليل البيانات باستخدام نموذج تعلم الآلة
4. إرجاع النتيجة: (حالة، نسبة ثقة، تكلفة)
5. عرض النتيجة بشكل مرئي للمستخدم
6. حفظ النتيجة محلياً للوصول بدون إنترنت

راجع: AI_INTEGRATION.md لتفاصيل أكثر عن نظام الذكاء الاصطناعي

---

8️⃣ البحث المتقدم (Advanced Search)

الوصف: نظام بحث شامل للعثور على الخدمات والفئات بسهولة.

المميزات:

• ✅ بحث سريع ومباشر
• ✅ نتائج فورية أثناء الكتابة
• ✅ البحث في الخدمات والفئات
• ✅ حفظ عمليات البحث الأخيرة
• ✅ اقتراحات ذكية

التقنيات المستخدمة:

- flutter_bloc للبحث التفاعلي
- Firestore Queries للبحث في قاعدة البيانات

الملفات الرئيسية:

• lib/features/search/presentation/views/search_view.dart
• lib/features/search/presentation/manager/search_cubit/

---

9️⃣ الإشعارات (Notifications)

الوصف: نظام إشعارات شامل لإبقاء المستخدم على اطلاع.

أنواع الإشعارات:

• 🔔 تأكيد الحجوزات
• ⏰ تذكير بمواعيد الصيانة
• ✅ اكتمال الخدمة
• 📢 عروض وخصومات جديدة
• 🔄 تحديثات حالة الطلب
• 🆘 تحديثات المساعدة الطارئة

التقنيات المستخدمة:

- Firebase Cloud Messaging (FCM)
- Cloud Functions لإرسال الإشعارات

الملفات الرئيسية:

• lib/features/notifications/presentation/views/notifications_view.dart

كيفية التنفيذ:

1. حفظ FCM Token للمستخدم في Firestore
2. Firestore Trigger يطلق Cloud Function عند تغيير البيانات
3. Cloud Function يرسل إشعار FCM
4. التطبيق يستقبل ويعرض الإشعار

---

🔟 الملف الشخصي والإعدادات (Profile & Settings)

الوصف: إدارة كاملة للحساب والتفضيلات.

المميزات:

الملف الشخصي:

• ✅ عرض وتعديل البيانات الشخصية
• ✅ تغيير الصورة الشخصية
• ✅ تحديث رقم الهاتف
• ✅ تعديل العنوان

الإعدادات:

• 🌐 تغيير اللغة (عربي/English)
• 🌙 الوضع الليلي/النهاري (Dark/Light Mode)
• 🔔 إعدادات الإشعارات
• 🔒 تغيير كلمة المرور
• 📧 تغيير البريد الإلكتروني
• 🚪 تسجيل الخروج

التقنيات المستخدمة:

- provider للثيم واللغة
- shared_preferences لحفظ التفضيلات

الملفات الرئيسية:

• lib/features/menu/presentation/views/menu_view.dart
• lib/features/menu/presentation/views/edit_profile/edit_profile_view.dart
• lib/features/menu/presentation/views/settings/languages_settings_view.dart
• lib/features/menu/presentation/views/change_credentials/change_email_view.dart
• lib/features/menu/presentation/views/change_credentials/change_password_view.dart
• lib/core/providers/language_provider.dart
• lib/core/providers/theme_provider.dart

---

1️⃣1️⃣ شاشة البداية (Onboarding)

الوصف: شاشات تعريفية للمستخدمين الجدد.

المميزات:

• ✅ عرض مميزات التطبيق
• ✅ شرح مبسط للاستخدام
• ✅ تصميم جذاب وتفاعلي
• ✅ إمكانية التخطي

الملفات الرئيسية:

• lib/features/onboarding/presentation/views/onboarding_view.dart

---

🌍 نظام الترجمة (Localization)

الوصف: دعم كامل للغتين العربية والإنجليزية مع حفظ تلقائي للاختيار.

المميزات:

• ✅ 223 مفتاح ترجمة
• ✅ 39 شاشة محدثة
• ✅ دعم كامل للعربية (RTL)
• ✅ دعم كامل للإنجليزية (LTR)
• ✅ حفظ تلقائي لاختيار اللغة
• ✅ تبديل فوري بين اللغات
• ✅ اللغة الافتراضية: العربية

التقنيات المستخدمة:

- flutter_localizations (من SDK)
- intl package
- provider للإدارة
- shared_preferences للحفظ

الملفات:

• lib/l10n/intl_ar.arb - الترجمة العربية
• lib/l10n/intl_en.arb - الترجمة الإنجليزية
• lib/generated/l10n.dart - الملف المولد
• lib/core/providers/language_provider.dart

كيفية الاستخدام:

import 'package:doortodoornew/generated/l10n.dart';

Text(S.of(context)!.loginButton)  // يعرض "تسجيل الدخول" أو "LOGIN"

راجع: LOCALIZATION_GUIDE.md لتفاصيل أكثر عن نظام الترجمة

🗂️ هيكل المشروع (Project Structure)

المشروع يتبع Clean Architecture مع تقسيم الميزات:

lib/
├── main.dart                          # نقطة البداية
├── car_serv_app.dart                  # تكوين التطبيق
│
├── core/                              # الوظائف المشتركة
│   ├── di/                            # Dependency Injection
│   │   └── get_it.dart
│   ├── routes/                        # التنقل
│   │   ├── app_router.dart
│   │   └── routes.dart
│   ├── themes/                        # السمات
│   ├── utils/                         # وظائف مساعدة
│   ├── widgets/                       # ويدجتات مشتركة
│   ├── providers/                     # State Providers
│   │   ├── language_provider.dart
│   │   └── theme_provider.dart
│   └── errors/                        # معالجة الأخطاء
│
├── features/                          # الميزات الرئيسية
│   ├── auth/                          # المصادقة
│   │   ├── data/
│   │   │   ├── models/
│   │   │   └── repositories/
│   │   ├── domain/
│   │   │   └── entities/
│   │   └── presentation/
│   │       ├── views/
│   │       ├── widgets/
│   │       └── manager/
│   │           ├── login_cubit/
│   │           └── signup_cubit/
│   │
│   ├── home/                          # الرئيسية
│   ├── my_car/                        # سيارتي
│   │   └── manager/
│   │       ├── my_car_cubit/
│   │       ├── color_visualizer_cubit/
│   │       └── model_3d_cubit/
│   ├── bookings/                      # الحجوزات
│   │   └── manager/
│   │       ├── bookings_cubit/
│   │       ├── booking_actions_cubit/
│   │       └── booking_rating_cubit/
│   ├── services/                      # الخدمات
│   ├── emergency_assistance/          # المساعدة الطارئة
│   ├── chat_bot/                      # المساعد الذكي
│   ├── search/                        # البحث
│   ├── notifications/                 # الإشعارات
│   ├── menu/                          # القائمة والإعدادات
│   └── onboarding/                    # شاشة البداية
│
├── l10n/                              # ملفات الترجمة
│   ├── intl_ar.arb
│   └── intl_en.arb
│
├── generated/                         # ملفات مولدة تلقائياً
│   ├── l10n.dart
│   ├── l10n_ar.dart
│   └── l10n_en.dart
│
└── firebase_options.dart              # إعدادات Firebase

كل ميزة (Feature) تحتوي على:

• data/ - النماذج والمستودعات
• domain/ - الكيانات والحالات
• presentation/ - الشاشات والويدجتات والمدراء

---

📦 المكتبات والحزم المستخدمة

الأساسية (Core)

flutter:
  sdk: flutter
flutter_localizations:
  sdk: flutter

# State Management & Architecture
flutter_bloc: ^9.1.1           # إدارة الحالة
get_it: ^8.2.0                 # حقن التبعيات
provider: ^6.1.2               # Provider للإعدادات
equatable: ^2.0.7              # مقارنة الكائنات
dartz: ^0.10.1                 # البرمجة الوظيفية

Firebase

firebase_core: ^4.2.0          # Firebase الأساسي
firebase_auth: ^6.1.1          # المصادقة
cloud_firestore: ^6.0.3        # قاعدة البيانات
firebase_storage: ^13.0.3      # تخزين الملفات

UI/UX

go_router: ^16.2.5             # التنقل
animated_text_kit: ^4.3.0      # النصوص المتحركة
flutter_spinkit: ^5.2.2        # مؤشرات التحميل
carousel_slider: ^5.1.1        # السلايدرات
skeletonizer: ^2.0.0           # تأثير التحميل
flutter_switch: ^0.3.2         # المفاتيح
flutter_colorpicker: ^1.1.0    # اختيار الألوان
font_awesome_flutter: ^10.12.0 # أيقونات

Functionality

# Images & Media
image_picker: ^1.1.2           # اختيار الصور
cached_network_image: ^3.4.1   # تخزين الصور مؤقتاً
flutter_cache_manager: ^3.4.1  # إدارة الكاش

# Maps & Location
flutter_map: ^7.0.2            # الخرائط
geolocator: ^12.0.0            # تحديد الموقع
geocoding: ^3.0.0              # تحويل الإحداثيات
latlong2: ^0.9.1               # التعامل مع الإحداثيات
permission_handler: ^11.3.1    # الأذونات

# 3D Models
model_viewer_plus: ^1.7.0      # النماذج ثلاثية الأبعاد
webview_flutter: ^4.4.0        # عرض الويب
vector_math: ^2.1.4            # حسابات الأبعاد

# Data & Storage
hive: ^2.2.3                   # قاعدة بيانات محلية
hive_flutter: ^1.1.0           # Hive لـ Flutter
shared_preferences: ^2.5.3     # التخزين المحلي

# Network
dio: ^5.7.0                    # طلبات HTTP
connectivity_plus: ^7.0.0      # التحقق من الإنترنت

# Utilities
intl: any                      # التدويل

Dev Dependencies

flutter_lints: ^5.0.0          # قواعد الكود
build_runner: ^2.4.13          # توليد الكود
hive_generator: ^2.0.1         # توليد Hive
flutter_launcher_icons: ^0.14.4  # أيقونة التطبيق
flutter_native_splash: ^2.4.7    # شاشة البداية

---

🔐 الأمان والخصوصية

الأمان

• ✅ Firebase Authentication للمصادقة الآمنة
• ✅ تشفير البيانات الحساسة
• ✅ HTTPS فقط للاتصالات
• ✅ Firebase Security Rules
• ✅ التحقق من صلاحيات المستخدم

الخصوصية

• ✅ GDPR Compliant
• ✅ بيانات المستخدم محمية
• ✅ لا يتم مشاركة البيانات مع أطراف ثالثة
• ✅ حق المستخدم في حذف بياناته
• ✅ بيانات AI لا يتم تخزينها خارجياً

---

🚀 كيفية تشغيل المشروع

المتطلبات الأساسية

- Flutter SDK 3.9.2 أو أحدث
- Dart 3.x
- Android Studio / VS Code
- Firebase Account
- Git

الخطوات

1. استنساخ المشروع

git clone <repository-url>
cd CarServ

2. تثبيت الحزم

flutter pub get

3. إعداد Firebase

• إنشاء مشروع Firebase
• إضافة تطبيقات Android & iOS
• تحميل ملفات الإعداد:
  • google-services.json → android/app/
  • GoogleService-Info.plist → ios/Runner/

4. توليد ملفات الترجمة

flutter gen-l10n

5. توليد كود Hive (إن لزم)

flutter pub run build_runner build

6. تشغيل التطبيق

flutter run

7. بناء APK للإنتاج

flutter build apk --release

8. بناء App Bundle

flutter build appbundle --release

---

🧪 الاختبار

اختبار المميزات الرئيسية

1. المصادقة

• تسجيل الدخول بحساب موجود ✅
• إنشاء حساب جديد ✅
• تسجيل الخروج ✅

2. إدارة السيارة

• إضافة سيارة جديدة ✅
• عرض نموذج 3D ✅
• تغيير اللون ✅

3. الحجوزات

• حجز موعد جديد ✅
• عرض الحجوزات ✅
• تقييم الخدمة ✅

4. AI Features

• اختبار المساعد الذكي ✅
• اختبار الصيانة التنبؤية ✅

5. اللغات

• التبديل بين العربية والإنجليزية ✅
• حفظ اختيار اللغة ✅

---

📊 قاعدة البيانات (Firestore Structure)

Firestore/
│
├── users/                              # المستخدمين
│   └── {userId}/
│       ├── name: String
│       ├── email: String
│       ├── phone: String
│       ├── photoUrl: String
│       ├── createdAt: Timestamp
│       └── cars/                       # السيارات
│           └── {carId}/
│               ├── make: String
│               ├── model: String
│               ├── year: int
│               ├── color: String
│               ├── mileage: int
│               ├── plateNumber: String
│               └── photoUrl: String
│
├── services/                           # الخدمات
│   └── {serviceId}/
│       ├── name: String (ar/en)
│       ├── categoryId: String
│       ├── description: String (ar/en)
│       ├── price: double
│       ├── duration: int
│       ├── imageUrl: String
│       └── rating: double
│
├── categories/                         # الفئات
│   └── {categoryId}/
│       ├── name: String (ar/en)
│       ├── icon: String
│       └── order: int
│
├── bookings/                           # الحجوزات
│   └── {bookingId}/
│       ├── userId: String
│       ├── carId: String
│       ├── serviceId: String
│       ├── status: String
│       ├── scheduledDate: Timestamp
│       ├── notes: String
│       ├── rating: int?
│       ├── review: String?
│       └── createdAt: Timestamp
│
├── emergencyRequests/                  # طلبات الطوارئ
│   └── {requestId}/
│       ├── userId: String
│       ├── location: GeoPoint
│       ├── address: String
│       ├── description: String
│       ├── photos: Array<String>
│       ├── status: String
│       └── createdAt: Timestamp
│
├── notifications/                      # الإشعارات
│   └── {userId}/
│       └── {notificationId}/
│           ├── title: String
│           ├── body: String
│           ├── type: String
│           ├── read: boolean
│           └── createdAt: Timestamp
│
└── chatMessages/                       # رسائل المساعد
    └── {userId}/
        └── {messageId}/
            ├── text: String
            ├── isUser: boolean
            └── timestamp: Timestamp

---

🎯 التحديات والحلول

التحدي 1: دمج النماذج ثلاثية الأبعاد

المشكلة: صعوبة عرض نماذج 3D في Flutter الحل: استخدام model_viewer_plus مع webview_flutter

التحدي 2: الصيانة التنبؤية

المشكلة: تطبيق نموذج ML معقد الحل: صنع API منفصلة بـ Python Flask وربطها عبر HTTP

التحدي 3: Real-time Updates

المشكلة: تحديث البيانات في الوقت الفعلي الحل: استخدام Firestore StreamBuilder مع BLoC

التحدي 4: دعم اللغتين

المشكلة: إدارة الترجمات في 39 شاشة الحل: نظام flutter_localizations مع Provider

التحدي 5: تحديد الموقع

المشكلة: الحصول على الموقع الدقيق الحل: geolocator + permission_handler + معالجة الأخطاء

---

🔮 التطويرات المستقبلية

قصيرة المدى

• إضافة وضع الدفع الإلكتروني
• دعم لغات إضافية
• تطبيق iOS
• تحسين أداء AI

متوسطة المدى

• تطبيق للفنيين
• نظام ولاء ونقاط
• دردشة مباشرة مع الدعم
• التكامل مع أنظمة الدفع

طويلة المدى

• توسيع لخدمات أخرى
• API عامة للمطورين
• تطبيق سطح المكتب
• نظام حجز ذكي بالكامل

---

👥 الفريق

مشروع تخرج - Delta Team

المسؤوليات

• 📱 Flutter Development: تطوير التطبيق
• 🎨 UI/UX Design: تصميم الواجهات
• 🔥 Firebase Backend: إعداد الخلفية
• 🤖 AI Integration: دمج الذكاء الاصطناعي
• 📊 Data Management: إدارة البيانات
• 🧪 Testing & QA: الاختبار والجودة

---

📄 التراخيص والمراجع

الحزم المستخدمة

جميع الحزم المستخدمة مفتوحة المصدر ومرخصة بـ:

• MIT License
• BSD License
• Apache 2.0 License

المراجع التقنية

• Flutter Documentation
• Firebase Documentation
• BLoC Pattern
• Clean Architecture

---

📞 الدعم والتواصل

للاستفسارات التقنية

• 📧 Email: [project-email]
• 💬 GitHub Issues

الملفات المرجعية

• AI_INTEGRATION.md - تفاصيل الذكاء الاصطناعي
• LOCALIZATION_GUIDE.md - دليل نظام الترجمة
• README.md - دليل المطورين (English)

---

🎓 ملاحظات مشروع التخرج

النقاط الرئيسية

1. التكامل الكامل: التطبيق يدمج بين عدة تقنيات حديثة
2. الذكاء الاصطناعي: استخدام ML للصيانة التنبؤية
3. Clean Architecture: بنية معمارية نظيفة وقابلة للتوسع
4. UX ممتاز: تجربة مستخدم سلسة وجذابة
5. Scalability: قابل للتوسع والتطوير

الإنجازات التقنية

• ✅ 11+ ميزة رئيسية
• ✅ 223 مفتاح ترجمة
• ✅ 39+ شاشة
• ✅ دعم كامل للذكاء الاصطناعي
• ✅ نماذج ثلاثية الأبعاد
• ✅ خرائط وتحديد المواقع
• ✅ نظام إشعارات متكامل
• ✅ BLoC Pattern في كل المشروع

---