first commit: منصة Tripz — خطط كاملة + سكافولد باك إند NestJS/Docker

- 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>
This commit is contained in:
2026-07-16 15:22:06 +03:00
co-authored by Claude Opus 4.8
commit 95fea546f5
49 changed files with 1881 additions and 0 deletions
+50
View File
@@ -0,0 +1,50 @@
# 05 — تسعير المنتج وفوترة المستأجر
> فرّق بين شيئين: **[محرك التعرفة](04-tariff-engine.md)** يسعّر رحلة الراكب. **هذا الملف** يسعّر اشتراك المستأجر لدينا ويحسب فاتورته الشهرية.
## الموقع التسعيري مقابل السوق
| المنصة | الإعداد | شهرياً | لكل رحلة | الثغرة |
|--------|---------|--------|----------|--------|
| Onde | $4,500–23,000 | $99–259 | نسبة سرية، حد أدنى $0.10 | غموض + قفل + لا استضافة محلية |
| TaxiCaller | $0 | $20–28/مركبة | — | لا يكبر مع GMV، لا تعريب |
| **Tripz** | **$0–12,000** | **$0–599** | **نسبة معلنة، حد أدنى $0.02** | **الشفافية نفسها هي التمايز** |
## الباقات الأربع
| الباقة | الإعداد | شهرياً | GMV% | الجوهر |
|--------|---------|--------|------|--------|
| **انطلاقة** | $0 | $0 | 5% | مدينة المستأجر داخل تطبيقنا الجامع، لوحة + dispatch أساسي، حد أدنى $0.03/رحلة، سقف 90 يوماً أو 10k رحلة ثم ترقية |
| **علامة** ★ | $2,500 | $99 | 2.5% | تطبيقا راكب+سائق بعلامته، نشر المتاجر علينا، محرك تعرفة كامل، country pack، حد أدنى $0.02، دعم عربي |
| **أسطول+** | $5,000 | $199 | 2% | dispatch متقدم، بوابة شركات، حجز ويب، محافظ سائقين، API+Webhooks، تقارير متقدمة |
| **سيادة** | من $12,000 | $599 | 1% | نسخة معزولة داخل الدولة، بديل رسم/مركبة، واجهة المنظّم، SLA 99.9%، ضمان تصدير + خيار Escrow |
## خوارزمية الفوترة الشهرية
```
invoice = base_fee
+ max( min_monthly,
Σ rate(tier_i) × GMV(tier_i) ) // نسب هامشية تنازلية
شرائح GMV الشهرية (باقة «علامة»):
حتى $50,000 → 2.5%
$50k – $200k → 2.0%
فوق $200,000 → 1.5%
min_monthly = عدد الرحلات المكتملة × $0.02
```
## مثال محسوب — مشغّل عمّان
- 1,500 رحلة/يوم × 30 = **45,000 رحلة**، متوسط 2.2 دينار (≈$3.10) → **GMV ≈ $139,500**.
- فاتورة «علامة»: `$99 + (2.5%×50k) + (2.0%×89.5k)` ≈ **$3,139/شهر** (~2.3% فعلي).
- **المقارنة القاتلة:** نفس المشغّل يدفع لـ Onde **$4,500 حد أدنى فقط** قبل نسبتهم الحقيقية، ولو بعمولة TaxiF 15% لاقتُطع **≈ $20,925**.
## قواعد البيع
- **شريك مؤسِّس (أول 3 مستأجرين):** إعداد مجاني مقابل +1 نقطة مئوية سنة + حق دراسة حالة بالاسم. يحل «لا قصص نجاح بعد».
- **دفع سنوي مقدّم:** خصم 15% على الاشتراك.
- **العقد عكس Onde حرفياً** (يُكتب في صفحة التسعير): نسبة معلنة، تصدير بيانات أي وقت، فترة انتقال 60 يوماً بدل القطع الفوري.
- **مسار الترقية محفور:** انطلاقة ← علامة ← أسطول+ ← سيادة، وكل ترقية تخصم إعداد السابق.
## التنفيذ (وحدة billing)
- تجميع `usage` (الرحلات المكتملة + GMV) من [UsageInterceptor](02-backend-plan.md) شهرياً عبر BullMQ.
- توليد فاتورة PDF + سجل `invoices`.
- لوحة My Hub تعرض الفاتورة الجارية والتاريخية بشفافية كاملة.
← السابق: [04-tariff-engine](04-tariff-engine.md) · التالي: [06-tenant-model](06-tenant-model.md)