# تقرير شامل لمنصة سيرو (Siro) — ملف استثماري متكامل

## فهرس المحتويات
1. [نظرة عامة عن المنصة](#1-نظرة-عامة-عن-المنصة)
2. [التطبيقات الأربعة](#2-التطبيقات-الأربعة)
3. [بوت الأندرويد — فحص الأسعار والدفع](#3-بوت-الأندرويد--فحص-الأسعار-والدفع)
4. [السوشيال بوت — الاستخبارات التسويقية](#4-السوشيال-بوت--الاستخبارات-التسويقية)
5. [نظام الماركتنج المتكامل](#5-نظام-الماركتنج-المتكامل)
6. [نظام المكافآت والتلعيب (Gamification)](#6-نظام-المكافآت-والتلعيب-gamification)
7. [نظام الإحالة (Referral System)](#7-نظام-الإحالة-referral-system)
8. [نظام إعادة تفعيل الخاملين](#8-نظام-إعادة-تفعيل-الخاملين)
9. [نظام العمولات الذكي (Kazan)](#9-نظام-العمولات-الذكي-kazan)
10. [لوحة الإدارة الشاملة (Admin)](#10-لوحة-الإدارة-الشاملة-admin)
11. [تطبيق الخدمة الميدانية (Service)](#11-تطبيق-الخدمة-الميدانية-service)
12. [تطبيق السائق (Driver)](#12-تطبيق-السائق-driver)
13. [تطبيق الراكب (Rider)](#13-تطبيق-الراكب-rider)
14. [جاهزية النظام لثلاث دول](#14-جاهزية-النظام-لثلاث-دول)
15. [الملخص التنفيذي للمستثمر](#15-الملخص-التنفيذي-للمستثمر)

---

## 1. نظرة عامة عن المنصة

**سيرو (Siro)** هي منصة نقل ذكي متكاملة (Ride-Hailing Ecosystem) تغطي **3 دول**: **سوريا، الأردن، مصر**. تعمل المنصة من خلال **4 تطبيقات رئيسية** (Rider, Driver, Admin, Service) مدعومة بـ **بوتين آليين** (Android Bot + Social Bot) ونظام **Marketing Engine** متكامل.

### الإحصائيات الأساسية
| البيان | القيمة |
|--------|--------|
| الدول | سوريا، الأردن، مصر |
| التطبيقات | 4 (راكب + سائق + إدارة + خدمة) |
| البوتات الآلية | 2 (أندرويد + سوشيال) |
| أنواع المركبات | 12 نوعاً |
| طرق الدفع | 7 طرق |
| لغات الواجهة | العربية والإنكليزية |
| حالة النظام | مباشر (Live) في سوريا والأردن، قيد التشغيل في مصر |

---

## 2. التطبيقات الأربعة

### 2.1 تطبيق الراكب (Siro Rider)
- **التقنية**: Flutter (Dart) — متوفر على Android, iOS, Web
- **الوصف**: تطبيق طلب الرحلات الرئيسي للمستخدمين

**الميزات الكاملة:**
- **طلب رحلة ذكي**: اختيار الوجهة، عرض السعر التقديري، اختيار نوع المركبة (Speed, Comfort, Family, Delivery, Blash, Late, Heavy, Nature, Electric, Pink Bike, Van, Female Driver)
- **خرائط حية**: تتبع السائق المباشر على الخريطة مع تحديث الموقع كل 3-5 ثوانٍ
- **تسعير ديناميكي**: عرض السعر قبل الطلب مع تفصيل التكلفة
- **تقييم السائق**: نجوم + تعليق بعد كل رحلة
- **محفظة إلكترونية**: شحن رصيد، دفع للرحلات، استرداد، سجل المعاملات
- **أكواد خصم**: إدخال وتفعيل العروض الترويجية
- **نظام الإحالة**: دعوة الأصدقاء ومكافآت
- **المفضلة**: حفظ الأماكن المفضلة للوصول السريع
- **سجل الرحلات**: عرض تاريخ الرحلات كامل مع التفاصيل
- **دعم فني**: محادثة وتذاكر دعم
- **إشعارات FCM**: إشعارات لحظية عبر Firebase
- **الاشتراك في الإشعارات**: إدارة تفضيلات الإشعارات
- **تعدد اللغات**: عربي وإنكليزي
- **دخول اجتماعي**: Google Sign-In, Apple Sign-In
- **بصمة جهاز**: ربط الحساب بالجهاز لأمان إضافي
- **SOS**: زر طوارئ مع إرسال الموقع الحي
- **Geofencing**: خدمات تعتمد على الموقع الجغرافي

### 2.2 تطبيق السائق (Siro Driver)
- **التقنية**: Flutter (Dart) — Android, iOS, Web
- **الوصف**: منصة السائقين المحترفين

**الميزات الكاملة:**
- **عروض الرحلات عبر التراكب (Android Overlay)**: تظهر فوق أي تطبيق حتى لو كان الهاتف مقفلاً
- **استقبال الطلبات**: عرض تفاصيل الرحلة (المسافة، السعر، الوجهة) مع مؤقت 15 ثانية للقبول
- **خدمة خلفية دائمة (Foreground Service)**: تحديث موقع 24/7
- **ملاحة صوتية (TTS)**: إرشادات خطوة بخطوة مع توجيه تلقائي
- **إحصائيات الأرباح**: أرباح يومية، أسبوعية، شهرية مع رسوم بيانية
- **نظام العمولات (Kazan)**: معرفة العمولة قبل قبول الرحلة
- **المحفظة**: رصيد السائق، سحب أرباح، سجل المعاملات
- **نظام التقييم**: تقييم الركاب، التقييم المزدوج
- **البقشيش (Tips)**: استلام بقشيش بعد الرحلة
- **تحديد حالة السائق**: متصل/غير متصل، تغيير الحالة تلقائي
- **إدارة الرحلات**: قبول، رفض، إلغاء مع أسباب
- **الدردشة مع الراكب**: بدون مشاركة الأرقام
- **تسجيل الدخول**: JWT + بصمة جهاز + Firebase Auth
- **مراقبة السلوك**: Score سلوك القيادة (سرعة، فرامل،...)
- **Gamification**: نقاط، مستويات، إنجازات، تحديات
- **المتجر/الاشتراكات**: عروض حصرية للسائقين
- **CarPlay**: دمج مع Apple CarPlay
- **مساعدة SOS**: زر طوارئ + مكالمة فيديو عبر Agora
- **تسجيل صوتي**: إرسال تسجيلات صوتية للدعم
- **صفحة تعريفية**: بروفايل كامل مع إحصائيات

### 2.3 لوحة الإدارة (Siro Admin)
- **التقنية**: Flutter Web (PWA) — متوفر على Web, Android, iOS
- **الوصف**: لوحة تحكم إدارية شاملة

**الميزات الكاملة:**

| الوحدة | الوصف |
|--------|-------|
| **لوحة المعلومات (Dashboard)** | إحصائيات فورية مع رسوم بيانية — عدد الرحلات، الإيرادات، المستخدمين النشطين، أداء السائقين |
| **إدارة الكباتن** | قائمة بجميع السائقين، قبول/رفض التسجيلات، توثيق المستندات، حظر/فك حظر، مراجعة ملفات السائقين |
| **إدارة الركاب** | تفاصيل الركاب، سجل الرحلات، عمليات الحظر، الإشعارات المستهدفة |
| **إدارة الرحلات** | تتبع الرحلات المباشرة، سجل الرحلات الكامل، البحث المتقدم، تفاصيل كل رحلة |
| **الإدارة المالية** | تقارير الأرباح، تقارير العمولات، التسويات المالية، سجل المدفوعات |
| **التحليلات المتقدمة** | مؤشرات الأداء (KPIs)، تقارير شهرية/سنوية، رسوم بيانية تفاعلية |
| **إدارة العمولات (Kazan)** | تحرير نسب العمولات لكل دولة وكل نوع مركبة، نماذج تسعير |
| **العروض الترويجية** | إنشاء وإدارة أكواد الخصم (نسبة مئوية/قيمة ثابتة)، تفعيل/تعطيل |
| **إدارة الموظفين** | صلاحيات الأدوار، إدارة حسابات الموظفين، سجل النشاطات |
| **مراقبة الجودة** | بطاقات أداء السائقين، تقييمات، قوائم سوداء |
| **الأمان والرقابة** | سجلات التدقيق (Audit Logs)، محاولات الدخول، كشف الاحتيال |
| **مراقبة الخوادم** | حالة الخوادم، الأداء، وقت التشغيل، استهلاك الموارد |
| **إدارة الفواتير** | إنشاء وطباعة الفواتير، تقارير ضريبية |
| **الماركتنج** | تحليل أسعار المنافسين، اكتشاف الحالات الشاذة، تشغيل/إيقاف الـ Autopilot، What-If Simulator |
| **نظام الإحالة** | تقارير الإحالات، المكافآت، تتبع الـ Links |
| **الشكاوى** | نظام تذاكر دعم متكامل |
| **إدارة البنوك** | إعدادات الحسابات البنكية للسحب |
| **السيرفر والمراقبة** | إدارة الخوادم، مراقبة الـ APIs |
| **قاعدة المعرفة** | توثيق النظام وإعداداته |
| **الإشعارات** | إرسال إشعارات مستهدفة لجميع المستخدمين أو فئات محددة |
| **التطبيقات (Apps)** | إدارة إصدارات التطبيقات |

### 2.4 تطبيق الخدمة الميدانية (Siro Service)
- **التقنية**: Flutter (Dart) — Android, iOS
- **الوصف**: تطبيق مخصص لموظفي الخدمة الميدانية لتسجيل وتوثيق السائقين الجدد

**الميزات الكاملة:**
- **تسجيل سائق جديد**: إدخال بيانات السائق (الاسم، الرقم، البريد،...)
- **تصوير المستندات**: تصوير الهوية، رخصة القيادة، أوراق السيارة مباشرة من الكاميرا
- **استخراج بيانات بالذكاء الاصطناعي**: Azure OCR + OpenAI GPT + Llama AI تستخرج البيانات تلقائياً من صور المستندات
- **التحقق الميداني**: فحص السيارة (موديل، لون، لوحة)
- **رفع صور السيارة**: واجهة، خلف، داخلية، المحرك
- **تحديد موقع التسجيل**: الموقع الجغرافي للتسجيل
- **تحديث بيانات السائق**: تعديل بيانات السائق الحالي
- **تحديث حالة السائق إلى نشط**: تفعيل السائق بعد الموافقة
- **ربط سيارة بسائق**: إضافة سيارة جديدة لحساب السائق
- **إدارة السائقين**: عرض معلومات السائقين، بحث، تصفية
- **دعم متعدد اللغات**: عربي وإنكليزي
- **أمان**: JWT + بصمة جهاز
- **البحث عن سائق**: بالرقم، الاسم، رقم الهاتف
- **متوفر على iOS و Android**

---

## 3. بوت الأندرويد — فحص الأسعار والدفع

### android_bot
- **التقنية**: Android (Kotlin + Jetpack Compose)
- **الوصف**: تطبيق أندرويد آلي يستخدم Accessibility Services لأتمتة تطبيقات النقل المنافسة

### آلية العمل:
1. البوت يشتغل كـ **Accessibility Service** في خلفية جهاز الأندرويد
2. كل 5 ثوانٍ يتصل بالـ Backend (`standalone_worker.php`) لجلب مهمة جديدة
3. ينفذ المهمة عبر محاكاة التفاعل البشري (نقر، كتابة، سحب)
4. يرسل النتائج إلى الخادم بتوقيع HMAC-SHA256

### التطبيقات المنافسة التي يدعمها:
| التطبيق | اسم الحزمة |
|---------|------------|
| **YallaGo** | com.yallago.app |
| **Zakinn** | com.zakinn.app |
| **Tfadal (bis.taxi)** | bis.taxi |
| **Careem** | com.careem |
| **Uber** | com.ubercab |
| **TaxiF** | com.taxif.app |
| **Jeeny** | com.jeeny.app |

### أنواع المهام:
- **get_price**: يدخل موقع الانطلاق والوصول في تطبيق المنافس ويسحب السعر المعروض
- **check_promos**: يفحص العروض الترويجية المتاحة في التطبيقات المنافسة
- **scrape_nearby_drivers**: يحصي عدد السائقين القريبين (تقديري)

### الاستخدامات:
- **تسعير تنافسي ذكي**: مقارنة أسعار المنافسين في الزمن الحقيقي
- **تحليل استراتيجي**: فهم تحركات أسعار المنافسين في أوقات الذروة
- **تغذية AI Pricing**: إدخال بيانات المنافسين لمحرك الذكاء الاصطناعي للتسعير التلقائي (cron_ai_engine.php)
- **تقارير Marketing**: تزويد نظام الماركتنج بفجوات الأسعار للاستغلال التسويقي
- **الحالات الشاذة**: اكتشاف متى يخفض المنافس أسعاره بشكل غير طبيعي

### الأمان:
- توثيق الطلبات عبر **HMAC-SHA256** مع مفتاح سري خاص بالجهاز
- Android ID كمعرف فريد للجهاز
- تشفير الاتصالات

---

## 4. السوشيال بوت — الاستخبارات التسويقية

### socialBot
- **التقنية**: Android (Kotlin, Accessibility Service)
- **الوصف**: بوت تسويقي اجتماعي ذكي يدير حسابات على منصات التواصل الاجتماعي بشكل آلي

### المنصات المدعومة:

#### 4.1 فيسبوك (Facebook)
| المكون | الوظيفة |
|--------|---------|
| **FacebookBotService.kt** | خدمة Accessibility الرئيسية — تستقبل المهام وتنفذها على تطبيق فيسبوك |
| **FacebookNavigator.kt** | تفتح التطبيق، تتنقل بين Home/Groups، تسحب، تبحث |
| **FacebookCommentReader.kt** | تقرأ التعليقات من المنشورات، توسع "عرض المزيد"، تستخرج النصوص، تصفي ضوضاء الواجهة |
| **FacebookCommentPoster.kt** | تكتب وتنشر التعليقات المُنشأة بالذكاء الاصطناعي |

#### 4.2 إنستغرام (Instagram)
| المكون | الوظيفة |
|--------|---------|
| **InstagramBotService.kt** | خدمة Accessibility — تنفذ مهام على إنستغرام |
| **InstagramNavigator.kt** | تفتح التطبيق، تسحب الفيد، تبحث، تعلق |

#### 4.3 تيليغرام (Telegram)
| المكون | الوظيفة |
|--------|---------|
| **TelegramBotService.kt** | خدمة Accessibility — تصفح القنوات، استخراج النصوص |
| **TelegramNavigator.kt** | تفتح القنوات عبر Deep Links، تسحب للخلف (لمشاهدة المنشورات الأقدم) |

### أنواع المهام:
| نوع المهمة | الوصف |
|------------|-------|
| `post_comment` | نشر تعليق مُنشأ بالذكاء الاصطناعي على منشور معين |
| `read_posts` | قراءة المنشورات من صفحة/مجموعة وجمعها |
| `autonomous_scroll_and_reply` | تصفح الفيد تلقائياً وقراءة المحتوى والرد على الاستفسارات |
| `join_group` | الانضمام إلى مجموعة فيسبوك |

### النظام الخلفي (Marketing Engine):
- **schedule_manager.php**: يحدد المهام وينظمها مع مراعاة أوقات الهدوء (Quiet Hours)
- **account_manager.php**: يدير الحسابات بالتناوب (Cooldown-based selection) لتجنب الحظر
- **gemini_comment_generator.php**: يُنشئ تعليقات طبيعية عبر Gemini AI ← ينشر محتوى ترويجي لسيرو أو يجيب على أسئلة
- **insert_autonomous_task.php**: يضيف مهام تصفح ورد تلقائي
- **cron_weekly_report.php**: يُصدر تقرير أسبوعي للاستخبارات التسويقية عبر Gemini AI

### الاستخدامات الاستراتيجية:
- **استخبارات السوق (Market Intelligence)**: قراءة منشورات ومجموعات النقل لفهم احتياجات السوق ومشاكل السائقين
- **الدعاية الموجهة**: نشر تعليقات ترويجية ذكية عن سيرو في المجموعات ذات الصلة
- **توجيه الجمهور**: الرد على استفسارات الناس وتوجيههم نحو تطبيق سيرو
- **مراقبة المنافسين**: تتبع نشاط المنافسين على وسائل التواصل
- **إدارة السمعة**: الرد على الشكاوى والتعليقات السلبية بشكل آلي وذكي

### مكافحة التكرار:
- **SeenPostDatabase**: قاعدة SQLite محلية تخزن SHA-256 هاش للمنشورات التي تمت مشاهدتها لمنع إعادة معالجة نفس المحتوى

---

## 5. نظام الماركتنج المتكامل

### 5.1 Marketing Engine (المحرك التسويقي)
**المكان**: `backend/marketing_engine/`

| المكون | الوظيفة |
|--------|---------|
| **index.php** | الـ API الرئيسي — توزيع المهام، التقييم عبر Gemini، التقارير |
| **schema.sql** | قاعدة بيانات الماركتنج — `social_accounts`, `social_tasks`, `social_logs`, `content_pipeline`, `api_quotas`, `marketing_reports` |
| **social_worker.php** | نقطة نهاية لبوت السوشيال ميديا للأندرويد |
| **schedule_manager.php** | جدولة المهام مع أوقات هدوء وتوليد تعليقات Gemini |
| **account_manager.php** | إدارة الحسابات بالتناوب ونظام Cooldown |
| **gemini_comment_generator.php** | توليد تعليقات طبيعية بالذكاء الاصطناعي |
| **cron_insert_task.php** | إدراج مهام تصفح ورد تلقائي |
| **cron_weekly_report.php** | تقرير أسبوعي ذكي للاستخبارات التسويقية |

### 5.2 أنظمة الماركتنج التلقائية (Cron Jobs)

#### cron_auto_marketing_pusher.php — الدفع التسويقي الآلي
- يستهدف الركاب الخاملين (فتحوا التطبيق ولكن لم يحجزوا رحلة اليوم)
- يُولّد رسائل ترويجية مخصصة عبر Gemini AI بناءً على أسعار المنافسين الحقيقية
- يرسل عبر FCM مع نظام مانع للتكرار (24 ساعة Cooldown)
- يدعم رسائل خاصة بكل دولة (SY, JO, EG, IQ)

#### cron_passenger_reengagement.php — إعادة تفعيل الركاب الخاملين
- يستهدف الركاب غير النشطين لمدة 3+ أيام
- يستخدم Gemini AI لإنشاء رسائل إشعار مخصصة مع سياق أسعار المنافسين
- Anti-spam عبر Redis (72 ساعة Cooldown)
- حفظ الإشعارات في جدول `notifications`

#### cron_silent_push_inactive.php — الإشعارات الصامتة
- يرسل إشعارات صامتة (data-only FCM) للخاملين
- `content_available: true` ← يوقظ التطبيق في الخلفية لمزامنة الموقع

### 5.3 المعادلة التسويقية (AI Formula Solver)

#### cron_ai_engine.php — محرك الذكاء الاصطناعي للتسعير
- يعمل كل 30-60 دقيقة
- **Smart Pricing Module**: يعكس هندسة الأسعار الإجمالية للمنافسين
- يُحدّث جدول Kazan لجميع أنواع المركبات: Speed, Comfort, Lady, Electric, Van, Delivery, MishwarVIP, Awfar
- يحسب أسعار الدقيقة (Normal/Peak/Late) لكل نوع

#### cron_kazan_adjuster.php — مضبط العمولات
- يضبط نسب Kazan (العمولات) بناءً على بؤر Surge المنافسة
- يطبق تخفيضات 15-30% على العمولات في المناطق عالية المنافسة
- يستخدم Redis للتخزين المؤقت

#### cron_gemini_advisor.php — مستشار Gemini الاستراتيجي
- تحليل استراتيجي أسبوعي لصيغ تسعير المنافسين
- يُولّد تقارير HTML محفوظة في `gemini_market_insights`

#### cron_predictive_demand.php — التنبؤ بالطلب
- تحليل أنماط الطلب التاريخية للتنبؤ بالطلب المستقبلي

#### cron_seasonal_pricing.php — التسعير الموسمي
- تعديل الأسعار حسب المواسم والعطلات

#### cron_surge_opportunity.php — فرص Surge
- اكتشاف فرص رفع الأسعار في المناطق ذات الطلب المرتفع

### 5.4 Location Intelligence Engine (المحرك الجغرافي التسويقي)
**المكان**: `backend/core/Services/LocationIntelligenceEngine.php`
- يعالج تحديثات موقع الراكب
- يتحقق من تقاطع المناطق الجغرافية (Geofence Zones)
- يشغل حملات إعلانية بناءً على الموقع
- يُسجل في `marketing_campaigns_log`
- Anti-spam (24 ساعة Cooldown)

### 5.5 SiroGeminiService — خدمة Gemini المتكاملة
**المكان**: `backend/core/Services/SiroGeminiService.php`

| الوظيفة | الوصف |
|---------|-------|
| `analyzeMarketAndDraftCampaign()` | تحليل أسعار المنافسين، اقتراح خصومات، توليد رسائل تسويقية |
| `generateGeofenceMessage()` | توليد رسائل ترويجية حسب الموقع الجغرافي |
| `evaluatePostsForReporting()` | تحليل منشورات وسائل التواصل للاستخبارات التسويقية |
| `analyzeCompetitorFormulas()` | تحليل استراتيجي لصيغ تسعير المنافسين |

### 5.6 Content Pipeline (خط إنتاج المحتوى)
**المكان**: `backend/marketing_engine/services/`
- **ContentWorkflow.php**: ينظم دورة إنتاج المحتوى بالذكاء الاصطناعي (كتابة سكريبت → توليد صوت → فيديو)
- **AIVideoGenerator.php**: يدمج Gemini (نصوص) + ElevenLabs (صوت) + Creatomate/HeyGen (فيديو)

---

## 6. نظام المكافآت والتلعيب (Gamification)

### 6.1 مستويات السائقين (Driver Levels)
| المستوى | النقاط المطلوبة | الميزة |
|---------|----------------|--------|
| 🟤 **برونزي (Bronze)** | 0 - 999 نقطة | — |
| ⚪ **فضي (Silver)** | 1,000 - 4,999 نقطة | تخفيض العمولة 1% |
| 🟡 **ذهبي (Gold)** | 5,000 - 14,999 نقطة | تخفيض العمولة 2% |
| 💎 **ألماسي (Diamond)** | 15,000+ نقطة | تخفيض العمولة 5% |

### 6.2 الإنجازات (Achievements) — 8 إنجازات
| الإنجاز | الشرط |
|---------|-------|
| 🚗 **أول رحلة** | إتمام أول رحلة |
| ⭐ **نجمة خماسية** | الحصول على تقييم 5 نجوم |
| 🏆 **10 رحلات** | إتمام 10 رحلات |
| 🏆 **50 رحلة** | إتمام 50 رحلة |
| 🏆 **100 رحلة** | إتمام 100 رحلة |
| 🏆 **500 رحلة** | إتمام 500 رحلة |
| 🔥 **7 أيام متتالية** | العمل 7 أيام متتالية بدون انقطاع |
| 🔥 **30 يوم متتالي** | العمل 30 يوم متتالي بدون انقطاع |
| 👥 **5 إحالات** | دعوة 5 سائقين جدد |

### 6.3 النقاط السلوكية (Behavior Scoring)
- **Speed Score**: يراقب السرعة القصوى
- **Hard Brakes Score**: يراقب الفرامل المفاجئة
- **Behavior Score**: تقييم عام لسلوك القيادة

### 6.4 الهدف اليومي (Daily Goal)
- هدف أرباح يومي قابل للتعديل
- شريط تقدم实时
- إشعارات عند تحقيق الهدف

### 6.5 التحديات (Challenges) — مهمات يومية وأسبوعية

#### التحديات اليومية:
| التحدي | الهدف |
|--------|-------|
| الرحلات | 5 / 10 رحلات |
| الأرباح | مبلغ مستهدف |
| مكافأة نهاية الأسبوع | رحلات إضافية يومي جمعة/سبت |

#### التحديات الأسبوعية:
| التحدي | الهدف |
|--------|-------|
| الرحلات | 30 رحلة |
| الأرباح | مبلغ مستهدف أسبوعي |
| ساعات العمل | 20 ساعة |

#### المكافآت:
- نقاط بقيم خاصة بكل دولة (SY, JO, EG)
- نظام Claim مع تحقق من الخادم

### 6.6 لوحة المتصدرين (Leaderboard)
- ترتيب السائقين حسب الرحلات أو الأرباح
- منصّة التتويج (أول 3 مراكز)
- إظهار ترتيب السائق الشخصي وعدد السائقين الإجمالي
- تحديث دوري من الخادم

---

## 7. نظام الإحالة (Referral System)

### 7.1 إحالة السائقين
- **توليد كود إحالة**: من اسم السائق + ID
- **إحالة سائق لسائق**: مكافآت لكل سائق جديد يسجل
- **إحالة سائق لراكب**: مكافآت لكل راكب جديد يسجل
- **مشاركة عبر واتساب**: رسالة مشاركة مع الكود
- **إحصائيات**: عدد الإحالات النشطة، إجمالي المكافآت

### 7.2 إحالة الركاب
- **كود إحالة خاص**: لكل راكب
- **ربط كود الدعوة**: `linkInviteCode()` لتطبيق كود
- **مشاركة التطبيق**: صفحة مشاركة مع كود ورسالة
- **مكافآت**: رصيد مجاني لكل شخص يدعوه

---

## 8. نظام إعادة تفعيل الخاملين

### 8.1 خوارزمية إعادة التفعيل
1. **الكشف**: كشف الركاب غير النشطين (3+ أيام، 7+ أيام، 30+ يوم)
2. **التحليل**: استخدام Gemini AI لتحليل سبب الخمول (سعر، تجربة، منافس)
3. **التوليد**: إنشاء رسالة مخصصة لكل راكب حسب حالته
4. **الإرسال**: إرسال عبر FCM مع رابط عميق (Deep Link) للتطبيق
5. **المتابعة**: تتبع معدل فتح الإشعارات وعودة المستخدمين

### 8.2 أنواع حملات إعادة التفعيل
| نوع الحملة | الجمهور المستهدف | التكرار |
|-----------|-----------------|---------|
| تنبيه سعري | راكب فتح التطبيق ولم يحجز | كل 24 ساعة |
| عرض خاص | خامل 3-7 أيام | كل 72 ساعة |
| عرض استرجاع | خامل 7-30 يوم | كل أسبوع |
| عرض العودة | خامل 30+ يوم | كل أسبوعين |

### 8.3 الأمان ضد الإزعاج
- Redis Cooldown (72 ساعة للحملات الكثيفة، 24 ساعة للخفيفة)
- حد أقصى 3 إشعارات في الأسبوع لكل مستخدم
- إمكانية إلغاء الاشتراك

---

## 9. نظام العمولات الذكي (Kazan)

### آلية العمل:
1. **نسبة عمولة متغيرة**: تختلف حسب نوع المركبة (Speed, Comfort, Delivery, ...)
2. **أسعار مختلفة لكل دولة**: سوريا، الأردن، مصر
3. **تعديل ديناميكي**: cron_kazan_adjuster.php يعدل العمولات في مناطق المنافسة العالية
4. **تخفيض تلقائي**: 15-30% تخفيض في بؤر Surge للمنافسين
5. **شفافية كاملة**: السائق يرى العمولة قبل قبول الرحلة

### كسر العمولة حسب الدولة:
| الدولة | النطاق التقريبي |
|--------|----------------|
| سوريا | 10-20% |
| الأردن | 15-25% |
| مصر | 10-20% |

---

## 10. لوحة الإدارة الشاملة (Admin)

### التقنية
- **الإطار**: Flutter Web (PWA)
- **المنصات**: Web, Android, iOS
- **إدارة الحالة**: GetX
- **الخرائط**: Flutter Map (OpenStreetMap)
- **الرسوم البيانية**: fl_chart
- **قاعدة البيانات محلية**: sqflite للتخزين المؤقت

### الوحدات الإدارية بالتفصيل:

#### 10.1 Dashboard (لوحة المعلومات)
- [x] إحصائيات فورية: عدد السائقين المتصلين، الرحلات النشطة، الإيرادات اليومية
- [x] رسوم بيانية تفاعلية (خطية، عمودية، دائرية)
- [x] مقارنة شهرية/سنوية
- [x] مؤشرات الأداء الرئيسية (KPIs)
- [x] تنبيهات الأنشطة غير الطبيعية

#### 10.2 إدارة الكباتن (Captain Management)
- [x] قائمة السائقين مع بحث وتصفية متقدم
- [x] عرض تفاصيل السائق (معلومات شخصية، السيارة، المستندات)
- [x] قبول/رفض طلبات التسجيل
- [x] توثيق المستندات
- [x] حظر/فك حظر
- [x] إرسال إشعارات مستهدفة
- [x] مراجعة ملفات السائقين
- [x] إدارة أنواع المركبات لكل سائق

#### 10.3 إدارة الركاب (Passenger Management)
- [x] قائمة الركاب
- [x] عرض سجل الرحلات لكل راكب
- [x] حظر/فك حظر
- [x] إرسال إشعارات
- [x] عرض التقييمات
- [x] إدارة المحفظة

#### 10.4 إدارة الرحلات (Ride Management)
- [x] تتبع الرحلات المباشرة (Live Tracking)
- [x] سجل الرحلات الكامل مع البحث المتقدم
- [x] تفاصيل الرحلة: السائق، الراكب، المسار، المدة، السعر، العمولة
- [x] إلغاء الرحلات
- [x] تصدير التقارير

#### 10.5 الإدارة المالية (Financial Management)
- [x] تقارير الأرباح اليومية/الأسبوعية/الشهرية
- [x] تقارير العمولات
- [x] التسويات المالية مع السائقين
- [x] سجل المدفوعات
- [x] إدارة حسابات البنوك

#### 10.6 التحليلات المتقدمة (Advanced Analytics)
- [x] مؤشرات الأداء (KPIs)
- [x] رسوم بيانية تفاعلية
- [x] تحليل الاتجاهات
- [x] تقارير مخصصة

#### 10.7 إدارة العمولات (Kazan Management)
- [x] تحرير نسب العمولات لكل دولة
- [x] تحرير نسب العمولات لكل نوع مركبة
- [x] نماذج تسعير
- [x] تفعيل/تعطيل التسعير الديناميكي

#### 10.8 العروض الترويجية (Promotions)
- [x] إنشاء عرض جديد (كود خصم، نسبة، قيمة ثابتة)
- [x] إدارة العروض الحالية (تعديل، حذف)
- [x] تحديد صلاحية العرض
- [x] تحديد المستهدفين

#### 10.9 إدارة الموظفين (Staff Management)
- [x] إضافة/إزالة موظفين
- [x] تحديد صلاحيات الأدوار
- [x] سجل النشاطات

#### 10.10 مراقبة الجودة (Quality Control)
- [x] بطاقات أداء السائقين
- [x] نظام التقييم
- [x] القوائم السوداء
- [x] تقارير الجودة

#### 10.11 الأمان والرقابة (Security & Audit)
- [x] سجلات التدقيق (Audit Logs)
- [x] محاولات الدخول الفاشلة
- [x] كشف الاحتيال
- [x] إدارة الجلسات النشطة

#### 10.12 مراقبة الخوادم (Server Monitor)
- [x] حالة الخوادم
- [x] أداء النظام
- [x] وقت التشغيل (Uptime)
- [x] استهلاك الموارد

#### 10.13 الماركتنج (Marketing)
- [x] تحليل أسعار المنافسين
- [x] اكتشاف الحالات الشاذة
- [x] تشغيل/إيقاف الـ Autopilot
- [x] Price Gap Heatmap
- [x] حصة السوق (Market Share)
- [x] التنبؤ بالأسعار بالذكاء الاصطناعي
- [x] What-If Simulator (تغيير سعر Speed ← تأثير على PCI وحصة السوق)
- [x] Win-back targets
- [x] Campaign Log

#### 10.14 نظام الشكاوى (Complaints System)
- [x] إدارة تذاكر الدعم
- [x] تصنيف الشكاوى
- [x] متابعة الحل
- [x] إشعارات للمستخدمين

#### 10.15 الإشعارات (Notifications)
- [x] إرسال إشعارات لجميع المستخدمين
- [x] إرسال إشعارات لفئة محددة (سائقين، ركاب)
- [x] إرسال إشعارات لمستخدم معين

#### 10.16 إدارة الفواتير
- [x] إنشاء فواتير
- [x] طباعة فواتير
- [x] تقارير ضريبية

---

## 11. تطبيق الخدمة الميدانية (Service)

### التقنية
- **الإطار**: Flutter (Dart) — متوفر على Android و iOS
- **إدارة الحالة**: GetX
- **Firebase**: FCM، Analytics، Crashlytics

### الميزات الوظيفية:

#### 11.1 تسجيل السائقين الجدد
- نموذج تسجيل متكامل: الاسم، رقم الهاتف، البريد الإلكتروني، المدينة
- تصوير المستندات (الهوية، رخصة القيادة، أوراق السيارة)
- استخراج البيانات من المستندات بالذكاء الاصطناعي عبر Azure OCR + OpenAI GPT + Llama AI
- التحقق الميداني من السيارة (موديل، سنة، لون، لوحة)
- رفع صور السيارة (واجهة، خلف، داخلية، محرك)
- تحديد موقع التسجيل الجغرافي

#### 11.2 إدارة السائقين الحاليين
- عرض معلومات السائقين
- تحديث بيانات السائقين
- تغيير حالة السائق إلى نشط
- إضافة سيارة جديدة لسائق
- ربط Car Plate بسائق

#### 11.3 البحث والتصفية
- بحث برقم الهاتف
- بحث بالاسم
- بحث برقم السائق
- تصفية حسب الحالة

#### 11.4 الأمان
- JWT Authentication مع بصمة جهاز
- Firebase Auth
- تشفير البيانات

---

## 12. تطبيق السائق (Driver)

### التقنية
- **الإطار**: Flutter (Dart) — Android, iOS, Web
- **إدارة الحالة**: GetX (معدل)
- **التخزين المحلي**: GetStorage (معدل)، sqflite
- **الخرائط**: Google Maps + Flutter Map + Map SaaS
- **الاتصالات**: Socket.IO (driver_socket)
- **الإشعارات**: Firebase Cloud Messaging (FCM)
- **المكالمات**: Agora + WebRTC
- **التراكب**: TripOverlayPlugin (Android Overlay)
- **CarPlay**: Android Auto + Apple CarPlay
- **التشفير**: secure_string_operations (AES-256-CBC)
- **التعريب**: ترجمة كاملة (عربي/إنكليزي)

### الميزات الكاملة:

#### 12.1 نظام استقبال الرحلات
- عرض تفاصيل الرحلة (المسافة، الوقت المتوقع، السعر، العمولة، الوجهة)
- مؤقت 15 ثانية للقبول التلقائي
- خيارات: قبول، رفض، إلغاء (مع أسباب)
- صوت تنبيه مخصص

#### 12.2 الـ Overlay (الميزة الفريدة)
- **TripOverlayPlugin**: نافذة عائمة تظهر فوق أي تطبيق
- تظهر فور وصول الطلب حتى لو الهاتف مقفل
- تعرض: المسافة، السعر، وقت الوصول
- مؤقت للقبول/الرفض

#### 12.3 الخدمة الخلفية (Foreground Service)
- تشتغل 24/7
- تحديث الموقع كل 3-5 ثوانٍ
- تستهلك أقل بطارية
- تظل نشطة حتى عند تصغير التطبيق

#### 12.4 الملاحة والتوجيه
- Voice Navigation (TTS) خطوة بخطوة
- إعادة حساب المسار تلقائياً
- عرض المسار على الخريطة
- إرشادات مفصلة

#### 12.5 الإحصائيات المالية
- أرباح اليوم: تفصيل الرحلات والمبلغ الإجمالي
- أرباح الأسبوع: رسم بياني + مقارنة
- أرباح الشهر: إجمالي + مقارنة مع الشهر السابق
- صافي الأرباح بعد العمولة

#### 12.6 المحفظة
- الرصيد الحالي
- سحب الأرباح
- سجل المعاملات
- تفاصيل كل معاملة

#### 12.7 نظام التقييم والمكافآت
- تقييم الركاب
- نقاط المستوى
- الإنجازات
- التحديات
- لوحة المتصدرين
- سلوك القيادة (Speed, Hard Brakes, Behavior Score)
- الهدف اليومي

#### 12.8 الصفحة الشخصية
- الصورة الشخصية
- معلومات السيارة
- إحصائيات السائق
- أنواع المركبات المسموح بها

#### 12.9 الدعم والطوارئ
- دردشة مع الدعم الفني
- SOS مع إرسال الموقع الحي
- مكالمة فيديو عبر Agora
- تسجيل صوتي وإرسال للدعم

#### 12.10 إعدادات متقدمة
- لغة التطبيق (عربي/إنكليزي)
- إعدادات الصوت (رفع/خفض مستوى الصوت)
- إعدادات الإشعارات
- CarPlay

---

## 13. تطبيق الراكب (Rider)

### التقنية
- **الإطار**: Flutter (Dart) — Android, iOS, Web
- **إدارة الحالة**: GetX (معدل)
- **الخرائط**: Google Maps + Here Maps + Map SaaS + OpenStreetMap
- **الاتصالات**: Socket.IO (passenger_socket)
- **الإشعارات**: FCM + Local Notifications
- **المكالمات**: Agora SDK
- **التسجيل**: Google Sign-In, Apple Sign-In, Firebase Auth
- **التشفير**: secure_string_operations
- **التعريب**: كامل (عربي/إنكليزي)

### الميزات الكاملة:

#### 13.1 طلب الرحلة
- [x] إدخال الوجهة: بحث نصي، اختيار من الخريطة، الأماكن المحفوظة
- [x] عرض السعر التقديري قبل الطلب
- [x] اختيار نوع المركبة (12 نوعاً)
- [x] خيارات إضافية: ملاحظات للسائق، الحجز لشخص آخر
- [x] تأكيد الطلب

#### 13.2 أثناء الرحلة
- [x] تتبع السائق المباشر على الخريطة
- [x] اسم السائق، صورته، رقم السيارة
- [x] وقت الوصول المتوقع (ETA)
- [x] المسار المتبقي
- [x] دردشة مع السائق
- [x] مشاركة الموقع الحي مع طرف ثالث
- [x] زر طوارئ (SOS)

#### 13.3 بعد الرحلة
- [x] تقييم السائق (نجوم + تعليق)
- [x] إضافة بقشيش (Tips)
- [x] إبلاغ عن مشكلة

#### 13.4 المحفظة والدفع
- [x] شحن المحفظة (PayMob, Stripe)
- [x] اختيار طريقة الدفع (نقدي، محفظة، فيزا، MTN، سيريتل، E-Cash)
- [x] سجل المعاملات
- [x] كوبونات الخصم

#### 13.5 العروض والإحالة
- [x] إدخال كود خصم
- [x] عرض العروض المتاحة
- [x] كود الإحالة الخاص
- [x] مشاركة التطبيق

#### 13.6 حساب المستخدم
- [x] تعديل الملف الشخصي
- [x] الأماكن المفضلة
- [x] سجل الرحلات
- [x] مركز المساعدة
- [x] الإعدادات (اللغة، الإشعارات)
- [x] حذف الحساب

---

## 14. جاهزية النظام لثلاث دول

### 14.1 البنية التحتية لكل دولة

| المكون | سوريا | الأردن | مصر |
|--------|-------|--------|-----|
| **الخوادم** | خادم مخصص | خادم مخصص | خادم مخصص |
| **قواعد البيانات** | منفصلة | منفصلة | منفصلة |
| **الخرائط (Map SaaS)** | محدثة ~10 أيام | محدثة ~10 أيام | محدثة ~10 أيام |
| **OSRM Routing** | خادم مخصص | خادم مخصص | خادم مخصص |
| **طرق الدفع** | MTN, Syriatel, Visa, Cash, Wallet | Visa, Wallet, Cash | E-Cash, Visa, Wallet, Cash |
| **بوابات الدفع** | PayMob, Stripe | PayMob, Stripe | PayMob, Stripe |
| **SMS/OTP** | Twilio, WhatsApp | Twilio, WhatsApp | Kazumi SMS |
| **Firebase** | ✅ | ✅ | ✅ |
| **عدد السائقين** | ~1,200 | ~800 | قيد التشغيل |
| **عدد الركاب** | ~1,800 | ~700 | قيد التشغيل |
| **حالة السوق** | مباشر (Live) | مباشر (Live) | إطلاق وشيك |

### 14.2 نموذج البيانات متعدد الدول
- **جدول العمولات**: per-country pricing في Kazan
- **جدول العروض**: per-country promotions
- **جدول الأسعار**: per-country fare calculation
- **جدول العملات**: دعم العملات المختلفة (ليرة، دينار، جنيه)
- **التحديات**: مكافآت بقيم خاصة بكل دولة
- **الإشعارات**: رسائل خاصة بكل دولة

### 14.3 جاهزية التوسع لدول جديدة
- إضافة دولة جديدة يتطلب:
  - خادم جديد أو تخصيص مساحة
  - تفعيل خريطة Map SaaS للدولة
  - ربط بوابات الدفع المحلية
  - تعديل أسعار Kazan
- لا يتطلب تغيير في الكود الأساسي

---

## 15. الملخص التنفيذي للمستثمر

### ما الذي يملكه المستثمر؟

سيرو ليست مجرد تطبيق نقل — إنها **منظومة تقنية متكاملة** تتكون من:

```
┌─────────────────────────────────────────────────────────────┐
│                    منظومة سيرو المتكاملة                      │
├─────────────┬───────────────┬───────────────┬───────────────┤
│  4 تطبيقات  │  2 بوت آلي    │  Marketing   │ البنية التحتية │
│             │               │    Engine    │                │
├─────────────┼───────────────┼───────────────┼───────────────┤
│ • الراكب    │ • Android Bot │ • AI تسعير   │ • Map SaaS    │
│ • السائق    │   (فحص أسعار) │ • حملات تلقائية│ • WebSocket   │
│ • الإدارة   │ • Social Bot  │ • Geofencing  │ • Redis GIS   │
│ • الخدمة    │   (تسويق)     │ • Gemini AI   │ • PostGIS     │
└─────────────┴───────────────┴───────────────┴───────────────┘
```

### مصادر الدخل المتعددة:
1. **عمولة الرحلات**: 10-20% حسب الدولة والنوع
2. **الإعلانات (Ad Campaign SaaS)**: إيراد إعلاني مستقل
3. **SiroMaps SaaS**: تأجير محرك الخرائط لتطبيقات أخرى
4. **الاشتراكات**: خطط اشتراك للسائقين
5. **العروض الترويجية**: شراكات مع العلامات التجارية

### الميزة التنافسية الرئيسية:
- **خرائط مملوكة تنفرد بها سيرو** في المنطقة — تحديث كل 10 أيام بتكلفة $0
- لا تعتمد سيرو على Google Maps مما يوفر $800-$30,000 شهرياً
- **بوتات ذكاء اصطناعي** تراقب السوق 24/7
- **منظومة كاملة** من 4 تطبيقات + بوتين + محرك تسويق
- **جاهزة لثلاث دول** مع بنية تحتية قابلة للتوسع

### وضع السوق الحالي:
| الدولة | الوضع | عدد السائقين | عدد الركاب |
|--------|-------|-------------|-----------|
| سوريا | ✅ مباشر | ~1,200 | ~1,800 |
| الأردن | ✅ مباشر | ~800 | ~700 |
| مصر | 🔄 إطلاق وشيك | — | — |

### خلاصة
سيرو تقدم فرصة استثمارية فريدة في قطاع النقل الذكي بمنطقة الشرق الأوسط، مع **منتج جاهز 100%**، **ترخيص حكومي رسمي**، **خرائط مملوكة**، **بوتات ذكاء اصطناعي**، ونظام تسويق متكامل — كل هذا يعمل في 3 دول مع بنية تحتية قابلة للتوسع لأي دولة جديدة.

---

> **سيرو — أول منصة نقل ذكي بمحرك خرائط مملوك وبوتات استخبارات تسويقية في المنطقة**