اطلب مشروعك
نظام إدارة طلبات التوصيلمنفّذ ومستخدم يومياً

نظام توصيل الأكبر

لصالح: الأكبر للتوصيل · بغداد

نظام ويب متكامل يدير دورة حياة طلب التوصيل كاملة، من إنشائه عند المتجر حتى تسليمه وتسوية حساباته، عبر ثلاث لوحات منفصلة للمدير والمتجر والمندوب.

Delivery order management systemBuilt and in daily use

Al-Akbar Delivery System

For: Al-Akbar Delivery · Baghdad

A complete web system that manages the whole delivery order lifecycle, from the store creating the order to final delivery and financial settlement, through three separate dashboards for the manager, the stores and the couriers.

المشكلة

قبل النظام كانت الطلبات تُنسَّق بالاتصال وتطبيقات المراسلة، بلا نظام موحّد يتابع حالة كل طلب لحظة بلحظة. فكانت تفاصيل الطلبات تضيع أحياناً، ويصعب معرفة أين وصل كل طلب.

والأهم غياب طريقة دقيقة لمعرفة من يستحق كم: كم بذمة كل مندوب من أموال المتاجر، وكم تستحق كل متجر من المدير. وتزداد الصعوبة مع الطلبات المدفوعة إلكترونياً حين تُشمل أجرة التوصيل بالمبلغ، فيجب خصمها من الطرفين بدقة ومرة واحدة فقط.

الحل

بنينا تطبيق ويب متجاوباً بواجهة عربية كاملة وثلاث لوحات حسب الدور: المدير يرى كل شيء ويدير الحسابات، المتجر ينشئ طلباته ويتابعها، والمندوب يستلم الطلبات المعيّنة له ويحدّث حالتها. يمرّ كل طلب بدورة حياة واضحة (قيد الموافقة، معيّن، بالطريق، تم التسليم، فشل، راجع) وتنعكس فوراً على كل الأطراف بإشعارات لحظية.

الجزء الأهم تقنياً هو محرك «كشف الحسابات»: يحسب تلقائياً وباستمرار كم بذمة كل مندوب وكم تستحق كل متجر، مع معالجة خاصة لأجرة التوصيل في الطلبات المدفوعة إلكترونياً، بآلية «استهلاك مرة واحدة» تضمن ألا يتكرر أي خصم.

الميزات الرئيسية

  • إنشاء طلبات التوصيل ومتابعة حالتها لحظة بلحظة، بما فيها الطلبات المجدولة والطلبات من مصادر خارجية.
  • ثلاث لوحات منفصلة بالكامل (مدير / متجر / مندوب)، وكل طرف يرى ما يخصه فقط.
  • محادثة مباشرة داخل كل طلب بين المندوب والمتجر، مع إخفاء هوية المندوب الحقيقية عن المتجر ومنع إرسال رقم هاتف شخصي عبر المحادثة.
  • كشف حسابات تلقائي ولحظي لديون المناديب ومستحقات المتاجر.
  • إشعارات فورية (Push) وتحديثات لحظية داخل التطبيق.
  • تتبع مواقع المناديب على خريطة تفاعلية.
  • تقارير شهرية: عدد الطلبات، أرباح كل مندوب، والصرفيات.
  • تسجيل الرواجع (الطلبات الفاشلة) ومتابعتها حتى تأكيد رجوعها للمتجر.

الأدوار والصلاحيات

المديررؤية شاملة لكل الطلبات والمتاجر والمناديب، وإدارة التسويات والتقارير والصرفيات، ومتابعة مواقع المناديب، ومراجعة كل المحادثات بما فيها الهوية الكاملة للمندوب.
المتجرينشئ طلباته ويتابعها فقط، ويؤكد استلام مستحقاته، ويحادث المندوب المكلّف بطلبه دون معرفة هويته الحقيقية.
المندوبيستلم الطلبات المعيّنة له ويحدّث حالتها، ويتابع دينه المستحق للمدير بالتفصيل، ويحادث المتجر ويشارك موقعه أثناء التوصيل.

النتيجة

  • النظام قيد الاستخدام اليومي الفعلي لإدارة طلبات توصيل حقيقية بين المدير والمتاجر والمناديب.
  • يُحسَّن باستمرار بناءً على ملاحظات الاستخدام الحقيقي.
  • أثناء التطوير اكتُشف وصُحّح خلل محاسبي حقيقي كان يحتسب خصم أجرة التوصيل الإلكتروني أكثر من مرة، وعُولج بآلية «استهلاك مرة واحدة» جُرّبت على بيانات حقيقية.

التقنيات

الواجهة الخلفيةNode.js · Express · PostgreSQL · JWT · Socket.IO · Web Push · Nodemailer · Helmet
الواجهة الأماميةReact 18 · Vite · React Router · Axios · Socket.IO Client · Leaflet (خرائط)
البنية التحتيةDocker · Railway · GitHub

الحالة الحالية

منفّذ ومستخدم فعلياً في العمل اليومي.

  • مصمَّم لخدمة جهة توصيل واحدة (وليس منصة متعددة الجهات).
  • الواجهة محسّنة للموبايل مع دعم جيد لشاشات الحاسبة.
  • يعمل كتطبيق ويب تقدّمي (PWA) يُضاف لشاشة الموبايل الرئيسية، وليس تطبيقاً أصلياً في المتاجر.

لقطات من النظام

لوحة المدير (الصفحة الرئيسية)
لوحة المدير (الصفحة الرئيسية): كل الطلبات بحالاتها مع فلترة وبحث وأزرار إجراء سريعة (إعادة تعيين، إلغاء، عرض المواقع، فتح المحادثة).
لوحة المتجر
لوحة المتجر: نموذج إنشاء طلب بثوانٍ، وقائمة الطلبات السابقة، وكشف حساب مختصر بعد خصم أجرة التوصيل الإلكتروني تلقائياً.
لوحة المندوب
لوحة المندوب: الدين المستحق للمدير مع تفصيل سبب الخصم، وبطاقة الطلب الحالي بأزرار تحديث حالته.
المحادثة داخل الطلب
المحادثة داخل الطلب: قناة مباشرة ومؤرشفة بين المندوب والمتجر، مرئية بالكامل للمدير.
كشف الحسابات (لوحة المدير)
كشف الحسابات (لوحة المدير): تسوية تلقائية ولحظية لمستحقات كل متجر ودين كل مندوب، بدون حساب يدوي.

The problem

Before the system, orders were coordinated by phone calls and messaging apps, with no single way to track each order's status in real time. Order details were sometimes lost, and it was hard to know where an order actually was.

Most importantly, there was no reliable way to calculate who owed what: how much cash each courier held on behalf of the stores, and how much each store was owed by the manager. This got harder with electronically paid orders, where the delivery fee is bundled into the payment and must be deducted from both sides precisely, and only once.

The solution

We built a responsive web app with a fully Arabic interface and three role-based dashboards: the manager sees and manages everything, stores create and track their own orders, and couriers receive assigned orders and update their status. Each order moves through a clear lifecycle (awaiting approval, assigned, out for delivery, delivered, failed, returned) that reaches everyone instantly through live notifications.

The technical core is the automatic ledger engine: it continuously computes how much each courier holds and how much each store is owed, with special handling for the delivery fee on electronically paid orders, using a consume-once pattern that guarantees no deduction is ever applied twice.

Key features

  • Create delivery orders and follow their status in real time, including scheduled orders and orders from external sources.
  • Three fully separate dashboards (manager / store / courier), each side seeing only what concerns it.
  • Direct in-order chat between courier and store, with the courier's real identity hidden from the store and sharing a personal phone number blocked.
  • Automatic, real-time ledger of courier debts and store balances.
  • Instant push notifications and live in-app updates.
  • Live courier locations on an interactive map.
  • Monthly reports: order counts, per-courier earnings, and expenses.
  • Tracking of returns (failed deliveries) through to confirmed hand-back to the store.

Roles and permissions

ManagerFull visibility into every order, store and courier; manages settlements, reports and expenses; tracks courier locations; and reviews every conversation, including the courier's real identity.
StoreCreates and tracks only its own orders, confirms receipt of what it is owed, and chats with the courier on its order without seeing the courier's real identity.
CourierReceives assigned orders and updates their status, follows the detailed debt owed to the manager, chats with the store, and shares location while delivering.

Outcome

  • The system is in actual daily use, managing real delivery orders between the manager, stores and couriers.
  • It keeps being refined from real-world feedback.
  • During development a real accounting bug was found and fixed: the electronic delivery-fee deduction was sometimes applied more than once. It was corrected with a consume-once mechanism tested on real data.

Technologies

BackendNode.js · Express · PostgreSQL · JWT · Socket.IO · Web Push · Nodemailer · Helmet
FrontendReact 18 · Vite · React Router · Axios · Socket.IO Client · Leaflet (maps)
InfrastructureDocker · Railway · GitHub

Current status

Built and in daily production use.

  • Designed to serve a single delivery business (not a multi-business platform).
  • The interface is optimized for mobile, with solid support for desktop screens.
  • It runs as a Progressive Web App (added to the phone's home screen), not a native app in the app stores.

System screenshots

Manager dashboard (home)
Manager dashboard (home): every order and status with filtering, search and quick actions (reassign, cancel, view locations, open chat).
Store dashboard
Store dashboard: a quick order-creation form, order history, and a short balance summary after the electronic delivery fee is deducted automatically.
Courier dashboard
Courier dashboard: the amount owed to the manager with a breakdown of the deduction, and the current order card with status-update actions.
In-order chat
In-order chat: a direct, archived channel between courier and store, fully visible to the manager.
Account ledger (manager dashboard)
Account ledger (manager dashboard): automatic, real-time settlement of what each store is owed and each courier owes, with no manual calculation.

عندك مشروع مثل هذا؟Have a project like this?

اكتب لنا ما يحتاجه عملك، وسنرد عليك.Tell us what your business needs, and we will reply.

اطلب مشروعك