Hamza-AyedandClaude Opus 5
92dc6b3641
نسخة كاملة من مستودع سيرو عند ecfe7568 لتكون أساس تطبيق «انطلق». نُسخ المتعقَّب في git فقط (12,509 ملفاً / 302 م.ب) بـ git archive، لا `cp -r` — فاستُثنيت تلقائياً مخلفات البناء (build · node_modules · .dart_tool · .gradle · Pods ≈ 10.7 غ.ب) وكل ما يستثنيه .gitignore. هذا الكوميت **بلا أي تعديل عمداً** حتى يكون كل ما يليه فرقاً مقروءاً مقابل سيرو الأصلي. سيرو نفسه لم يُمسّ. ⚠️ لا يبني بعد: `.env` و`lib/env/env.g.dart` غير متعقَّبين في سيرو (وهذا صحيح — أسرار لكل مستأجر). كل تطبيق فلاتر هنا يحتاج .env خاصاً بانطلق ثم توليد env.g.dart عبر build_runner. لا تُنسخ أسرار سيرو. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
103 lines
8.3 KiB
Markdown
103 lines
8.3 KiB
Markdown
# 📚 مركز توثيق منصة 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 — وثائق المستثمرين ودراسات الجدوى
|
|
| الملف | المحتوى |
|
|
|---|---|
|
|
| [rebuild_cost_estimate_egypt_2026.md](06_investors/rebuild_cost_estimate_egypt_2026.md) | ⭐ دراسة كلفة إعادة البناء في مصر (فريق + AI، 2026) |
|
|
| [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 — مرجع تاريخي فقط) |
|