Hamza-AyedandClaude Opus 5
afb5189515
السبب (مثبَّت على الإنتاج): التزام c35b350b بتاريخ 2026-07-23 — وهو التزام
تلقائي برسالة "Update: <time>" — أضاف المنفذ للروابط:
- 'https://jordan-siro.intaleqapp.com'
+ 'https://jordan-siro.intaleqapp.com:2020'
وكانت القيمة العاملة قبل ذلك بلا منفذ (443) فيُنهي البروكسي TLS ويمرّر.
بإضافة :2020 صار التطبيق يضرب حاوية Workerman مباشرة، وهي تفتح المنفذ نصاً
صريحاً (new SocketIO(2020) بلا سياق SSL)، فمصافحة TLS تتجمّد حتى المهلة:
❌ Socket Connect Error: timeout
❌ Socket Connect Timeout: 20000
ونتيجته أن السائق لا يبعث update_location إطلاقاً ⇒ لا GPS في Redis ⇒ لا
موقع للراكب لا عبر السوكيت ولا عبر الـ polling (كلاهما يقرأ من نفس المصدر).
مثبَّت بالأدلة على السيرفر:
- ss: المنفذان 2020/3030 يملكهما docker-proxy (نص صريح)، و443 nginx.
- curl على 127.0.0.1:2020 يرد {"sid":...,"upgrades":["websocket"]} — أي أن
الحاوية سليمة تماماً والناقص هو طبقة TLS وحدها.
الحل بلا أي بناء للتطبيقات (وبلا تنزيل مستوى الأمان — الـ JWT يُرسَل في
query string فلا يجوز إطلاقاً تحويله إلى http):
- الحاويتان تُنشران على 127.0.0.1:12020 و 127.0.0.1:13030 فقط.
- nginx على المضيف يستمع على 2020/3030 بشهادة الدومين ويمرّر إليهما مع
ترقية WebSocket (nginx/siro-sockets-tls.conf).
- proxy_read/send_timeout 3600s: اتصال السائق يعيش ساعات، وبلا ذلك يقطعه
nginx كل 60ث فتدخل الحاوية حلقة إعادة اتصال دائمة.
- proxy_buffering off و access_log off (نبضات GPS تُغرق القرص).
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 — مرجع تاريخي فقط) |