مندوبي
تطبيق توصيل منشور على Google Play يجمع العميل والمندوب والمتجر مع لوحة إدارة ويب: طلب مندوب أو مشتريات خاصة، متابعة الطلب على الخريطة، حساب عمولات المناديب والمتاجر، وإشعارات فورية
- الدور
- تصميم الهوية البصرية + تطوير النظام كامل
- السنة
- 2025 – 2026
- المنصات
- Android · iOS · Web
- Google Play
- تطبيق منشور ومتاح للتحميل
- 3 أدوار
- عميل، مندوب، ومتجر شريك
- خرائط حية
- تحديد المسار وتتبع المندوب
- لوحة إدارة
- متابعة الطلبات والمدفوعات
فكرة المشروع
المشكلة واحتياج السوق
تطبيقات التوصيل المحلية تحتاج تنسيقا لحظيا بين ثلاثة أطراف (العميل، المندوب، المتجر) مع إدارة سعة المندوب لما يستلم أكتر من طلب في نفس الخط، وحساب العمولات وصافي الربح ومراجعة إيصالات الدفع بدون تضارب
معمارية النظام
مكونات وطبقات النظام
تطبيق Flutter (أندرويد و iOS عبر Codemagic) + تطبيق ويب تقدمي PWA (React/TypeScript/Workbox) + لوحة إدارة ويب مستقلة (React/Vite/Leaflet) فوق Supabase/PostgreSQL و 12 Edge Function وإشعارات FCM موثقة
Mobile & PWA Surfaces
تجربة العميل والمندوب والمتجر
- Flutter App (Android / iOS)
- React + TypeScript PWA (Workbox)
- Live Map (flutter_map / Leaflet)
- Apple & Phone Auth
Admin Operations Console
لوحة إدارة من المتصفح لمتابعة الطلبات والمناديب
- mandobi-admin (React + Vite)
- Driver Capacity & Bulk Activation
- Atomic Payment Request Review
- Excel Reporting Export
Supabase Backend & Push Engine
قواعد البيانات، الدوال، وإشعارات FCM
- 25 SQL Migrations + RLS
- 12 Deno Edge Functions
- Idempotent Order & Rating RPCs
- FCM Notification Router
قاعدة البيانات
هيكل البيانات وأهم الجداول
مخطط يدعم الطلبات الفردية والرحلات المجمعة (Guaranteed Trip Batches) مع محافظ مالية وطلبات شحن ومراجعات إدارية ذرية
| الجدول | الدور داخل النظام |
|---|---|
profiles / drivers | بيانات المستخدمين، حالة تفعيل المندوب، وسعة الطلبات المتزامنة |
orders / rejection_queue | الطلبات، تسعير التوصيل، العمولة الثابتة، وصافي ربح المندوب |
guaranteed_trip_routes / batches | خطوط السير المضمونة وتجميع الطلبات في دفعات |
transactions / promotions | حركات المحفظة، إيصالات الدفع، والعروض الترويجية |
تفاصيل التنفيذ
أهم الحلول والقرارات التقنية
ضبط سعة المندوب للطلبات المتعددة داخل قاعدة البيانات
بدل الاعتماد على فحص الواجهة فقط عند إسناد طلب جديد لمندوب لديه طلبات نشطة، تتحقق دوال قاعدة البيانات من الحد الأقصى للطلبات المتزامنة وتمنع التجاوز تحت الضغط المتزامن
مراجعة طلبات الدفع في عملية ذرية واحدة (Atomic Review)
اعتماد إيصال الدفع من لوحة الإدارة يحدث حالة الطلب ويضيف الرصيد لمحفظة المندوب/المستخدم ويسجل القيد المالي داخل Transaction واحدة غير قابلة للتجزئة
توحيد توجيه الإشعارات عبر FCM ومنع التكرار
إلغاء مسارات الإشعارات القديمة وتوجيه كل أحداث الطلبات والرسائل عبر Edge Functions موثقة إلى Firebase Cloud Messaging مع مفاتيح عدم تكرار (Idempotency) لمنع إرسال الإشعار مرتين
الأمان والصلاحيات
تأمين البيانات والصلاحيات
- تقليص سطح الـ RPC العام (`reduce_public_rpc_surface`) وقصر تنفيذ دوال تدفق الطلبات على الأدوار المصرح لها فقط
- تأمين إنشاء الحسابات وتوجيه الأدوار والـ wallets لمنع تصعيد الصلاحيات من واجهة العميل
- مسار رسمي لطلبات حذف الحساب والبيانات متوافق مع متطلبات Google Play و App Store
من داخل الكود
نمط المراجعة الذرية لطلبات شحن المحفظة (PL/pgSQL)
CREATE OR REPLACE FUNCTION public.review_payment_request(
p_request_id uuid,
p_decision text,
p_note text DEFAULT NULL
) RETURNS void
LANGUAGE plpgsql SECURITY DEFINER SET search_path = public AS $$
BEGIN
IF NOT public.is_admin(auth.uid()) THEN
RAISE EXCEPTION 'forbidden: admin role required';
END IF;
-- Lock row to prevent concurrent double-crediting
PERFORM 1 FROM public.payment_requests WHERE id = p_request_id AND status = 'pending' FOR UPDATE;
-- Update status + credit wallet + append transaction in one transaction
END; $$; واجهات النظام
لقطات شاشة من داخل النظام
شاشات تطبيق الموبايل
الهوية البصرية والرسوم التوضيحية
ملخص المشروع
النتيجة وحالة التشغيل
منشور على Google Play (`com.mandobi.app` — الإصدار `1.0.45+63`) مع خط بناء iOS على Codemagic ولوحة إدارة ويب للعمليات