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,101 @@
+# 📚 مركز توثيق منصة Siro — الفهرس الموحّد
+
+هذا المجلد هو المصدر الوحيد لكل توثيق المشروع. تم دمج المجلدات الثلاثة السابقة
+(`docs` + `documents` + `knowledge`) هنا، مقسّمة حسب الموضوع.
+
+> **أين أبدأ؟** التقرير التفاعلي الشامل: [09_reports/siro_digital_legacy_report.html](09_reports/siro_digital_legacy_report.html)
+
+---
+
+## 01_overview — نظرة عامة ومعمارية النظام
+فهم البنية الكاملة: 4 تطبيقات Flutter + باك اند PHP + خوادم Socket + Redis.
+
+| الملف | المحتوى |
+|---|---|
+| [PROJECT_OVERVIEW.md](01_overview/PROJECT_OVERVIEW.md) | تعريف المشروع ومكوناته الرئيسية |
+| [SYSTEM_ARCHITECTURE.md](01_overview/SYSTEM_ARCHITECTURE.md) | المعمارية التقنية الكاملة |
+| [siro_comprehensive_report.md](01_overview/siro_comprehensive_report.md) | التقرير الشامل الأحدث (فحص 8 مسارات للكود) |
+| [tel.comprehensive_report.md](01_overview/tel.comprehensive_report.md) | نسخة التقرير الشامل المعدّة للإرسال |
+| [Siro_Platform_Report.md](01_overview/Siro_Platform_Report.md) | تقرير المنصة العام |
+| [PLATFORM_CURRENT_STATE_AR.md](01_overview/PLATFORM_CURRENT_STATE_AR.md) | الحالة الراهنة للمنصة |
+| [API_DEPENDENCY_MATRIX.md](01_overview/API_DEPENDENCY_MATRIX.md) | مصفوفة اعتماديات الـ API |
+| [DATABASE_DEPENDENCY_MATRIX.md](01_overview/DATABASE_DEPENDENCY_MATRIX.md) | مصفوفة جداول قاعدة البيانات |
+| [server_architecture_feedback.md](01_overview/server_architecture_feedback.md) | مراجعة معمارية الخوادم المتعددة |
+| [AI_CONTEXT.md](01_overview/AI_CONTEXT.md) | سياق موجز لأدوات الذكاء الاصطناعي |
+
+## 02_journeys_and_tutorials — رحلات المستخدم والتوتوريال
+سير الرحلة خطوة بخطوة (راكب وسائق) + خطة التوتوريال داخل الموقع.
+
+| الملف | المحتوى |
+|---|---|
+| [TUTORIAL_PLAN_AR.md](02_journeys_and_tutorials/TUTORIAL_PLAN_AR.md) | ⭐ خطة التوتوريال الكاملة مع قائمة لقطات الشاشة المطلوبة |
+| [PASSENGER_JOURNEY.md](02_journeys_and_tutorials/PASSENGER_JOURNEY.md) | دورة حياة الراكب كاملة (شاشات + APIs + حالات) |
+| [DRIVER_JOURNEY.md](02_journeys_and_tutorials/DRIVER_JOURNEY.md) | دورة حياة السائق كاملة |
+| [ride_simulation_report.md](02_journeys_and_tutorials/ride_simulation_report.md) | تقرير محاكاة رحلة الراكب |
+| [driver_ride_simulation_report.md](02_journeys_and_tutorials/driver_ride_simulation_report.md) | تقرير محاكاة رحلة السائق |
+| [syria_driver_registration_report.md](02_journeys_and_tutorials/syria_driver_registration_report.md) | تسجيل سائق سوريا |
+| ملفات `*_simulation.html` | محاكاة تفاعلية بالمتصفح (راكب/سائق/تسجيل/إدارة/نظام كامل) |
+
+## 03_pricing — محرك التسعير
+| الملف | المحتوى |
+|---|---|
+| [PRICING_ENGINE_ARCHITECTURE.md](03_pricing/PRICING_ENGINE_ARCHITECTURE.md) | معمارية محرك التسعير كاملة |
+| [pricing_system_report.md](03_pricing/pricing_system_report.md) | تقرير نظام التسعير |
+| [دراسة_نظام_أتمتة_السوق_الذكي.md](03_pricing/دراسة_نظام_أتمتة_السوق_الذكي.md) | أتمتة مراقبة المنافسين وإعادة التسعير |
+| [redis_state_plan.md](03_pricing/redis_state_plan.md) | خطة حالة الرحلة في Redis |
+
+## 04_features — الميزات الفنية والتنافسية
+| الملف | المحتوى |
+|---|---|
+| [COMPETITIVE_FEATURES.md](04_features/COMPETITIVE_FEATURES.md) | الميزات التنافسية مقابل كريم/أوبر/يلا-جو |
+| [TECHNICAL_ADVANTAGES_AR.md](04_features/TECHNICAL_ADVANTAGES_AR.md) | المزايا التقنية المبنية داخلياً |
+| [NEW_FEATURES_PROPOSAL_AR.md](04_features/NEW_FEATURES_PROPOSAL_AR.md) | مقترحات ميزات جديدة |
+| [AUDIO_MUSIC_FEATURES_AR.md](04_features/AUDIO_MUSIC_FEATURES_AR.md) | ميزات الصوت والموسيقى |
+| [BATTERY_PERFORMANCE_AR.md](04_features/BATTERY_PERFORMANCE_AR.md) | أداء البطارية والتحسينات |
+| [auto_carplay_checklist_arabic.md](04_features/auto_carplay_checklist_arabic.md) | Android Auto / CarPlay (عربي + [إنجليزي](04_features/auto_carplay_checklist.md)) |
+| [ai_document_extraction_prompt.md](04_features/ai_document_extraction_prompt.md) | برومبت استخراج الوثائق بالذكاء الاصطناعي |
+
+## 05_transit_mawasalati — نظام «مواصلاتي» (باصات الجامعات)
+| الملف | المحتوى |
+|---|---|
+| [transit_comprehensive_workflow_report.md](05_transit_mawasalati/transit_comprehensive_workflow_report.md) | ⭐ سير العمليات الكامل (الأحدث — 2026-07-14) |
+| [mawasalati_full_system_review.md](05_transit_mawasalati/mawasalati_full_system_review.md) | المراجعة الفنية الكاملة والفجوات المعروفة |
+| [mowasalaty_strategy_report.md](05_transit_mawasalati/mowasalaty_strategy_report.md) | التقرير الاستراتيجي (نموذج SaaS المجاني) |
+| [mawasalati_plan.md](05_transit_mawasalati/mawasalati_plan.md) | خطة التنفيذ الأصلية |
+
+## 06_investors — وثائق المستثمرين ودراسات الجدوى
+| الملف | المحتوى |
+|---|---|
+| [SIRO_INVESTOR_REPORT_AR.md](06_investors/SIRO_INVESTOR_REPORT_AR.md) | تقرير المستثمر الرئيسي |
+| [تقرير_المستثمر_الشامل_Siro.md](06_investors/تقرير_المستثمر_الشامل_Siro.md) | التقرير الشامل للمستثمر |
+| [Siro_Investors_Report_AR.md](06_investors/Siro_Investors_Report_AR.md) | تقرير مستثمرين (نسخة سابقة) |
+| [SIRO_INVESTOR_DECK.html](06_investors/SIRO_INVESTOR_DECK.html) | عرض المستثمرين التفاعلي |
+| [Siro_Feasibility_Study_v4.pdf](06_investors/Siro_Feasibility_Study_v4.pdf) | دراسة الجدوى v4 |
+| [Siro_Egypt_Competitive_Study_AR.md](06_investors/Siro_Egypt_Competitive_Study_AR.md) | دراسة سوق مصر التنافسية |
+| تقرير_سيرو_الكامل.docx | نسخة Word للمشاركة |
+
+> ⚠️ تنبيه حوكمة: يوجد سرديتان تمويليتان مختلفتان (180K$ سوريا مقابل 200K$/22% عامة) — يجب توحيدهما قبل أي عرض رسمي.
+
+## 07_marketing — التسويق والنمو
+| الملف | المحتوى |
+|---|---|
+| [SIRO_MARKETING_REPORT_AR.md](07_marketing/SIRO_MARKETING_REPORT_AR.md) | تقرير التسويق الرئيسي |
+| [marketing_and_growth_strategy.md](07_marketing/marketing_and_growth_strategy.md) | استراتيجية التسويق والنمو |
+| [marketing_integration_plan_ar.md](07_marketing/marketing_integration_plan_ar.md) | خطة التكامل التسويقي |
+| [damascus_zones_map.html](07_marketing/damascus_zones_map.html) | خريطة مناطق دمشق |
+
+## 08_security — الأمن ومراجعات الكود
+| الملف | المحتوى |
+|---|---|
+| [التقرير_الأمني_Backend_Siro.md](08_security/التقرير_الأمني_Backend_Siro.md) | التدقيق الأمني للباك اند (بنود مفتوحة!) |
+| [CODE_REVIEW_REPORT_AR.md](08_security/CODE_REVIEW_REPORT_AR.md) | مراجعة الكود الشاملة |
+
+## 09_reports — التقارير التفاعلية النهائية
+| الملف | المحتوى |
+|---|---|
+| [siro_digital_legacy_report.html](09_reports/siro_digital_legacy_report.html) | ⭐ تقرير الإرث الرقمي الشامل (يشمل مواصلاتي وسير الرحلة والتوتوريال) |
+
+## 99_archive — أرشيف
+| الملف | المحتوى |
+|---|---|
+| intaleq_v1_secure_latest.md | نسخة كود V1 المؤرشفة (1.2MB — مرجع تاريخي فقط) |