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

4.3 KiB
Raw Blame History

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