Hamza-AyedandClaude Opus 5
39b5a7fc7f
Storing the verification phone as a keyed HMAC made OTP lookups independent of the encryption mode, but the hash is one-way — and customer service reads those same rows to chase people who requested a code and never finished registering. That workflow would have lost the number entirely. The verification tables now carry both forms: phone_number holds the lookup key, and a new phone_enc column holds the encrypted number, which is decryptable when a human needs to call. The two follow-up queries also compared the verification row against the driver/passengers tables and the notes tables by matching ciphertext, which only ever worked because encryption was deterministic. Under GCM every number would have looked unregistered and every note would have disappeared. Both now read the number from phone_enc and match on normalised plaintext, so they are correct under either mode. Rows written before phone_enc existed are skipped rather than shown without a number. 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 — مرجع تاريخي فقط) |