Hamza-AyedandClaude Opus 5
143146c1b4
سوكيت الراكب (سبب عدم ظهور معلومات السائق عند القبول): - تطبيق الراكب كان يرسل id فقط بلا jwt، و passenger_socket.php يرفض أي اتصال بلا jwt ⇒ الراكب لا ينضم لغرفته أبداً ولا يستلم ride_status_change ولا driver_location_update. تظهر حالة القبول عبر الـ polling فقط بينما driver_info يصل بالسوكيت وحده. (سوكيت السائق يعتبر الـ jwt اختيارياً، ومن هنا جاء التباين بين التطبيقين.) - cancelled_by_driver كان يسقط من switch حالات الراكب فيبقى معلّقاً بعد إلغاء السائق. - حماية socket (late) من القراءة قبل التهيئة عند الانسحاب بلا jwt. الإشعارات والرسائل (سبب "مرات توصل ومرات لا"): - جدول tokens يخزّن توكن الراكب مشفّراً، و getRideWaiting.php كان يرجعه بلا فك تشفير ⇒ من يقبل من قائمة السوق يحمل blob مشفّراً يستخدمه كـ FCM target فيرفضه FCM بـ 400: لا إشعار قبول ولا رسائل. ومن يقبل من الـ dispatch/FCM يحمل نصاً صريحاً فتعمل. الفرق كان في طريقة القبول. - acceptRide.php يحلّ التوكن من القاعدة دائماً ولا يثق بالعميل (أصحّ أمنياً). - market_new_ride كان لا يحمل passengerId ولا الإحداثيات فتصل "null"؛ أُضيفت بلا أي PII لأن الحمولة تُبَثّ لكل سائق قريب لا للفائز فقط. - send_fcm.php: مهلة على OAuth (كان يعلّق حتى مهلة PHP فتُسقط الرسالة بصمت)، توحيد ding→default لأندرويد، وحقن title/body/tone في data مطابقةً لـ FcmService. - تطبيق السائق يقرأ title/body من data أولاً مثل الراكب، ولا يعرض فقاعة فارغة للرسائل الصامتة. السوكيت والإعدادات: - forwardLocationToPassengerSocket كان يقرأ lat/lng والحمولة فيها latitude/longitude ⇒ المسافة تخرج ضخمة والـ throttle معطّل تماماً فيُعاد التوجيه مع كل نبضة GPS. - notifyPassengerOnRideServer كان يرجع null بصمت مطلق عند حجب العنوان. - العنوان الافتراضي لسيرفر الموقع كان nginx/loction_server/driver_socket.php وهو ديمون Workerman لا يُخدَم عبر nginx ⇒ صار socket_driver:2021. (LOCATION_API_URL بقي على nginx لأن api_get_nearby.php سكربت عادي.) - ride_server/passenger_socket.php (النسخة التي يشغّلها Docker) كانت ناقصة كل كود مواصلاتي الموجود في passenger_server/ ⇒ نُقل مع REDIS_HOST. - .env.example: ALLOWED_SOCKET_URLS يغطّي أسماء حاويات Docker، وإضافة PASSENGER_SOCKET_INTERNAL_URL. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
📚 مركز توثيق منصة Siro — الفهرس الموحّد
هذا المجلد هو المصدر الوحيد لكل توثيق المشروع. تم دمج المجلدات الثلاثة السابقة
(docs + documents + knowledge) هنا، مقسّمة حسب الموضوع.
أين أبدأ؟ التقرير التفاعلي الشامل: 09_reports/siro_digital_legacy_report.html
01_overview — نظرة عامة ومعمارية النظام
فهم البنية الكاملة: 4 تطبيقات Flutter + باك اند PHP + خوادم Socket + Redis.
| الملف | المحتوى |
|---|---|
| PROJECT_OVERVIEW.md | تعريف المشروع ومكوناته الرئيسية |
| SYSTEM_ARCHITECTURE.md | المعمارية التقنية الكاملة |
| siro_comprehensive_report.md | التقرير الشامل الأحدث (فحص 8 مسارات للكود) |
| tel.comprehensive_report.md | نسخة التقرير الشامل المعدّة للإرسال |
| Siro_Platform_Report.md | تقرير المنصة العام |
| PLATFORM_CURRENT_STATE_AR.md | الحالة الراهنة للمنصة |
| API_DEPENDENCY_MATRIX.md | مصفوفة اعتماديات الـ API |
| DATABASE_DEPENDENCY_MATRIX.md | مصفوفة جداول قاعدة البيانات |
| server_architecture_feedback.md | مراجعة معمارية الخوادم المتعددة |
| AI_CONTEXT.md | سياق موجز لأدوات الذكاء الاصطناعي |
02_journeys_and_tutorials — رحلات المستخدم والتوتوريال
سير الرحلة خطوة بخطوة (راكب وسائق) + خطة التوتوريال داخل الموقع.
| الملف | المحتوى |
|---|---|
| TUTORIAL_PLAN_AR.md | ⭐ خطة التوتوريال الكاملة مع قائمة لقطات الشاشة المطلوبة |
| PASSENGER_JOURNEY.md | دورة حياة الراكب كاملة (شاشات + APIs + حالات) |
| DRIVER_JOURNEY.md | دورة حياة السائق كاملة |
| ride_simulation_report.md | تقرير محاكاة رحلة الراكب |
| driver_ride_simulation_report.md | تقرير محاكاة رحلة السائق |
| syria_driver_registration_report.md | تسجيل سائق سوريا |
ملفات *_simulation.html |
محاكاة تفاعلية بالمتصفح (راكب/سائق/تسجيل/إدارة/نظام كامل) |
03_pricing — محرك التسعير
| الملف | المحتوى |
|---|---|
| PRICING_ENGINE_ARCHITECTURE.md | معمارية محرك التسعير كاملة |
| pricing_system_report.md | تقرير نظام التسعير |
| دراسة_نظام_أتمتة_السوق_الذكي.md | أتمتة مراقبة المنافسين وإعادة التسعير |
| redis_state_plan.md | خطة حالة الرحلة في Redis |
04_features — الميزات الفنية والتنافسية
| الملف | المحتوى |
|---|---|
| COMPETITIVE_FEATURES.md | الميزات التنافسية مقابل كريم/أوبر/يلا-جو |
| TECHNICAL_ADVANTAGES_AR.md | المزايا التقنية المبنية داخلياً |
| NEW_FEATURES_PROPOSAL_AR.md | مقترحات ميزات جديدة |
| AUDIO_MUSIC_FEATURES_AR.md | ميزات الصوت والموسيقى |
| BATTERY_PERFORMANCE_AR.md | أداء البطارية والتحسينات |
| auto_carplay_checklist_arabic.md | Android Auto / CarPlay (عربي + إنجليزي) |
| ai_document_extraction_prompt.md | برومبت استخراج الوثائق بالذكاء الاصطناعي |
05_transit_mawasalati — نظام «مواصلاتي» (باصات الجامعات)
| الملف | المحتوى |
|---|---|
| transit_comprehensive_workflow_report.md | ⭐ سير العمليات الكامل (الأحدث — 2026-07-14) |
| mawasalati_full_system_review.md | المراجعة الفنية الكاملة والفجوات المعروفة |
| mowasalaty_strategy_report.md | التقرير الاستراتيجي (نموذج SaaS المجاني) |
| mawasalati_plan.md | خطة التنفيذ الأصلية |
06_investors — وثائق المستثمرين ودراسات الجدوى
| الملف | المحتوى |
|---|---|
| rebuild_cost_estimate_egypt_2026.md | ⭐ دراسة كلفة إعادة البناء في مصر (فريق + AI، 2026) |
| SIRO_INVESTOR_REPORT_AR.md | تقرير المستثمر الرئيسي |
| تقرير_المستثمر_الشامل_Siro.md | التقرير الشامل للمستثمر |
| Siro_Investors_Report_AR.md | تقرير مستثمرين (نسخة سابقة) |
| SIRO_INVESTOR_DECK.html | عرض المستثمرين التفاعلي |
| Siro_Feasibility_Study_v4.pdf | دراسة الجدوى v4 |
| Siro_Egypt_Competitive_Study_AR.md | دراسة سوق مصر التنافسية |
| تقرير_سيرو_الكامل.docx | نسخة Word للمشاركة |
⚠️ تنبيه حوكمة: يوجد سرديتان تمويليتان مختلفتان (180K$ سوريا مقابل 200K$/22% عامة) — يجب توحيدهما قبل أي عرض رسمي.
07_marketing — التسويق والنمو
| الملف | المحتوى |
|---|---|
| SIRO_MARKETING_REPORT_AR.md | تقرير التسويق الرئيسي |
| marketing_and_growth_strategy.md | استراتيجية التسويق والنمو |
| marketing_integration_plan_ar.md | خطة التكامل التسويقي |
| damascus_zones_map.html | خريطة مناطق دمشق |
08_security — الأمن ومراجعات الكود
| الملف | المحتوى |
|---|---|
| التقرير_الأمني_Backend_Siro.md | التدقيق الأمني للباك اند (بنود مفتوحة!) |
| CODE_REVIEW_REPORT_AR.md | مراجعة الكود الشاملة |
09_reports — التقارير التفاعلية النهائية
| الملف | المحتوى |
|---|---|
| siro_digital_legacy_report.html | ⭐ تقرير الإرث الرقمي الشامل (يشمل مواصلاتي وسير الرحلة والتوتوريال) |
99_archive — أرشيف
| الملف | المحتوى |
|---|---|
| intaleq_v1_secure_latest.md | نسخة كود V1 المؤرشفة (1.2MB — مرجع تاريخي فقط) |