docs: restructure documentation, add digital legacy report, and secure contracts

2026-07-14 18:45:29 +03:00
parent 540ae4d4bc
commit 48382f5d4a
60 changed files with 2106 additions and 657 deletions
@@ -0,0 +1,490 @@
+# مقترحات الميزات التنافسية الجديدة — سيرو
+## New Competitive Features Proposal — Siro Platform
+
+> **النسخة:** 2.0 | **تاريخ:** يوليو 2026 | **التصنيف:** استراتيجي — سري
+
+---
+
+## 📋 فهرس المحتويات
+1. [الملخص التنفيذي](#1-الملخص-التنفيذي)
+2. [الميزات المقترحة — حسب الأولوية](#2-الميزات-المقترحة--حسب-الأولوية)
+3. [الميزات المقترحة — بالتفصيل](#3-الميزات-المقترحة--بالتفصيل)
+4. [تحليل العائد على الاستثمار (ROI)](#4-تحليل-العائد-على-الاستثمار-roi)
+5. [خارطة الطريق](#5-خارطة-الطريق)
+6. [الملحق: استبيان السوق](#6-الملحق-استبيان-السوق)
+
+---
+
+## 1. الملخص التنفيذي
+
+بناءً على التحليل الشامل لمنصة سيرو ودراسة السوق في سوريا، الأردن، ومصر، نقترح **18 ميزة تنافسية جديدة** مصنفة حسب الأولوية والأثر المتوقع.
+
+### الميزات المقترحة (وجبة سريعة)
+
+| # | الميزة | الفئة | الأثر | الجهد | الأولوية |
+|---|--------|-------|-------|-------|----------|
+| 1 | **🚗 Carpool (مشاركة الرحلة)** | نقل | 🟢 عال جداً | 3-4 أسابيع | 🥇 |
+| 2 | **📅 حجوزات مسبقة (Scheduled Rides)** | نقل | 🟢 عال جداً | 2-3 أسابيع | 🥇 |
+| 3 | **🤖 AI Customer Support** | خدمة | 🟢 عال جداً | 4-6 أسابيع | 🥇 |
+| 4 | **🔋 Smart WakeLock** | أداء | 🟡 عال | 1 أسبوع | 🥇 |
+| 5 | **🎵 Spotify/Apple Music** | ترفيه | 🟢 عال جداً | 3-4 أسابيع | 🥇 |
+| 6 | **🛡️ Safety Recording (تلقائي)** | أمان | 🟢 عال جداً | 2-3 أسابيع | 🥇 |
+| 7 | **👥 Split Fare (تقسيم الفاتورة)** | دفع | 🟡 عال | 2 أسبوع | 🥈 |
+| 8 | **📦 Parcel Tracking** | توصيل | 🟡 عال | 3-4 أسابيع | 🥈 |
+| 9 | **📊 Driver Dashboard (Real-time)** | سائق | 🟡 عال | 2-3 أسابيع | 🥈 |
+| 10 | **🗣️ Voice Assistant** | تجربة | 🟡 عال | 4-6 أسابيع | 🥈 |
+| 11 | **🏪 Siro Market** | تجارة | 🟢 عال جداً | 8-12 أسبوع | 🥉 |
+| 12 | **🚀 Driver Subscription Model** | إيرادات | 🟢 عال جداً | 4-6 أسابيع | 🥉 |
+| 13 | **🌐 Web Version للراكب** | وصول | 🟡 عال | 4-6 أسابيع | 🥉 |
+| 14 | **📹 Dashcam Integration** | أمان | 🟡 عال | 4-6 أسابيع | 🥉 |
+| 15 | **⌚ Wear OS / Apple Watch** | أجهزة | 🟠 متوسط | 3-4 أسابيع | 🥉 |
+| 16 | **🎮 In-app Games** | ترفيه | 🟠 متوسط | 3-4 أسابيع | 🥉 |
+| 17 | **🎯 Zone-based Dynamic Pricing** | تسعير | 🟡 عال | 2-3 أسابيع | 🥉 |
+| 18 | **📻 Siro Radio** | ترفيه | 🟠 متوسط | 2-3 أسابيع | 🥉 |
+
+---
+
+## 2. الميزات المقترحة — حسب الأولوية
+
+### 🥇 الأولوية القصوى (شهر 1-2)
+الميزات التي تقدم أعلى قيمة بأقل جهد:
+
+```
+1. Smart WakeLock          → جهد: 1 أسبوع  → أثر: بطارية أفضل 30%
+2. Scheduled Rides          → جهد: 2-3 أسابيع → أثر: شريحة عملاء جديدة
+3. Safety Recording (Auto) → جهد: 2-3 أسابيع → أثر: ثقة + أمان
+4. Carpool (MVP)           → جهد: 3-4 أسابيع → أثر: مضاعفة الرحلات
+5. AI Customer Support     → جهد: 4-6 أسابيع → أثر: توفير 70% دعم
+```
+
+### 🥈 الأولوية المتوسطة (شهر 3-4)
+```
+6. Spotify/Apple Music     → جهد: 3-4 أسابيع → أثر: تمييز تنافسي
+7. Split Fare              → جهد: 2 أسابيع  → أثر: راحة راكب
+8. Parcel Tracking         → جهد: 3-4 أسابيع → أثر: تحسين التوصيل
+9. Driver Dashboard        → جهد: 2-3 أسابيع → أثر: إنتاجية سائق
+10. Voice Assistant (MVP)  → جهد: 4-6 أسابيع → أثر: واجهة جديدة
+```
+
+### 🥉 الأولوية البعيدة (شهر 5-8)
+```
+11. Siro Market            → جهد: 8-12 أسبوع → أثر: منصة تجارة
+12. Driver Subscription    → جهد: 4-6 أسابيع → أثر: إيراد بديل
+13. Web Version            → جهد: 4-6 أسابيع → أثر: وصول أوسع
+14. Dashcam Integration    → جهد: 4-6 أسابيع → أثر: أمان + توثيق
+15. Wear OS / Watch        → جهد: 3-4 أسابيع → أثر: تميز تقني
+16. In-app Games           → جهد: 3-4 أسابيع → أثر: تجربة انتظار
+17. Zone Dynamic Pricing   → جهد: 2-3 أسابيع → أثر: إيرادات إضافية
+18. Siro Radio             → جهد: 2-3 أسابيع → أثر: إيراد إعلاني
+```
+
+---
+
+## 3. الميزات المقترحة — بالتفصيل
+
+---
+
+### الميزة 1: 🚗 Carpool — مشاركة الرحلة
+
+#### الوصف
+نظام يسمح لراكبين أو أكثر في نفس الاتجاه بمشاركة الرحلة والتكلفة.
+
+#### آلية العمل
+```
+1. الراكب A يطلب رحلة إلى وجهته
+2. النظام يبحث عن الراكب B (في نفس الاتجاه خلال 500m)
+3. يعرض خيار "Carpool" بتكلفة مخفضة 30-40%
+4. يقبل الراكبان → يتم احتساب مسار يمر بكليهما
+5. السائق يستلم 120-130% من أجر الرحلة العادية
+6. المنصة تربح 10-15% من كل راكب (ضعف الدخل)
+```
+
+#### الفرق بين Carpool و Mishwari الحالي
+| الخاصية | Mishwari (موجود) | Carpool (مقترح) |
+|---------|-----------------|-----------------|
+| المستخدم | راكب واحد (5 نقاط) | راكبان مختلفان |
+| التكلفة | يدفع راكب واحد | يتقاسم الراكبان |
+| الربح للمنصة | عمولة رحلة واحدة | عمولتان (ضعف) |
+| الربح للسائق | أجر رحلة عادية | أجر أعلى 20-30% |
+
+#### متطلبات التنفيذ
+- **الواجهة**: إضافة "Carpool" كنوع رحلة 13
+- **الخوارزمية**: مطابقة المسارات عبر GIS SPATIAL (موجود)
+- **التسعير**: نموذج تسعير خاص لـ Carpool
+- **التكامل**: WebSocket للبحث عن الراكب الثاني
+
+#### العائد المتوقع
+| المؤشر | القيمة |
+|--------|--------|
+| زيادة عدد الرحلات لكل سائق | +40-60% |
+| توفير للراكب | 30-40% |
+| زيادة دخل المنصة لكل راكب | +80-100% (عمولتان) |
+| رضا السائقين | +25% |
+
+---
+
+### الميزة 2: 📅 حجوزات مسبقة (Scheduled Rides)
+
+#### الوصف
+حجز رحلة مسبقاً (قبل ساعات أو أيام) مع تأكيد تلقائي.
+
+#### آلية العمل
+```
+1. الراكب يختار "حجز مسبق"
+2. يحدد: التاريخ، الوقت، نقطة الانطلاق، الوجهة
+3. النظام يؤكد الحجز فوراً
+4. قبل 30 دقيقة من الموعد → يبحث النظام عن سائق
+5. السائق يؤكد → إشعار للراكب
+6. إذا لم يوجد سائق → إشعار وإلغاء مجاني
+```
+
+#### المتطلبات التقنية
+| المكون | الوصف | الجهد |
+|--------|-------|-------|
+| جدول `scheduled_rides` | DB new table | يوم |
+| صفحة اختيار الوقت | Date/Time picker UI | 3 أيام |
+| Cron job | 30-min قبل الموعد | 2 يوم |
+| Matching algorithm | تعديل الموجود | 3 أيام |
+| Notifications | تأكيد + تذكير | يومين |
+
+#### العائد المتوقع
+- فتح شريحة جديدة من الركاب (رحلات المطار، المواعيد)
+- زيادة ولاء الركاب النظاميين
+- تمييز عن المنافسين المحليين (YallaGo, Zakinn)
+
+---
+
+### الميزة 3: 🤖 AI Customer Support
+
+#### الوصف
+شات بوت ذكي يجيب على 70% من استفسارات الركاب والسائقين تلقائياً.
+
+#### آلية العمل
+```
+استفسار من المستخدم
+       ↓
+  AI Bot (OpenAI GPT fine-tuned on Siro FAQ + history)
+       ↓
+  ┌──────────────────────┐
+  │ مفهوم؟               │ ← إجابة فورية + زر "هل ساعدك؟"
+  │ غير مفهوم أو معقد     │ ← تحويل لفريق الدعم البشري
+  └──────────────────────┘
+```
+
+#### التحسينات المطلوبة على الكود الموجود
+```dart
+// الموجود: chat UI + PHP backend للدردشة
+// المطلوب إضافته:
+1. Endpoint: POST /api/support/ai-query
+2. AI prompt مع Siro-specific context
+3. Confidence scoring (إذا > 85% → إجابة تلقائية)
+4. Feedback: "هل حل هذا مشكلتك؟" ← تدريب مستمر للـ AI
+5. Escalation: تحويل تلقائي للدعم البشري
+```
+
+#### التوفير المتوقع
+| المؤشر | القيمة |
+|--------|--------|
+| نسبة الأتمتة | 70% من الاستفسارات |
+| توفير في فريق الدعم | 50-70% |
+| وقت الرد للاستفسارات الآلية | < 3 ثوانٍ |
+| رضا المستخدمين | متوقع +15% |
+
+---
+
+### الميزة 4: 🔋 Smart WakeLock
+
+#### الوصف
+تشغيل WakeLock فقط عند الحاجة (أثناء الرحلة النشطة) بدلاً من تشغيله الدائم.
+
+#### التغيير على الكود الموجود
+```dart
+// ======== الوضع الحالي (مشكلة) ========
+// في main.dart (سطر 87):
+await WakelockPlus.enable();  // دائم — يستهلك بطارية
+
+// ======== الوضع المقترح ========
+// في ride_lifecycle_controller.dart:
+class RideLifecycleController extends GetxController {
+  RideState _currentState = RideState.noRide;
+
+  void onRideStateChanged(RideState newState) {
+    switch (newState) {
+      case RideState.searching:
+      case RideState.driverApplied:
+      case RideState.driverArrived:
+      case RideState.inProgress:
+        WakelockPlus.enable();  // تشغيل أثناء الرحلة
+        break;
+      case RideState.noRide:
+      case RideState.cancelled:
+      case RideState.finished:
+        WakelockPlus.disable();  // إيقاف خارج الرحلة
+        break;
+    }
+    _currentState = newState;
+  }
+}
+```
+
+#### التأثير على البطارية
+| الحالة | الوضع الحالي | الوضع المقترح | التوفير |
+|--------|--------------|---------------|---------|
+| خارج الرحلة (16 ساعة) | WakeLock دائم | WakeLock متوقف | 🔋 100% توفير |
+| أثناء الرحلة (8 ساعات) | WakeLock دائم | WakeLock دائم | 🔋 0% توفير |
+| **إجمالي اليوم** | 24 ساعة WakeLock | 8 ساعات WakeLock | **67% توفير** |
+
+---
+
+### الميزة 5: 🎵 Spotify/Apple Music Integration
+
+#### الوصف
+السماح للراكب بالتحكم بالموسيقى أثناء الرحلة عبر ربط حساب Spotify.
+
+#### آلية العمل
+```
+1. الراكب يربط حساب Spotify من الإعدادات
+2. أثناء الرحلة، تظهر أيقونة موسيقى
+3. الراكب يختار قائمة تشغيل أو أغنية
+4. الصوت يشتغل عبر سماعات السيارة (بلوتوث)
+5. السائق يتحكم بمستوى الصوت
+```
+
+#### المكونات المطلوبة
+```
+┌─────────────────────────────────────────────┐
+│            MUSIC INTEGRATION                  │
+├─────────────────────────────────────────────┤
+│                                              │
+│  Passenger App:                              │
+│  ┌─────────────────────────────┐            │
+│  │ Spotify SDK / Apple MusicKit │            │
+│  │ Auth + Playback Controls    │            │
+│  │ UI: Play/Pause/Skip/Volume  │            │
+│  └─────────────┬───────────────┘            │
+│                │                             │
+│  Driver App:                                │
+│  ┌─────────────▼───────────────┐            │
+│  │ Volume Control              │            │
+│  │ Mute Button                 │            │
+│  └─────────────────────────────┘            │
+│                                              │
+│  Revenue:                                    │
+│  - Spotify Premium referral (affiliate)      │
+│  - تمايز عن المنافسين                        │
+└─────────────────────────────────────────────┘
+```
+
+---
+
+### الميزة 6: 🛡️ Safety Recording (تلقائي)
+
+#### الوصف
+تسجيل تلقائي للصوت (وربما الفيديو لاحقاً) أثناء الرحلة مع رفع مشفر للخادم.
+
+#### آلية العمل
+```
+1. عند بدء الرحلة → بدء التسجيل التلقائي
+2. تسجيل مستمر للصوت (AAC-LC 44.1kHz)
+3. تشفير التسجيل AES-256 قبل الرفع
+4. رفع إلى الخادم مع نهاية الرحلة
+5. متاح للراكب والسائق لمدة 48 ساعة
+6. يحذف تلقائياً بعد 48 ساعة (ما لم يُبلغ عن مشكلة)
+```
+
+#### التحسينات على الكود الموجود
+```dart
+// AudioRecorderController موجود بالفعل — نحتاج:
+1. Auto-start عند ride.start
+2. Auto-stop عند ride.end
+3. Encryption قبل الرفع
+4. Upload عند انتهاء الرحلة
+5. UI indicator: ● Recording (أثناء التسجيل)
+```
+
+---
+
+### الميزة 7: 👥 Split Fare (تقسيم الفاتورة)
+
+#### الوصف
+إرسال طلب تقسيم الفاتورة للراكبين الآخرين في نفس الرحلة.
+
+```
+1. بعد انتهاء الرحلة → زر "تقسيم الفاتورة"
+2. اختيار جهات الاتصال (من التطبيق أو هاتف)
+3. إرسال رابط دفع لكل شخص
+4. كل شخص يدفع حصته عبر المحفظة
+5. السائق يستلم المبلغ كاملاً
+```
+
+---
+
+### الميزة 8: 📦 Parcel Tracking (تتبع الطرود)
+
+#### الوصف
+لخدمة Delivery، إضافة رقم تتبع وتحديثات حالة للطرد.
+
+```
+1. المرسل يطلب Delivery
+2. يولد النظام رقم تتبع فريد
+3. تحديثات: تم الاستلام → في الطريق → تم التوصيل
+4. المرسل والمستلم يتلقون إشعارات
+5. إثبات استلام (صورة + توقيع)
+```
+
+---
+
+### الميزة 9: 📊 Driver Real-time Dashboard
+
+#### الوصف
+لوحة قيادة ذكية للسائق تعرض أفضل أوقات العمل والمناطق.
+
+```
+المحتوى:
+🕐 أفضل أوقات العمل (حسب التاريخ)
+📍 المناطق الأعلى طلباً (Heatmap محدث)
+💰 الأرباح المتوقعة (AI prediction)
+📈 مقارنة أداء مع السائقين الآخرين
+🎯 اقتراحات ذكية (اذهب إلى المنطقة X)
+```
+
+---
+
+### الميزة 10: 🗣️ Voice Assistant
+
+#### الوصف
+مساعد صوتي متكامل للسائق والراكب.
+
+```
+أمر صوتي ← Speech-to-Text ← NLP (معالجة) ← تنفيذ
+
+أمثلة:
+- "خذني إلى شارع بغداد" → طلب رحلة
+- "كم ربحت اليوم؟" → عرض الإحصائيات
+- "اتصل بالراكب" → بدء مكالمة
+- "شبك واي فاي" → إيقاف استقبال الطلبات
+
+التقنية: Speech-to-Text (Google/Apple) + NLP (OpenAI/llama)
+```
+
+---
+
+### الميزة 11: 🏪 Siro Market
+
+#### الوصف
+سوق إلكتروني داخل التطبيق للمتاجر المحلية مع توصيل فوري.
+
+```
+┌─────────────────────────────────────┐
+│         SIRO MARKET                   │
+├─────────────────────────────────────┤
+│                                     │
+│  🏪 متاجر: مواد غذائية، صيدليات،   │
+│     إلكترونيات، ملابس               │
+│  🚚 توصيل: خلال 30-60 دقيقة         │
+│  💳 دفع: جميع طرق سيرو               │
+│  ⭐ تقييم المتاجر + المنتجات         │
+│                                     │
+│  يشبه: Careem NOW / Talabat          │
+└─────────────────────────────────────┘
+```
+
+---
+
+### الميزة 12: 🚀 Driver Subscription Model
+
+#### الوصف
+نموذج اشتراك شهري بديل عن العمولة.
+
+```
+┌─────────────────────────────────────┐
+│    خطط الاشتراك للسائقين             │
+├────────────┬────────────┬───────────┤
+│   Basic    │  Premium   │   VIP      │
+│  $29/شهر   │  $79/شهر   │  $199/شهر │
+│────────────┼────────────┼───────────┤
+│ عمولة 10%  │ عمولة 5%   │ عمولة 0%  │
+│ دعم عادي   │ دعم VIP    │ أولوية     │
+│            │ تقارير    │ مدير حساب  │
+└────────────┴────────────┴───────────┘
+```
+
+---
+
+## 4. تحليل العائد على الاستثمار (ROI)
+
+### 4.1 جدول المقارنة المالية
+
+| الميزة | التكلفة المقدرة | الإيراد الشهري المتوقع | ROI (شهر) |
+|--------|-----------------|------------------------|-----------|
+| Carpool | $3,000-$5,000 | $2,000-$5,000 | 1-2 شهر |
+| Scheduled Rides | $2,000-$3,000 | $1,000-$3,000 | 1-3 شهر |
+| AI Support | $2,000-$4,000 | توفير $1,500-$3,000 | 1-3 شهر |
+| Smart WakeLock | $300-$500 | غير مباشر (تحسين) | فوري |
+| Spotify Music | $2,000-$4,000 | $500-$2,000 | 2-4 شهر |
+| Safety Recording | $1,000-$2,000 | غير مباشر (ثقة) | 3-6 شهر |
+| Siro Market | $8,000-$15,000 | $5,000-$15,000 | 1-3 شهر |
+| Subscription | $2,000-$3,000 | $3,000-$8,000 | 1 شهر |
+
+### 4.2 أولويات ROI
+
+```
+الأعلى عائداً:
+1. Driver Subscription → ROI فوري (شهر 1)
+2. Carpool → ROI 1-2 شهر
+3. AI Support → ROI 1-3 شهر (توفير)
+4. Scheduled Rides → ROI 1-3 شهر
+5. Siro Market → ROI 1-3 شهر (أعلى إيراد)
+6. Spotify Music → ROI 2-4 شهر
+7. Safety Recording → غير مباشر
+8. Smart WakeLock → غير مباشر
+```
+
+---
+
+## 5. خارطة الطريق
+
+```
+الشهر 1           الشهر 2           الشهر 3           الشهر 4
+────────────────────────────────────────────────────────────────────
+🔋 Smart WL       🎵 Spotify        📊 Driver Dash     🗣️ Voice Asst
+📅 Scheduled      🛡️ Safety Rec     👥 Split Fare      ⌚ Watch App
+🤖 AI Support     🚗 Carpool         📦 Parcel Track    🚀 Subscription
+                                                       🏪 Siro Market
+
+تحسينات سريعة     ميزات تنافسية     توسع + تكامل       منصات جديدة
+```
+
+---
+
+## 6. الملحق: استبيان السوق
+
+### أسئلة لتوجيه الأولويات (يُجرى مع 100 مستخدم):
+
+1. **أي ميزة تريدها في تطبيق النقل؟**
+   - [ ] مشاركة الرحلة (Carpool)
+   - [ ] حجز مسبق
+   - [ ] موسيقى في السيارة
+   - [ ] تقسيم الفاتورة
+
+2. **هل ستدفع اشتراك شهري لتطبيق النقل؟**
+   - [ ] نعم (بدون عمولة)
+   - [ ] لا أفضل العمولة
+   - [ ] ربما
+
+3. **هل تثق بتسجيل الصوت التلقائي للرحلة؟**
+   - [ ] نعم — يزيد الأمان
+   - [ ] لا — قلق على الخصوصية
+   - [ ] لا أعرف
+
+4. **هل تستخدم Spotify أو Apple Music؟**
+   - [ ] Spotify
+   - [ ] Apple Music
+   - [ ] لا أستخدم
+   - [ ] YouTube Music
+
+---
+
+> **تم إعداد هذا التقرير بناءً على تحليل الكود المصدري الكامل لمنصة سيرو ودراسة السوق في سوريا، الأردن، ومصر.**
+> 
+> **النسخة:** 2.0 | **تاريخ:** يوليو 2026 | **التصنيف:** استراتيجي — سري