Hamza-AyedandClaude Opus 5
8976821a93
## تعذّر حساب الأجرة — الخطأ في التطبيق لا في جدول الكازان الخادم يبذر التعرفة بـ city: 'default' (tenants.service.ts:156) ويستعمل dto.city ?? 'default' عند إنشاء الرحلة، وكنت أرسل city: '' فيرجّع 404 «No active tariff for /economy». تحقّق حيّ: city='default' → total 1.55 JOD ✅ city='' → 404 ❌ city='amman' → 404 ❌ لا تغيير مطلوب على السيرفر. أُضيف AppConfig.defaultCity موثّقاً بالسبب. ## التسعير مرة واحدة لكل الأنواع كان نداء شبكة عند كل ضغطة نوع. صار _priceAll يسعّر كل الأنواع بالتوازي بعد اكتمال المسار — المسافة والمدة ثابتتان والفرق في التعرفة وحدها. الراكب يرى سعر الاقتصادي والمريح معاً تحت كل خيار ويقارن بنظرة، وتبديل النوع بلا نداء. ## الكاميرا لا تتبع الموقع سببان: الموقع يصل قبل إنشاء الخريطة فيضيع التحريك، ولا فحص للإذن/الخدمة قبل getCurrentPosition فيُبتلع الخطأ صامتاً. - _onCreated يلحق بما فات عند جهوز الخريطة - LocationService.ensureReady يفحص الخدمة والإذن أولاً - didChangeAppLifecycleState يعيد المحاولة عند العودة من إعدادات النظام - حالة noLocation تُعرض للمستخدم مع زر إعادة بدل خريطة صامتة ## الخريطة والتنقّل - إطار المسار من حدوده الفعلية مع حشوة سفلية بمقدار ما تغطّيه الورقة - علامتا البداية والنهاية دائرتان ملوّنتان تطابقان ألوان الخط الزمني - زر رجوع في ورقة التأكيد + زر إعادة حساب عند فشل التسعيرة: كان المستخدم يعلق في الشاشة بلا مخرج ## المحفظة — على أي أساس يُشحن POST /wallet/topup شحنٌ تجريبي بلا مزوّد دفع خلفه (الخادم نفسه يصفه كذلك). أُضيف PaymentChannel مشتقّاً من countryPack المستأجر لا من لغة الجهاز: jo → CliQ · sy → سيرياتيل/MTN/شام كاش · eg → PayMob. ويُعرض تنبيه صريح بأن الشحن بلا تحصيل فعلي — إخفاؤه يجعل المستخدم يظنّ أنه دفع. وسحب السائق صار يستعمل القناة المختارة بدل 'cliq' المكتوبة في الكود. flutter analyze نظيف في التطبيقين. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Tripz — منصة نقل ذكي متعددة المستأجرين (White-Label)
منصة SaaS لتأجير تطبيقات نقل بعلامة تجارية خاصة لكل مستأجر (مكتب تكسي / أسطول / مشغّل مرخّص) في دول متعددة. تُبنى لتكسر نموذج Onde عبر أربع فجوات: الشفافية السعرية، الاستضافة داخل الدولة (السيادة)، خرائط انطلق الذاتية (بلا فاتورة خرائط)، والعربية أولاً.
هذا الفولدر هو حجر الأساس التخطيطي للمشروع قبل كتابة أي كود. كل ملف هنا يجيب عن سؤال واحد: ماذا نبني، وكيف، وبأي ترتيب.
القرارات المحسومة (لا نقاش فيها عند البناء)
| الطبقة | القرار | لماذا |
|---|---|---|
| الباك إند | NestJS 11 + TypeORM + PostgreSQL/PostGIS + Redis | باك إند انطلق مبني به أصلاً وفيه Tenant + Usage جاهزان |
| الـ Realtime | Socket.IO Gateway (@nestjs/websockets) + redis-adapter | لغة واحدة، فريق واحد، توسّع أفقي |
| الموبايل | Flutter + flutter_bloc (Cubit افتراضياً، Bloc لدورة الرحلة والعروض) | قابلية اختبار وتدقيق لمنتج يُرخّص + قرب من عقلية GetX |
| التوجيه/الحقن | go_router + get_it | معيار صناعي مقبول |
| الخرائط | انطلق (Martin tiles + geocoding + routing ذاتي) | الخندق التنافسي: بلا اعتماد على Google |
| الاستئجار | قاعدة واحدة + tenant_id (قياسي)، ونسخة معزولة (وضع سيادة) | أرخص تشغيلاً + منتج مضاد لثغرة Onde |
تفاصيل كل قرار في docs/02-backend-plan.md وdocs/03-mobile-plan.md.
خريطة الوثائق
ابدأ من الأعلى للأسفل. كل ملف مستقل لكنه يشير للبقية.
| # | الملف | يجيب عن |
|---|---|---|
| 00 | نظرة عامة | الرؤية، الجمهور، التمايز، ما ليس ضمن النطاق |
| 01 | البنية | كيف تتحدث الأنظمة معاً (مخطط عام) |
| 02 | الباك إند | وحدات NestJS، الطبقات، الحرّاس |
| 03 | الموبايل | هيكل فلاتر، الحالة، الشاشات، الـ flavors |
| 04 | محرك التعرفة | كيف نسعّر الرحلة (JSON قواعد) |
| 05 | تسعير المنتج والفوترة | الباقات وخوارزمية فاتورة المستأجر |
| 06 | نموذج الاستئجار | tenant_id، وضع السيادة، حزم الدول |
| 07 | التكاملات | الدفع، OTP/SMS، واجهة المنظّم، Webhooks |
| 08 | نموذج البيانات | الجداول الأساسية والعلاقات |
| 09 | الطبقة الحية | قنوات Socket، الحضور، الإسناد |
| 10 | خطة التنفيذ | P0→P3 بالأسابيع وشروط الخروج |
| 11 | النشر والأتمتة | CI، flavors، fastlane، البيئات |
| 12 | اللاندنج والبيع | الموقع، قنوات البيع بلا إعلانات |
| 13 | المخاطر والقرارات المفتوحة | ما يحتاج حسم المالك |
| 14 | اصطلاحات السيرفر والعزل | قرارات تشغيلية محسومة: البادئة، Redis DB، سيرفر مشترك، سيرو |
| 🌳 | شجرة المستودع | البنية الكاملة للمجلدات والملفات |
البدء السريع (عند جهوزية القرار)
- اقرأ 00-overview → 01-architecture.
- احسم القرارات المفتوحة (الاسم، سوق الانطلاق، دور سيرو).
- نفّذ P0 — تأسيس الـ Monorepo.
- تابع الشجرة المرجعية في project-tree.
الحالة: تخطيط · آخر تحديث: 2026-07-16 · الاسم المؤقت: Tripz