أحمد الصعيديProduct & Systems Engineer
← كل المشاريع البرمجية
منصة وتطبيق توصيل متعدد الأدوار
مباشرمشروع عميل

مندوبي

تطبيق توصيل منشور على 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 موثقة

L1

Mobile & PWA Surfaces

تجربة العميل والمندوب والمتجر

  • Flutter App (Android / iOS)
  • React + TypeScript PWA (Workbox)
  • Live Map (flutter_map / Leaflet)
  • Apple & Phone Auth
L2

Admin Operations Console

لوحة إدارة من المتصفح لمتابعة الطلبات والمناديب

  • mandobi-admin (React + Vite)
  • Driver Capacity & Bulk Activation
  • Atomic Payment Request Review
  • Excel Reporting Export
L3

Supabase Backend & Push Engine

قواعد البيانات، الدوال، وإشعارات FCM

  • 25 SQL Migrations + RLS
  • 12 Deno Edge Functions
  • Idempotent Order & Rating RPCs
  • FCM Notification Router
التقنيات — الأدوات والتقنيات المستخدمة:
  • Flutter
  • Dart
  • Supabase
  • PostgreSQL
  • Row Level Security
  • Edge Functions (Deno)
  • Firebase Messaging
  • React
  • Vite
  • TypeScript
  • PWA / Workbox
  • Codemagic

قاعدة البيانات

هيكل البيانات وأهم الجداول

مخطط يدعم الطلبات الفردية والرحلات المجمعة (Guaranteed Trip Batches) مع محافظ مالية وطلبات شحن ومراجعات إدارية ذرية

الجدول الدور داخل النظام
profiles / drivers بيانات المستخدمين، حالة تفعيل المندوب، وسعة الطلبات المتزامنة
orders / rejection_queue الطلبات، تسعير التوصيل، العمولة الثابتة، وصافي ربح المندوب
guaranteed_trip_routes / batches خطوط السير المضمونة وتجميع الطلبات في دفعات
transactions / promotions حركات المحفظة، إيصالات الدفع، والعروض الترويجية

تفاصيل التنفيذ

أهم الحلول والقرارات التقنية

01

ضبط سعة المندوب للطلبات المتعددة داخل قاعدة البيانات

بدل الاعتماد على فحص الواجهة فقط عند إسناد طلب جديد لمندوب لديه طلبات نشطة، تتحقق دوال قاعدة البيانات من الحد الأقصى للطلبات المتزامنة وتمنع التجاوز تحت الضغط المتزامن

02

مراجعة طلبات الدفع في عملية ذرية واحدة (Atomic Review)

اعتماد إيصال الدفع من لوحة الإدارة يحدث حالة الطلب ويضيف الرصيد لمحفظة المندوب/المستخدم ويسجل القيد المالي داخل Transaction واحدة غير قابلة للتجزئة

03

توحيد توجيه الإشعارات عبر FCM ومنع التكرار

إلغاء مسارات الإشعارات القديمة وتوجيه كل أحداث الطلبات والرسائل عبر Edge Functions موثقة إلى Firebase Cloud Messaging مع مفاتيح عدم تكرار (Idempotency) لمنع إرسال الإشعار مرتين

الأمان والصلاحيات

تأمين البيانات والصلاحيات

  • تقليص سطح الـ RPC العام (`reduce_public_rpc_surface`) وقصر تنفيذ دوال تدفق الطلبات على الأدوار المصرح لها فقط
  • تأمين إنشاء الحسابات وتوجيه الأدوار والـ wallets لمنع تصعيد الصلاحيات من واجهة العميل
  • مسار رسمي لطلبات حذف الحساب والبيانات متوافق مع متطلبات Google Play و App Store

من داخل الكود

نمط المراجعة الذرية لطلبات شحن المحفظة (PL/pgSQL)

supabase/migrations/20260714204000_atomic_admin_payment_review.sql · SQL
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 ولوحة إدارة ويب للعمليات

المشروع التالي تم (TEMM) → بيئة عمل لإدارة المهام وأدوات الذكاء الاصطناعي

جلسة تقييم تقنية · مصر / الخليج / عن بُعد

محتاج تبني نظام تشغيل، تنقذ مشروع AI، أو تبدأ عقد تطوير شهــــــــــري؟

حدد نوع المطلوب ومرحلة المشروع والميزانية التقريبية في نموذج التقييم خلال 30 ثانية عشان نبدأ الكلام بخطة معمارية عملية مباشرة.