Files
tripz-llc/docs/00-overview.md
T
HamzaandClaude Opus 4.8 95fea546f5 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>
2026-07-16 15:22:06 +03:00

49 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 00 — نظرة عامة (الرؤية والنطاق)
## الرؤية بجملة واحدة
منصة نقل ذكي تُؤجَّر كـ **White-Label** لمشغّلي التكسي والأساطيل المرخّصة في دول متعددة، ببيانات تبقى داخل الدولة، وتعرفة شفافة، وخرائط ذاتية بلا فاتورة، وعربية أولاً.
## من نخدم (الجمهور)
- **المستأجر (Tenant):** مكتب تكسي / أسطول / مشغّل مرخّص يريد تطبيقاً بعلامته دون بناء فريق تقني.
- **مستخدموه:** الراكب، السائق، المشغّل (Dispatcher)، صاحب الشركة (Admin).
- **نحن:** مزوّد التقنية — لسنا مشغّل نقل ولا مسؤولين أمام هيئات النقل؛ المستأجر هو المرخّص.
## الواجهات الأربع (المخرجات البرمجية)
1. **تطبيق الراكب** (Flutter) — `apps/rider`.
2. **تطبيق السائق** (Flutter) — `apps/driver`.
3. **لوحة المستأجر / My Hub** (Web) — `dashboards/admin-web` — إدارة **مستأجر واحد**.
4. **لوحة السوبر-آدمن** (Web) — `dashboards/superadmin-web` — **مالك المنصة** يدير كل المستأجرين والتطبيقات وينشئها ويتابعها.
> فرق حاسم: `admin-web` لكل مستأجر (بياناته فقط)، و`superadmin-web` فوق الجميع (منظور المنصة).
## التمايز الأربعة (كل عرض بيعي يُبنى على واحد منها)
1. **الشفافية السعرية** — النسبة معلنة ومكتوبة، حد أدنى $0.02/رحلة (Onde: سرية + $0.10).
2. **السيادة** — استضافة داخل بلد المستأجر أو على خوادمه (وضع Enterprise).
3. **خرائط انطلق الذاتية** — بلا فاتورة Google Maps؛ سطر بيع: «خرائط غير محدودة مشمولة».
4. **العربية أولاً** — RTL حقيقي، دعم واتساب، محتوى ووثائق عربية.
## ما **داخل** النطاق (P1–P2 — الجوهر الضيق اللامع)
- دورة الرحلة الكاملة: طلب (فوري/مسبق) ← إسناد أقرب سائق ← تتبع حي ← دفع كاش ← تقييم.
- تطبيق السائق: تسجيل بالوثائق، عروض الطلبات، الأرباح.
- محرك تعرفة (4 أوضاع + نوافذ زمنية + surge بسقف + مناطق ثابتة).
- Dispatch هاتفي للمشغّل.
- لوحة إدارة (My Hub) للمستأجر.
- OTP/SMS ذاتي، دردشة رحلة، تقييم.
## ما **خارج** النطاق مبدئياً (P3 — يُباع كترقيات مدفوعة)
- المحفظة (Wallet) المتقدمة، Super App (التوصيل)، حجز الويب، Gamification، BI متقدم، حسابات الشركات المتقدمة.
- **قاعدة صارمة:** أي ميزة خارج P1/P2 لا تُبنى قبل أول عميل يدفع مقابلها.
## مبادئ التصميم الحاكمة
- **منتج موحّد لا مشاريع مخصصة:** كود واحد لكل المستأجرين؛ التخصيص = إعداد + هوية بصرية، لا كود جديد.
- **مستأجر جديد في يوم عمل واحد:** الهدف الصلب لكل قرار معماري ونشري.
- **كل ما يمكن جعله ديناميكياً يأتي من API** (نصوص، ميزات، دفع، تعرفة) — لا يتطلب إصدار متجر.
- **الامتثال ميزة تُباع لا عبء:** واجهة المنظّم الحكومي مُصمَّمة منذ البداية.
## المرجع التنافسي (لماذا نبني هذا)
- **Onde:** يخدم 200+ شركة، 9M طلب/شهر. نموذج: إعداد $4.5k–23k + $99–259/شهر + نسبة سرية (حد أدنى $0.10/طلب). نقاط ضعفه = فرصتنا (قفل تعاقدي، حد أدنى مرتفع، لا استضافة محلية، تعريب ضعيف).
- **TaxiF (الأردن) و يلا غو (سوريا):** كلاهما على Onde (مؤكَّد بفحص APK). كسر Onde يكسرهما معاً.
- **TaxiCaller:** نموذج «لكل مركبة» ($20–28/مركبة) — لا يكبر مع GMV، ولا تعريب.
← التالي: [01-architecture](01-architecture.md)