🌐 Release Scope: Admin Portal & Staff Portal
📌 1. Introduction #
The Route Optimization Module is a powerful delivery management solution designed to bring geographic intelligence into logistics operations.
✨ It enables:
- Automated route assignment
- Real-time delivery tracking
- Streamlined status workflows for riders & dispatchers
🔐 2. Module Activation & Security Configurations #
⚙️ Core Activation #
- 📍 Path: Admin Portal → Manage Modules
- 🔘 Toggle “Route Optimization Module” → YES
- ✅ Click Activate Module
👥 Granular Staff Permissions #
📍 Path: Staff Portal → User Management → Roles → Integrations
🔑 Permission Keys:
- 🔀 Route optimization redirect → Show/hide module menu
- 🗺️ View all order map → Global order visibility
- 📦 View unscheduled orders → Access pending queue
- 🚚 View routes → Monitor routes
- ➕ Create routes → Build delivery routes
- ✏️ Edit order status → Update order status
- 🔄 Show re-optimize → Recalculate route
📊 3. Interactive Route Optimization Module UI #
📍 Location: Integrations → Route Optimization
⚡ Note: Data loads only when the tab is clicked
🗺️ A. All Orders (Map View) #
🌍 Global visualization of delivery load
🔎 Default Filter:
- Assigned to Destination Rider
🎯 Visual Indicators:
- 🔵 Light Blue → Single order
- 🔷 Dark Blue → Clustered orders
📋 Pop-up Details:
- Waybill Number
- Status
- Customer Name
- Destination City
- Weight
- Rider
🧭 Navigation:
- Opens directly in Google Maps
🔄 Pagination:
- Next / Previous for multiple orders
📦 B. Unscheduled Orders #
🎯 Main dispatcher workspace
📌 Eligible Orders:
- Assigned to Destination Rider
- Received by Destination Rider
- Not assigned to a route
🔍 Filters:
- Waybill
- Merchant
- Cities
- Customer
- Weight
- Order Date
- Status Change Date
🛠️ Route Creation Workflow #
1️⃣ Select Rider (Mandatory)
2️⃣ Select Orders (Checkbox / Bulk)
3️⃣ Click Add Route
⚙️ Route Setup:
- Date
- Start Time
- End Time
- Start/End Branch (Auto default)
🚚 C. Routes #
📊 Route management hub
🪪 Route Card Info:
- Route ID
- Rider
- Date
- Parcel Count
- Progress Bar
🔄 Route Status Lifecycle #
- 🟢 Optimized → Created
- 🟡 In Progress → Started
- 🔵 Completed → All orders done
🧠 4. Deep-Dive Route Management #
🗺️ Geographic Pathing #
✨ Intelligent sequencing:
- Road-side logic (minimize U-turns)
🎛️ Map Controls:
- Toggle markers
- Toggle route line
- Toggle warehouse locations
📏 Metrics:
- Distance (KM)
- Total stops
🔄 Re-optimization #
📌 Trigger when:
- Order added
- Cancelled
- Rescheduled
➡️ Click Re-optimize to recalculate best route
📦 5. Status Workflow & Finalization #
⚠️ Mandatory Requirement:
- All orders must be Out for Delivery before finalization
✅ Final Status Options #
📬 Delivered #
- ✔️ Successful delivery
- 📸 Upload up to 4 POD images
📦 Partially Delivered #
- ✔️ Partial completion
- 💰 Enter adjusted COD
- 📝 Select reason
❌ Failed to Deliver #
- ✔️ Delivery failed
- 📝 Reason required
🔁 Rescheduled #
- ✔️ Postponed delivery
- 📝 Reason + New Date required
🔄 6. Returns & Last-Mile Operations #
✨ New operational actions added:
📦 Return Reschedules to Destination Warehouse #
- For future delivery processing
📦 Return Failed Orders to Destination Warehouse #
- For return to the merchant/origin
🎯 Summary #
This release introduces a fully intelligent routing ecosystem with:
🚀 Automated route planning
📊 Real-time tracking
🧠 Smart optimization
🔄 Dynamic recalculation
📦 Complete delivery lifecycle control
