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>
76 lines
3.4 KiB
Markdown
76 lines
3.4 KiB
Markdown
# 08 — نموذج البيانات
|
|
|
|
> PostgreSQL 16 + PostGIS. **كل جدول عملياتي فيه `tenant_id`** (عدا الجداول العالمية المعلّمة 🌐). فهارس مكانية للسائقين القريبين ومناطق التعرفة.
|
|
|
|
## الجداول الأساسية
|
|
|
|
### الاستئجار
|
|
```
|
|
🌐 tenants id, name, slug, country_pack, plan, mode(shared|sovereign),
|
|
branding jsonb, features jsonb, status, created_at
|
|
🌐 country_packs code, config jsonb (أو ملفات في المستودع)
|
|
tenant_config tenant_id, key, value (تجاوزات ديناميكية)
|
|
```
|
|
|
|
### المستخدمون والأدوار
|
|
```
|
|
users id, tenant_id, phone, name, role(rider|driver|dispatcher|admin),
|
|
status, created_at
|
|
drivers id, tenant_id, user_id, vehicle_id, docs jsonb, verification_status,
|
|
rating, is_online, last_location geography(Point) ← فهرس GIST
|
|
vehicles id, tenant_id, driver_id, plate, model, service_class, color, docs
|
|
```
|
|
|
|
### الرحلات
|
|
```
|
|
trips id, tenant_id, rider_id, driver_id, service_class,
|
|
origin geography(Point), destination geography(Point),
|
|
status, tariff_version, quoted_fare, final_fare, currency,
|
|
payment_method, requested_at, assigned_at, completed_at
|
|
trip_events id, trip_id, tenant_id, from_status, to_status, source,
|
|
payload jsonb, created_at ← سجل الانتقالات (تشخيص + منظّم)
|
|
ratings id, tenant_id, trip_id, by_role, stars, comment
|
|
chat_messages id, tenant_id, trip_id, sender_id, body, created_at
|
|
```
|
|
|
|
### التعرفة والمناطق
|
|
```
|
|
tariffs id, tenant_id, city, service_class, definition jsonb,
|
|
version, active_from, active
|
|
pricing_zones id, tenant_id, name, area geography(Polygon) ← فهرس GIST
|
|
zone_matrix id, tenant_id, from_zone, to_zone, price
|
|
```
|
|
|
|
### الدفع والفوترة
|
|
```
|
|
payments id, tenant_id, trip_id, provider, amount, currency, status, tx_ref
|
|
payouts id, tenant_id, driver_id, amount, period, status
|
|
usage id, tenant_id, period, completed_trips, gmv, currency ← يغذّي الفوترة
|
|
invoices id, tenant_id, period, base_fee, gmv_fee, min_applied,
|
|
total, status, pdf_url ← فاتورتنا للمستأجر
|
|
```
|
|
|
|
### الإشعارات والتكامل
|
|
```
|
|
device_tokens id, tenant_id, user_id, fcm_token, platform
|
|
webhooks id, tenant_id, url, events[], secret, active
|
|
```
|
|
|
|
## العلاقات (مبسّطة)
|
|
```
|
|
tenant 1─* users 1─1 drivers 1─* vehicles
|
|
tenant 1─* trips *─1 rider(users) trips *─1 driver(drivers)
|
|
trip 1─* trip_events trip 1─1 payment trip 1─* chat_messages
|
|
tenant 1─* tariffs tenant 1─* pricing_zones
|
|
tenant 1─* usage 1─1 invoice(period)
|
|
```
|
|
|
|
## قواعد
|
|
- **الهجرات فقط** (migrations)؛ لا `synchronize` في الإنتاج.
|
|
- **فهارس GIST** على كل عمود `geography`.
|
|
- **فهرس مركّب** يبدأ بـ `tenant_id` على الجداول عالية الاستعلام (trips, users, drivers).
|
|
- **soft-delete** (`deleted_at`) لا حذف صلب — بيانات المنظّم والتدقيق.
|
|
- الحضور اللحظي وموقع السائق الجاري في **Redis** (لا Postgres) — راجع [09-realtime](09-realtime.md).
|
|
|
|
← السابق: [07-integrations](07-integrations.md) · التالي: [09-realtime](09-realtime.md)
|