Hamza-AyedandClaude Opus 5
66e28acc58
## التقييم مفروض لا اختياري
SessionCubit يفحص GET /trips/rating/pending بعد إثبات الجلسة، ووجود رحلة
معلّقة يحجز التطبيق كله عند /rating حتى تُحسم. دور المستخدم في الرحلة يأتي
من الخادم لا من نوع التطبيق — نفس الرقم قد يكون له حسابان (docs/38 §1).
التقييم المزدوج يرجّع 400، وهو نجاح من منظور المستخدم: الرحلة مُقيَّمة فعلاً
فلا يُحبس في شاشة بلا مخرج.
الجلسة تحتاج معرفة التقييم المعلّق، و core لا يجوز أن يستورد ميزة التقييم —
فأُضيفت الطريقة لواجهة SessionSource ونفّذها AuthRepository.
## core/format/money.dart
كل المبالغ تصل نصوصاً ("0.000")؛ التحويل والعرض من نقطة واحدة. عدد المنازل
من العملة (JOD ثلاث)، والعملة من إعداد المستأجر لا من ثابت في التطبيق.
## المحفظتان لا تُوحَّدان
- الراكب WalletPage: رصيد + شحن = التزام على المنصّة
- السائق EarningsPage: أرباح + سحب = إيراد له
شكلهما متقارب وحسابهما مختلف؛ دمجهما خطأ محاسبي لا اختصار (docs/39 §4).
## السحب بخطوتين
request يرسل رمزاً بلا خصم، و confirm هو ما يخصم ويحجز. شاشة سيرو كانت خطوة
واحدة ولم تُقلَّد. الرمز الخاطئ لا يُرجع المستخدم لخطوة المبلغ.
الرصيد التشغيلي معروض منفصلاً عن الأرباح: منه تُخصم العمولة ونفاده يوقف
وصول الطلبات — خلطه بالأرباح يخفي سبب توقّف العمل عن السائق.
FareSummary يعرض رقم كلّ طرف: price_for_passenger للراكب و price_for_driver
للسائق — حقلان منفصلان والفرق عمولة (docs/38 §4).
الإلغاء بتأكيد صريح مع سبب؛ السبب لا يقبله عقد الخادم بعد لكن السؤال يخفض
الإلغاء العرضي ويجهّز الحقل.
flutter analyze نظيف · الراكب 86 ملف/6,280 سطر · السائق 83 ملف/5,818 سطر.
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