HamzaandClaude Opus 4.8
95fea546f5
- docs/00-15: دراسة، بنية، محرك تعرفة، تسعير، نموذج استئجار، تكاملات، بيانات، realtime، خطة، devops، لاندنج، مخاطر، اصطلاحات سيرفر، تدفق نشر - backend/: NestJS 11 على Docker (health + tenants + عزل tenant_id + بادئة tripz_ + Redis DB 3) - apps/rider, apps/driver, dashboards/admin-web, dashboards/superadmin-web (هياكل) - sync-to-server.sh + .gitignore Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
5.6 KiB
5.6 KiB
🌳 شجرة المستودع الكاملة (المرجع البنائي)
هذا هو الشكل المستهدف للمونوريبو بعد P0. ابنِ نحوه تدريجياً. الرموز: ★ = آلة حالة Bloc كاملة، 🌐 = عالمي بلا tenant_id.
Tripz/
├── README.md
├── docs/ # ← أنت هنا (الخطط)
│
├── backend/ # NestJS — [02] [08] [09]
│ ├── src/
│ │ ├── main.ts
│ │ ├── app.module.ts
│ │ ├── common/
│ │ │ ├── tenant/ # TenantGuard, scoped repo, @Tenant() [06]
│ │ │ ├── usage/ # UsageInterceptor (من انطلق) [05]
│ │ │ ├── guards/ interceptors/ filters/ pipes/ decorators/
│ │ ├── config/ # ConfigModule + country-packs loader [06]
│ │ ├── modules/
│ │ │ ├── auth/ tenants/ users/ drivers/
│ │ │ ├── trips/ # ★ آلة حالة الرحلة (مصدر الحقيقة) [02]
│ │ │ ├── matching/ # Redis GEO [09]
│ │ │ ├── tariff/ # محرك التعرفة [04]
│ │ │ ├── dispatch/ maps/ payments/ billing/
│ │ │ ├── pricing-zones/ notifications/ regulator/ webhooks/ admin/
│ │ ├── realtime/ # Socket.IO Gateway + redis adapter [09]
│ │ ├── jobs/ # BullMQ processors [09]
│ │ ├── database/
│ │ │ ├── entities/ # [08]
│ │ │ ├── migrations/
│ │ │ └── seeds/ # مستأجر تجريبي للديمو [12]
│ │ └── integrations/ # [07]
│ │ ├── payments/ sms/ regulator/ registry.ts
│ ├── test/ # e2e + اختبار عزل المستأجر [11]
│ ├── docker-compose.yml # postgres/postgis, redis, martin, api, worker
│ ├── Dockerfile
│ └── package.json
│
├── mobile/ # Flutter — [03]
│ ├── packages/
│ │ └── tripz_core/ # مشترك
│ │ └── lib/
│ │ ├── models/ network/ maps/ tariff/ theme/ l10n/ config/
│ ├── apps/
│ │ ├── rider/
│ │ │ └── lib/
│ │ │ ├── main_<flavor>.dart app.dart
│ │ │ ├── core/ # DI (get_it), router (go_router), dio
│ │ │ ├── data/ domain/
│ │ │ └── features/
│ │ │ ├── auth/ home/
│ │ │ ├── trip/ # ★ TripBloc + شاشات دورة الرحلة [03]
│ │ │ ├── chat/ rating/ profile/ settings/ wallet/(P3)
│ │ └── driver/
│ │ └── lib/
│ │ └── features/
│ │ ├── auth/ registration/
│ │ ├── offers/ # ★ OffersBloc [03]
│ │ ├── active-trip/ earnings/ profile/
│ ├── flavors/<tenant>/ # config.json + assets/ + store/ [11]
│ ├── fastlane/ # Fastfile (build/deploy lanes) [11]
│ └── melos.yaml # إدارة المونوريبو (اختياري)
│
├── admin-web/ # لوحة My Hub (Web) — [02] admin module
│ └── src/ # React/Next أو Flutter Web
│
├── landing/ # اللاندنج + الحاسبة + صفحة التسعير — [12]
│ └── src/ # Next.js/Astro (منفصل عن المنصة)
│
├── country-packs/ # حزم الدول — [06]
│ ├── jo.yaml sy.yaml
│ └── legal/{jo,sy}/{terms,privacy}.md
│
├── infra/ # [11]
│ ├── docker/ k8s/(للسيادة) terraform/(اختياري)
│ └── github-actions/ # خطوط CI
│
└── contracts/ # عقود SaaS مضادة لـ Onde (ar/en) — [10]
خريطة «ملف الخطة ← مجلد الكود»
| الخطة | يتحقق في |
|---|---|
| 02 backend | backend/src/modules, common |
| 03 mobile | mobile/apps, packages/tripz_core |
| 04 tariff | backend/src/modules/tariff |
| 05 billing | backend/src/modules/billing, common/usage |
| 06 tenant | backend/src/common/tenant, country-packs |
| 07 integrations | backend/src/integrations |
| 08 data | backend/src/database |
| 09 realtime | backend/src/realtime, matching, jobs |
| 11 devops | infra, mobile/fastlane, flavors |
| 12 landing | landing, admin-web |
ترتيب البناء المقترح (يتبع 10-roadmap)
- P0:
backend(nest new + tenant/usage) →mobile(core + rider/driver skeleton) →infra/CI→ flavor تجريبي ثانٍ. - P1:
trips+matching+tariff+realtime+ شاشات الرحلة +admin-webأساسي. - P2:
dispatch+pricing-zones+billing+regulator+landing+ الحاسبة. - P3: التوصيل + حجز الويب + BI + country packs جديدة.
← العودة إلى README