Files
Siro/docs/01_overview/PLATFORM_CURRENT_STATE_AR.md

618 lines
20 KiB
Markdown

# منصة سيرو — الحالة الحالية والميزات الموجودة الآن
## Siro Platform — Current Implementation & Existing Features
> **للمستثمرين والشركاء**
> **آخر تحديث:** يوليو 2026
> **التصنيف:** سري - داخلي
---
## 🎯 نظرة عامة سريعة
**سيرو** منصة نقل (Ride-Hailing) متكاملة وشغالة الآن:
| البيان | الحالة |
|-------|--------|
| **الدول** | 🟢 سوريا (حي) | 🟢 الأردن (حي) | 🚀 مصر (جاهزة) |
| **السائقين** | 2,000+ نشط |
| **الركاب** | 2,500+ نشط |
| **الرحلات اليومية** | 2,000+ |
| **نسبة النمو الشهري** | 15-20% |
| **التصنيف** | 4.8/5.0 ⭐ |
---
## على ماذا يعتمد التطبيق تقنياً؟
### 🏗️ البنية الأساسية
```
┌─────────────────────────────────────────────────────────┐
│ التطبيقات (Flutter) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ siro_rider │ │ siro_driver │ │ siro_admin │ │
│ │ (الراكب) │ │ (السائق) │ │ (الإدارة) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────┘
↓ (API + WebSocket)
┌─────────────────────────────────────────────────────────┐
│ Backend (PHP + Node.js) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Main API │ │ Pricing │ │ WebSocket │ │
│ │ (siro_v3) │ │ Engine │ │ Servers │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────┘
↓ (Database)
┌─────────────────────────────────────────────────────────┐
│ MySQL + Redis + Google Cloud Storage │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ intaleqDB1 │ │ intaleq- │ │ Spatial GIS │ │
│ │ (60+ جداول) │ │ ridesDB │ │ (خرائط) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────┘
```
---
### 💻 لغات البرمجة والتقنيات
| الجزء | التقنية | الإصدار | الملاحظات |
|------|---------|---------|----------|
| **تطبيقات الهاتف** | Flutter (Dart) | 3.x | iOS + Android |
| **إدارة الحالة** | GetX | أحدث | Controllers + Bindings |
| **الخادم الأساسي** | PHP | 8.x | API + معالجة بيانات |
| **محرك التسعير** | Node.js + TypeScript | 18+ | تحليل ذكي |
| **WebSocket** | PHP Socket.IO | native | اتصال حي |
| **قاعدة البيانات** | MySQL | 8.0 | Spatial indexes |
| **التخزين المؤقت** | Redis | أحدث | Rate limiting + cache |
| **التخزين المحلي** | SQLite + GetStorage | - | بيانات الهاتف |
| **التشفير** | OpenSSL + JWT | - | أمان الاتصالات |
---
### 🗄️ قواعد البيانات
#### Database 1: intaleqDB1 (الرئيسي)
```
60+ جدول يتضمن:
├── Users (مستخدمين)
├── Drivers (سائقين + مستندات)
├── Rides (رحلات)
├── Payments (دفعات)
├── Wallets (محافظ)
├── Reviews (تقييمات)
├── Geofences (مناطق)
├── Promotions (عروض)
├── Admin_logs (سجلات الإدارة)
└── ... وأكثر
```
#### Database 2: intaleq-ridesDB
```
متخصصة في بيانات الرحلات:
├── Ride_history (تاريخ الرحلات)
├── Ride_routes (المسارات)
├── Ride_tracking (التتبع الحي)
└── Ride_statistics (الإحصائيات)
```
#### Database 3: car_locations
```
نظام مواقع المركبات:
├── Spatial GIS indexes
├── Real-time locations
├── Heatmap data
└── Demand zones
```
---
### 🗺️ الخرائط والتوجيه
**الخرائط المستخدمة حالياً:**
| المصدر | الاستخدام | الحالة |
|--------|----------|--------|
| **Google Maps** | عرض الخريطة | ✅ نشط |
| **Siro Maps (Map SaaS)** | خريطة مخصصة | ✅ نشط |
| **OSRM** | حساب المسارات | ✅ نشط |
| **Here Maps API** | البحث عن الأماكن | ✅ نشط |
| **SQLite Offline Maps** | خرائط بلا إنترنت | ✅ نشط |
**الميزة:**
- لا نعتمد على Google Maps فقط
- عندنا خريطة مملوكة (Siro Maps)
- توجيه متعدد المصادر
---
## الميزات الموجودة حالياً
### 👤 ميزات الراكب (siro_rider)
#### أنواع الرحلات (12 نوع):
```
✅ Speed (سريع) - رحلات عادية
✅ Comfort (مريح) - سيارات فاخرة
✅ Family (عائلة) - مساحة أكبر
✅ Delivery (توصيل) - طرود وطلبيات
✅ Blash (اقتصادي) - أرخص خيار
✅ Late (ليلي) - رحلات ليلية
✅ Heavy (ثقيل) - شحنات كبيرة
✅ Nature (ريفي) - طرقات وعرة
✅ Electric (كهربائي) - صديق البيئة
✅ PinkBike (دراجة) - سريع في الزحام
✅ Van (ميني باص) - مجموعات
✅ Female Driver (سائقة) - سائقة امرأة
```
#### الرحلات متعددة النقاط:
- ✅ حتى 5 محطات في رحلة واحدة
- ✅ تسعير ديناميكي لكل نقطة
- ✅ توجيه ذكي للمسارات
#### طرق الدفع:
```
✅ نقد (Cash)
✅ Visa/Mastercard (PayMob)
✅ محفظة سيرو الداخلية
✅ MTN Mobile Money (سوريا)
✅ Syriatel Mobile Money (سوريا)
✅ E-Cash (مصر)
✅ CLIQ (مصر)
```
#### الإشعارات:
```
✅ Firebase Push Notifications
✅ إشعارات محلية على الهاتف
✅ iOS Live Activities (تحديث حي على الـ Lock Screen)
✅ صفحات إشعارات داخل التطبيق
```
#### الاتصالات:
```
✅ دردشة داخل التطبيق مع السائق
✅ مكالمات صوتية (Agora + WebRTC)
✅ مكالمات فيديو
✅ تحويل النص لصوت (TTS)
✅ تسجيل صوتي
```
#### الأمان:
```
✅ زر SOS/طوارئ
✅ مشاركة الرحلة مع الأهل
✅ كشف الموقع الحقيقي (GPS)
✅ ربط بصمة الجهاز (Device Fingerprint)
✅ كشف الهاتف المخترق (Jailbreak/Root)
✅ تشفير الاتصال (SSL Pinning)
```
#### المميزات الإضافية:
```
✅ تقدير السعر قبل الطلب
✅ مقارنة أسعار مع المنافسين
✅ نظام التقييمات والتعليقات
✅ رمز الإحالة الموحد
✅ كوبونات وعروض ترويجية
✅ تاريخ الرحلات الكامل
✅ دعم 18+ لغة
✅ وضعين مظهر (فاتح/غامق)
```
---
### 🚕 ميزات السائق (siro_driver)
#### إدارة الرحلات:
```
✅ تفعيل/تعطيل الحالة
✅ عروض رحلات عائمة (Native Overlay) - فريد!
(تظهر على كل التطبيقات حتى لو كان الهاتف مأغلقاً)
✅ قبول/رفض العروض مع عداد تنازلي 15 ثانية
✅ توجيه للموقع (Turn-by-Turn مع صوت)
✅ وصول - بدء الرحلة - إنهاء الرحلة
```
#### الكسب والمحفظة:
```
✅ محفظة السائق (أرصدة يومية)
✅ ملخص الأرباح الأسبوعي
✅ سحب الأموال/التحويل البنكي
✅ سجل المدفوعات كامل
✅ ملخص الإحصائيات اليومية
- عدد الرحلات
- الأرباح
- متوسط التقييم
- مقارنة بالهدف اليومي
```
#### نظام التحفيز (Gamification):
```
✅ 4 مستويات: برونز → فضة → ذهب → ماس
✅ نقاط المكافآت
✅ تحديات يومية (اكمل 5 رحلات = مكافأة)
✅ تحديات أسبوعية (30 رحلة = مكافأة أكبر)
✅ متتاليات (7/30 يوم متتالي = مكافأة)
✅ لوحة ترتيب (أفضل 3 سائقين الأسبوع)
✅ سجل السلوك (تقييم السرعة والكبح الحاد)
```
#### التسجيل والمستندات:
```
✅ مسح ذكي للمستندات (3 محركات AI):
- Azure OCR (استخراج النص)
- OpenAI (فهم البيانات)
- Llama AI (بديل احتياطي)
✅ كشف الوجه (Face Detection)
✅ تسجيل السيارات (متعدد)
✅ رفع الرخصة والتأمين
✅ فحص المستندات الجنائية
```
#### الأداء والبطارية:
```
✅ مراقبة البطارية (Battery Monitoring)
✅ إقفال الجهاز (Wake Lock)
✅ خدمة الخلفية (Foreground Service)
✅ توفير البطارية (Power-Save Mode):
- GPS كل 10 ثوان (بدل 5)
- مسافة تصفية: 20 متر (بدل 10)
- أداء محسّن للأجهزة القديمة
```
#### الاتصال والتواصل:
```
✅ مكالمات صوتية فيديوية (Agora)
✅ دردشة مع الراكب
✅ تحويل نص لصوت (TTS)
✅ تسجيل صوتي للرحلة
```
#### الأمان:
```
✅ كشف الاحتيال (Scam Detection)
✅ كشف الهاتف المخترق
✅ SSL Pinning
✅ ربط بصمة الجهاز
✅ برنامج ضمان السائق
```
---
### 🖥️ ميزات لوحة الإدارة (siro_admin)
#### لوحة المعلومات:
```
✅ إحصائيات الرحلات الحية
✅ الإيرادات والأرباح
✅ عدد السائقين والركاب النشطين
✅ معدل التقييمات
✅ معدل الإلغاءات
✅ لوحة معلومات متقدمة (v2) مع رسوم بيانية
```
#### إدارة السائقين:
```
✅ قائمة السائقين مع جميع البيانات
✅ مراقبة الموقع الحي (GPS Live Tracking)
✅ مراجعة المستندات والصور
✅ رؤية السلوك والتقييمات
✅ إدارة القائمة السوداء
✅ ملاحظات للسائق
✅ لوحة نقاط السائق (جودة)
```
#### إدارة الركاب:
```
✅ قائمة الركاب كاملة
✅ معلومات التفاصيل (رقم، بريد، إلخ)
✅ تاريخ الرحلات
✅ إدارة المحفظة الرقمية
```
#### إدارة الرحلات:
```
✅ قائمة الرحلات المكتملة
✅ البحث والفحص التفصيلي
✅ مراقبة الرحلات الحية (Live Monitor)
✅ إدارة الإلغاءات
✅ حل المشاكل
```
#### إدارة التسعير (Kazan):
```
✅ نسبة العمولة لكل:
- دولة
- مدينة
- نوع مركبة
- وقت من اليوم
✅ تسعير ديناميكي ذكي
✅ معاينة تأثير التغييرات
```
#### التسويق والعروض:
```
✅ لوحة حرارية (Heatmap):
- طلب عالي جداً (أحمر)
- طلب عالي (برتقالي)
- طلب متوسط (أصفر)
- طلب قليل (أخضر)
- بدون طلب (أزرق)
✅ إنشاء حملات ترويجية
✅ رسائل مخصصة للركاب والسائقين
✅ إدارة الكوبونات والخصومات
✅ محاكاة (What-If Simulator)
```
#### المراقبة والأمان:
```
✅ سجلات التغييرات الكاملة (Audit Logs)
✅ مراقبة الأمان (Security Monitoring)
✅ مراقبة الخوادم (Server Monitoring)
✅ رؤية الأخطاء
✅ تشفير/فك تشفير البيانات
```
#### الموارد البشرية:
```
✅ إضافة موظفي الإدارة
✅ إدارة الموظفين
✅ الموظفين في الانتظار
```
#### الشكاوى والجودة:
```
✅ قائمة الشكاوى
✅ معالجة الشكاوى
✅ لوحة نقاط السائق
✅ إدارة القائمة السوداء
```
---
## تطبيقات المستخدمين
### 📱 سيرو للراكب (siro_rider)
```
منصة: iOS + Android
حجم التطبيق: ~80 MB
الميزات: 50+ ميزة
التحديثات: OTA (Shorebird)
```
### 🚕 سيرو للسائق (siro_driver)
```
منصة: iOS + Android
حجم التطبيق: ~100 MB
الميزات: 60+ ميزة
الخصوصية: Native Overlay + Background Service
التحديثات: OTA (Shorebird)
```
### 🖥️ سيرو الإدارة (siro_admin)
```
منصة: Web (PWA) + Mobile (Flutter)
الوصول: أي متصفح
الميزات: 15+ قسم إدارة
صلاحيات: Role-based (مسؤول، محلل، إلخ)
```
### ⚙️ خدمة سيرو (service_app)
```
منصة: iOS + Android
الاستخدام: عمليات داخلية
الميزات: متخصصة للموظفين
```
---
## الخوادم والأنظمة
### خوادم WebSocket:
| الخادم | المنفذ | الاستخدام | الحالة |
|--------|--------|----------|--------|
| **Driver Socket** | 2021 | بيانات موقع السائق + عروض | ✅ نشط |
| **Passenger Socket** | 3031 | طلبات الركاب + تتبع السائق | ✅ نشط |
### خادم الموقع (Location Server):
```
✅ تجميع مواقع السائقين الحية
✅ توليد بيانات الخرائط الحرارية
✅ حساب الطلب الحي
✅ توجيه السائقين للمناطق العالية الطلب
```
### خادم الركاب (Passenger Server):
```
✅ معالجة طلبات الركاب
✅ مطابقة الراكب مع السائق
✅ حساب المسافة والسعر
✅ إدارة حالة الرحلة
```
---
## الدوافع والروبوتات
### 🤖 Android Bot (روبوت سحب الأسعار):
```
المهمة: مراقبة أسعار المنافسين تلقائياً
التطبيقات المراقبة:
✅ Uber
✅ Careem
✅ Bolt
✅ YallaGo
✅ Zakinn
✅ Tfadal
✅ TaxiF
التكرار: كل 15 دقيقة
الاستخدام: تحديث أسعار سيرو تلقائياً
```
### 📱 Social Bot (روبوت وسائل التواصل):
```
القنوات:
✅ Facebook (قراءة تعليقات + رد آلي)
✅ Instagram (تصفح + تعليق ذكي)
✅ Telegram (خدش القنوات)
المحرك: Gemini AI (توليد تعليقات طبيعية)
التكرار: مستمر 24/7
الفائدة: تسويق وتفاعل مجاني
```
### ⚙️ مهام مؤتمتة (Cron Jobs):
```
✅ cron_auto_marketing_pusher → رسائل ترويجية ذكية
✅ cron_passenger_reengagement → إعادة تفعيل الركاب
✅ cron_silent_push_inactive → دفع صامت للتحديث
✅ cron_ai_engine → تحليل أسعار المنافسين
✅ cron_kazan_adjuster → تعديل العمولات
✅ cron_predictive_demand → التنبؤ بالطلب
✅ cron_seasonal_pricing → تسعير موسمي
✅ cron_surge_opportunity → فرص الارتفاع
التكرار: من كل 15 دقيقة إلى يومياً
```
---
## أنظمة الأمان
### المصادقة:
```
✅ JWT (JSON Web Tokens) مخصص
✅ Firebase Authentication
✅ Google Sign-In
✅ Apple Sign-In
✅ ربط بصمة الجهاز (Device Fingerprint)
```
### التشفير:
```
✅ SSL/TLS للاتصالات
✅ SSL Pinning (منع MITM attacks)
✅ تشفير البيانات المحلية
✅ Keychain (iOS) / Keystore (Android)
✅ FlutterSecureStorage للبيانات الحساسة
```
### الكشف والحماية:
```
✅ كشف الهاتف المخترق (Jailbreak/Root Detection)
✅ كشف محاكي الهاتف
✅ كشف الاحتيال (Scam Detection Module)
✅ تقييم السلوك (Behavior Scoring)
✅ حدود معدل الطلب (Rate Limiting)
✅ Audit Logs (سجل كل التغييرات)
```
---
## التكاملات الخارجية
### 🗺️ الخرائط:
```
✅ Google Maps API
✅ Here Maps (البحث عن الأماكن)
✅ Siro Maps (مملوكة)
✅ OSRM (حساب المسارات)
✅ SQLite (خرائط بلا إنترنت)
```
### 💳 الدفع:
```
✅ PayMob (بطاقات)
✅ Stripe (دولي)
✅ MTN Mobile Money (سوريا)
✅ Syriatel Mobile Money (سوريا)
✅ E-Cash (مصر)
✅ CLIQ (مصر)
```
### 📱 الرسائل والإخطارات:
```
✅ Firebase Cloud Messaging (FCM)
✅ Twilio (SMS)
✅ WhatsApp Cloud API
✅ Kazumi SMS
✅ iOS Live Activities
```
### 🤖 الذكاء الاصطناعي:
```
✅ Azure OCR (قراءة المستندات)
✅ OpenAI GPT (فهم البيانات)
✅ Llama AI (بديل احتياطي)
✅ Gemini (توليد محتوى صوتي)
```
### 🎤 الصوت والفيديو:
```
✅ Agora (مكالمات صوتية وفيديو)
✅ WebRTC (اتصال نظير-نظير)
✅ Flutter TTS (تحويل نص لصوت)
✅ ElevenLabs (توليد الصوت الاحترافي)
✅ Creatomate / HeyGen (إنشاء فيديو)
```
### 📊 التحليلات:
```
✅ Google Analytics
✅ Firebase Analytics
✅ Database Reports (MySQL مباشرة)
✅ Custom Dashboards
```
### 🔄 التحديثات:
```
✅ Shorebird (تحديثات Over-The-Air)
✅ Play Store / App Store (رسمي)
```
---
## 📊 ملخص الأرقام
| المؤشر | القيمة |
|-------|--------|
| **تطبيقات** | 4 (راكب، سائق، إدارة، خدمة) |
| **دول** | 3 (سوريا، الأردن، مصر) |
| **أنواع رحلات** | 12 نوع |
| **طرق دفع** | 7 طرق محلية |
| **الخوادم** | 5+ خوادم متخصصة |
| **محركات AI** | 3 (Azure, OpenAI, Llama) |
| **روبوتات** | 2 (Android Bot, Social Bot) |
| **مهام مؤتمتة** | 8+ cron jobs |
| **جداول قاعدة بيانات** | 60+ |
| **ميزات الراكب** | 50+ |
| **ميزات السائق** | 60+ |
| **ميزات الإدارة** | 15+ قسم |
| **لغات مدعومة** | 18+ |
| **تقييم التطبيق** | 4.8/5.0 ⭐ |
---
## 🎯 الخلاصة
سيرو ليست فقط تطبيق نقل، بل هي **منصة متكاملة بالفعل:**
- ✅ **شغالة حياً** في سوريا والأردن
- ✅ **مستقلة تقنياً** (خرائط مملوكة، أنظمة مخصصة)
- ✅ **مؤتمتة بالكامل** (روبوتات، cron jobs، AI)
- ✅ **آمنة** (تشفير، مصادقة، كشف احتيال)
- ✅ **قابلة للتطور** (3 دول، 12 نوع مركبة، 7 طرق دفع)
- ✅ **مربحة** (نموذج عمل واضح)
**جاهزة للنمو والتوسع بسرعة.**
---
> **إعداد:** فريق سيرو
> **آخر تحديث:** يوليو 2026
> **التصنيف:** سري - داخلي