UmmahBD Docs
Production v1.0 β€” Live at bd-courier.futuregenit.com

UmmahBD Express Delivery
Technical Documentation

A full-stack courier management SaaS platform for Dhaka city merchants β€” real-time booking, automated billing, hub routing, and comprehensive financial reporting. Built by FutureGen iT.

355
Active Merchants
25
Live Bookings
12H
COD Settlement SLA
2020
Est. Year
Overview

Project Overview

UmmahBD Express Delivery is a web-based courier management system designed for small-to-medium e-commerce merchants in Bangladesh. It efficiently manages the complete delivery lifecycle, including merchant onboarding, parcel booking, hub assignment, delivery man (DV Man) tracking, and automated Cash on Delivery (COD) settlement. The platform is developed using PHP with the CodeIgniter framework for a lightweight and high-performance backend structure. It utilizes MySQL for secure and scalable database management, along with Bootstrap for responsive and mobile-friendly UI design. jQuery is integrated for dynamic frontend interactions and smooth user experience. Additionally, the system incorporates RESTful APIs for seamless data communication, role-based access control for security, and optimized server-side processing to handle high-volume courier operations efficiently.

bd-courier.futuregenit.com
UmmahBD Homepage
Platform Objectives
  • β€Ί Centralized parcel booking & live tracking
  • β€Ί Automated COD collection and merchant settlement
  • β€Ί Hub-based delivery network with DV Man routing
  • β€Ί Full financial reporting: earning, expense, balance
  • β€Ί Multi-merchant self-service portal
Service Coverage
  • β€Ί Jatrabari, Dhanmondi, Uttara, Mohammadpur
  • β€Ί Badda, Khilgaon, Lalbagh β€” Inside Dhaka
  • β€Ί Outside Dhaka Home Delivery (130 TK / Up to 1Kg)
  • β€Ί Nationwide via SB/SA partners (planned)
  • β€Ί Main office: Jatrabari, Dhaka β€” Est. October 2020
Capabilities

Key Features

πŸ“¦

Parcel Booking

Multi-field entry with COD, category (Inter Dhaka / Outside), merchant order ID, receiver, and delivery charge.

🚚

Pickup Management

Hub-based pickup scheduling with status flow, pickupman assignment, and parcel counting.

πŸ—ΊοΈ

Hub Assignment

Route bookings to DV Man or Hub. Batch "Assign By Hub" workflow for efficient operations.

πŸ’³

Merchant Billing

Per-merchant ledger with DV/Return, Pending, Payment History, Unpaid COD, and delivery charges.

πŸ“Š

Earning Reports

Date-range earning reports: Total COD, DV Charge, Commission. Export to Excel.

πŸ”

Public Parcel Tracking

Customers track any booking by ID on the public homepage β€” no login required.

🏦

Customer Balance

Full merchant balance sheet with company, mobile, and outstanding amounts. Excel export.

πŸ’°

Expense Tracking

Categorized operational expenses per hub with daily totals and date-range filtering.

πŸ‘₯

User & Role Management

Role-based access, user list with search, DV Man to Hub assignment, Active/Inactive status.

Architecture

System Architecture

Three-tier web application: public landing portal, merchant dashboard, and full admin control panel sharing one backend API and database.

Public Website
bd-courier.futuregenit.com
  • β€Ί Hero slider + Tracker
  • β€Ί Pricing plans
  • β€Ί Merchant Registration
  • β€Ί About Us / Contact
  • β€Ί Merchant Login
Shared REST API + Database
CodeIgniter / PHP Backend
RESTful API Layer
Session / Auth Middleware
MySQL 8.x Database
Admin Dashboard
…/dashboard/dashboard
  • β€Ί Pickup, Booking, Assignment
  • β€Ί Merchant Billing & COD
  • β€Ί Employee & DV Man
  • β€Ί Expense Tracking
  • β€Ί Reports & Analytics
  • β€Ί User Role Management
Stack

Technology Stack

🎨
Frontend
HTML5 / CSS3
Bootstrap / Tailwind
βš™οΈ
Backend
Laravel / PHP 8.1+
MVC + RESTful API
πŸ—„οΈ
Database
MySQL 8.x
Relational, Indexed
☁️
Hosting
FutureGen Servers
Linux / Nginx / Apache
Public Portal

Homepage

URL: bd-courier.futuregenit.com

bd-courier.futuregenit.com
Homepage content
Navigation Menu
  • β€Ί HOME, ABOUT US, PRICING
  • β€Ί REGISTRATION β€” new merchant signup
  • β€Ί LOGIN β€” merchant portal
  • β€Ί CONTACT β€” support information
Homepage Components
  • β€Ί Full-width hero image slider
  • β€Ί Public parcel tracking by Booking ID
  • β€Ί Quick Admin Sign In widget
  • β€Ί Company info, Mission, Background
  • β€Ί USP: 12H cash, Parcel Insurance, 24H support
Pricing

Pricing Plans

URL: bd-courier.futuregenit.com/pricing

Inside Dhaka β€” Registered Merchants Only
TimingBelow 500gUp to 1KgUp to 3Kg
Next Day (24–48H)60 TK70 TK95 TK
Same Day (8H)100 TK130 TK150 TK
Off day (Holidays & Weekends): Next Day β€” 60 TK / 70 TK
Outside Dhaka Delivery
TimingBelow 500gUp to 1KgUp to 2Kg
Next Day (48–72H) Conditionβ€”β€”β€”
Next Day (48–72H) Home Deliveryβ€”130 TKβ€”
⚠ Outside Dhaka: Not currently available for direct service
bd-courier.futuregenit.com/pricing
Pricing page
Onboarding

Merchant Registration

URL: bd-courier.futuregenit.com/registration

…/registration
Registration form
Registration Form Fields
  • β€Ί Full Name (required)
  • β€Ί Company Name (required)
  • β€Ί Mobile Number (required)
  • β€Ί Email Address (required)
  • β€Ί Address (required)
  • β€Ί Terms of Payment β€” Cash (Condition apply)
βœ… Admin reviews and activates the merchant account before portal access is granted.
Authentication

Merchant Login

URL: bd-courier.futuregenit.com/login

…/login
Login page
Login Fields
  • β€Ί Username field with user icon
  • β€Ί Password field with lock icon
  • β€Ί "SIGN IN" blue button
  • β€Ί Full-page nature background
Session Handling

Session-based authentication. Merchant redirected to personal dashboard post-login. Admin sign-in available on homepage sidebar.

Admin Panel

Admin Dashboard

URL: bd-courier.futuregenit.com/dashboard/dashboard

…/dashboard/dashboard
Admin dashboard
355
Merchants
β€”
Assigned DV Man
β€”
Assigned HUB
0
Today Bookings
β€”
Status Update
β€”
Merchant Bill
Sidebar Navigation Modules
🏠 Dashboard
🚚 Pickup
πŸ’³ Merchant Billing
πŸ“¦ Booking (List/DV/HUB)
πŸ‘€ Employee
πŸ’° Expense
πŸ“Š Report
βš™οΈ System Management
πŸ–₯️ Fronted Setting
πŸ‘₯ User Management
πŸ’¬ Contact Message
🌐 Global Setting
Operations

Pickup Module

URL: …/booking/booking/getpickuplist

Pick Entry Form
Pick entry form
Pick Entry Form Fields
  • β€Ί Select Hubs β€” e.g., Jatrabari
  • β€Ί Pickup Date β€” auto-filled
  • β€Ί Status β€” "Waiting for Pickup" default
  • β€Ί Merchant β€” searchable dropdown
  • β€Ί Counting β€” parcel count
  • β€Ί Reason β€” free text notes
  • β€Ί Pickupman β€” assign staff
List shows: Hubs, Company, DV Man, Reason, Action columns.
Finance

Merchant Billing

URL: …/merchant_bill/merchentbill/getuserld

Merchant Report
Merchant billing
Merchant Report Metrics
MetricDescription
DV/ReturnDelivered + returned parcels for the merchant
PendingParcels in transit awaiting delivery confirmation
Payment HistoryFull log of previous COD settlements
Unpaid CODCOD collected but not yet remitted to merchant
Table Columns#, Date, B.N#, Book To, Merchant Order No, Address, Reason, Contact, COD Amount, Update COD, DV Charge, 1%, Rec. Amt, Status
Core Module

Booking Management

URL: …/booking/booking/getbookingList

Booking List
Booking list
Booking List
  • β€Ί Columns: S.L, Print, Booking ID, Status, Paid Type, Date, Company, Rece. Name, Assign By, Hubs, Amount
  • β€Ί Search: Booking ID, date, company, receiver name
  • β€Ί Filter: Status, Payment Type, Hub, Delivery Man
Total: 25 Paid: 0 Unpaid: 25 Waiting: 25
Entry Booking Form
  • β€Ί Receive Date, Merchant (searchable)
  • β€Ί Phone, Receiver Name, Address
  • β€Ί Package Description, COD Amount
  • β€Ί Category (Inter Dhaka / Outside), Delivery Charge
  • β€Ί Instruction, Merchant Order ID
Booking ID:19 β€” Edit Modal
Booking edit modal
Routing

Booking Assignment

Assign To HUB

Search by Booking ID, then batch-assign to hub using "ASSIGN BY HUB" button.

Assign To HUB
Assign to HUB
Process To Paid

Batch payment confirmation modal β€” mark selected bookings as "Paid" in one action.

Paid Type Modal
Process to paid
Finance

Expense Tracking

URL: …/expense/expense/getExpense

Expense Entry Form
Expense form
Form Fields
  • β€Ί Entry Date β€” auto-filled
  • β€Ί Amount β€” numeric
  • β€Ί Category β€” predefined list
  • β€Ί Select Hubs β€” assign to hub
  • β€Ί Description β€” free text
List shows: S.L, Date, Category, Hubs, Amount, Description β€” with daily Total Sum.
Analytics

Reports Module

Customer Balance Details

Full merchant ledger by company. Exportable to Excel.

report/customer_balance
Customer balance

Earning Report

Date-range filtered: Booking ID, Status, COD, DV Charge, Commission.

report/setdeliveryReport
Earning report
Earning Report Summary
25
Total Bookings
2,395
Total COD
2,025
DV Charge
1
Commission
2,026
Total Earning
Users

User Management

user/user/getUserList
User list
User List
  • β€Ί Search by Name, Phone, Email
  • β€Ί Filter: Active / Inactive
  • β€Ί Columns: #, SL, Name, Company, Mobile
  • β€Ί EDIT per row, Add new user via "+"
DV Man β†’ Hub Assignment
DV Man Assign To Hubs
DV Man hub assignment
Process

Delivery Workflow

1
Merchant Registration
Self-registers via website. Admin reviews and activates account.
2
Parcel Booking
Admin/merchant books parcel with COD, category, receiver info, delivery charge.
3
Pickup Scheduling
Pickup entry created. Pickupman assigned per hub.
4
Hub Assignment
Booking assigned to DV Man or Hub for last-mile delivery.
5
Delivery Attempt
DV Man attempts delivery. Status updated: Delivered / Returned.
6
COD Settlement
COD collected. Admin marks payment status. Merchant billing updated.
7
Financial Reporting
Earning report, customer balance, and expense summary generated.
Access Control

Roles & Permissions

RoleAccess PortalCapabilitiesStatus
Super AdminDashboard (full)All modules: booking, billing, reports, users, system settingsActive
AdminDashboard (limited)Booking, pickup, billing, expense β€” no user managementActive
MerchantMerchant LoginOwn bookings, parcel tracking, billing summary, pickup submissionActive
Delivery ManHub / MobileView assigned parcels, update delivery statusPlanned
GuestPublic WebsiteTrack parcel by ID, view pricing, registerActive
Security

Security Considerations

πŸ” Authentication
  • β€Ί Session-based login with server-side invalidation
  • β€Ί Password hashing (bcrypt / Argon2)
  • β€Ί Role-gated route middleware on all admin endpoints
πŸ›‘οΈ Data Protection
  • β€Ί HTTPS enforced (SSL/TLS) on all routes
  • β€Ί Input validation & sanitization (XSS / SQL injection)
  • β€Ί CSRF token protection on all POST forms
πŸ—„οΈ Database Security
  • β€Ί Eloquent ORM β€” no raw SQL queries
  • β€Ί DB credentials in environment variables (.env)
  • β€Ί Regular automated backups
πŸ“‹ Audit & Compliance
  • β€Ί Activity logging for critical admin operations
  • β€Ί Booking history immutable after submission
  • β€Ί Excel export for external audit trail
Infrastructure

Deployment Instructions

Server Requirements
ComponentSpec
OSUbuntu 22.04 LTS
Web ServerNginx or Apache 2.4+
PHPPHP 8.1+ (pdo, mbstring, openssl)
DatabaseMySQL 8.0+
CacheRedis (optional β€” sessions)
SSLLet's Encrypt / Custom Cert
Deployment Steps
1
Clone repo to /var/www/ummahbd
2
Copy .env.example β†’ .env, set DB credentials + APP_URL
3
Run composer install --no-dev then php artisan key:generate
4
Run php artisan migrate --seed
5
Configure Nginx vhost pointing to /public
6
chmod -R 775 storage bootstrap/cache
Reviews

What Our Clients Say

International clients and local merchants share their experience with UmmahBD Express and FutureGen iT.

"
β˜…β˜…β˜…β˜…β˜…

"The booking system transformed how we manage Dhaka deliveries. Real-time tracking, automated billing, and the merchant dashboard saved us hours weekly. Truly enterprise-grade."

JH
James Harrison
Operations Director, SwiftCart UK
Manchester, United Kingdom πŸ‡¬πŸ‡§
"
β˜…β˜…β˜…β˜…β˜…

"We evaluated 4 platforms before choosing FutureGen iT's solution. The COD settlement and merchant balance reporting are exactly what we needed. Clean, responsive, well-documented."

SR
Sarah Reynolds
Head of Logistics, TradeBridge Inc.
Austin, Texas, USA πŸ‡ΊπŸ‡Έ
"
β˜…β˜…β˜…β˜…β˜…

"The depth of the admin panel impressed me most. Hub assignment, earning reports β€” all there. FutureGen iT delivered on time and provided excellent post-launch support."

LM
Liam Morgan
CTO, PackEx Solutions
London, United Kingdom πŸ‡¬πŸ‡§
"
β˜…β˜…β˜…β˜…β˜†

"As a Dhaka e-commerce seller, UmmahBD changed everything. The 12-hour cash delivery promise is real β€” never missed it for us. Tracking keeps our customers happy without extra calls."

RK
Rakib Karim
Founder, Books Time BD
Dhaka, Bangladesh πŸ‡§πŸ‡©
"
β˜…β˜…β˜…β˜…β˜…

"Solid architecture. We white-labeled this for our logistics company in under a month. FutureGen iT's documentation and onboarding were excellent β€” a very professional team."

AP
Anika Patel
Product Manager, DeliveryOS
Birmingham, UK πŸ‡¬πŸ‡§
"
β˜…β˜…β˜…β˜…β˜…

"Scalable courier SaaS from day one. The earning report and customer balance modules save our finance team 3 hours every settlement cycle. Highly recommended for growing operations."

DW
Daniel Walsh
VP Operations, GlobalShip Ltd.
New York, USA πŸ‡ΊπŸ‡Έ
Contact

Support & Contact

Technical questions, feature requests, or custom deployment inquiries β€” reach our team directly.

Developed & Maintained by FutureGen iT
Technical questions, feature requests, custom development, white-label licensing
futuregenit.com
Full-stack web development Bangladesh