Hamza-AyedandClaude Opus 5
35a66935aa
Storing the verification phone as a keyed HMAC fixed OTP lookups but broke every query that joined those tables back to the account, because phone_verification*.phone_number no longer holds the same value as driver.phone / passengers.phone. Six joins were affected, and four of them feed the `verified` flag that the rider and driver apps check at sign-in — so this was already failing under the current CBC mode, not only after a switch to GCM. Accounts now carry phone_key, computed exactly as otpPhoneKey() does, and the joins match on it. It is written at registration for both apps and populated for existing rows by the backfill. The backfill also covers the columns added for the remaining lookups: users.email_bidx/phone_bidx and driver.national_bidx, which were migrated but never populated, and honours a per-field prefix so phone_key reproduces otpPhoneKey's exact output. Insert column/value counts verified with a paren-aware parser after editing. 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 — مرجع تاريخي فقط) |