tripz-llc/docs/project-tree.md

🌳 شجرة المستودع الكاملة (المرجع البنائي)

هذا هو الشكل المستهدف للمونوريبو بعد 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)

1. P0: backend (nest new + tenant/usage) → mobile (core + rider/driver skeleton) → infra/CI → flavor تجريبي ثانٍ.
2. P1: trips + matching + tariff + realtime + شاشات الرحلة + admin-web أساسي.
3. P2: dispatch + pricing-zones + billing + regulator + landing + الحاسبة.
4. P3: التوصيل + حجز الويب + BI + country packs جديدة.

← العودة إلى README