SmartRoute Pro
A Digital B2B Ordering & Sales Operations Platform for FMCG Distribution
Built With
📋 Project Overview
The idea behind SmartRoute Pro came from a simple observation: traditional FMCG distribution relies heavily on phone calls, WhatsApp messages, paper-based processes, spreadsheets, and manual reporting.
SmartRoute Pro is designed to bring these processes together into a **centralized digital platform** where retailers can place orders, sales representatives can manage their outlets and routes, distributors can coordinate fulfillment, and administrators can monitor the entire operation from a single system.
The goal is not simply to build an ordering application.
**The goal is to build a complete digital operating layer for FMCG distribution.**
---
## The Problem
FMCG distribution involves many moving parts.
Retailers need to place orders.
Sales representatives need to visit outlets and generate orders.
Distributors need to manage stock and fulfillment.
Drivers need to deliver orders.
Sales Team Leads need visibility into field performance.
Technicians need to manage cooler and equipment issues.
Administrators need to manage users, products, routes, distributors, and system configuration.
When these processes are handled through disconnected tools, important information becomes difficult to track.
SmartRoute Pro addresses this challenge by creating a **role-based ecosystem connecting the different stakeholders involved in the distribution process.**
---
# SmartRoute Pro Ecosystem
The platform is designed around multiple operational roles, each with its own responsibilities and dashboard.
### Retailers
Retailers can:
* Create and manage their accounts
* View available products
* Browse product categories
* Place orders
* Track order status
* View order history
* Download invoices
* Monitor payment information
* Report cooler or equipment faults
* Request promotional materials
* Communicate operational issues
The objective is to give retailers a convenient **self-service ordering experience** while reducing dependence on manual order collection.
---
### Account Developers / Sales Representatives
The field sales team is one of the most important components of SmartRoute Pro.
Account Developers can:
* View assigned routes
* View assigned outlets
* Plan daily outlet visits
* Check in to outlets
* Capture GPS location
* Generate orders
* Place orders on behalf of retailers
* Record outlet stock
* Inspect coolers
* Upload outlet photos
* Record competitor information
* Capture customer complaints
* Register new outlets
* Monitor outlet activity
* Generate field reports
This transforms the traditional field sales process into a **digital sales execution workflow**.
---
### Sales Team Leads
Sales Team Leads provide operational supervision across the sales territory.
Their responsibilities include:
* Monitoring Account Developers
* Managing sales routes
* Tracking outlet coverage
* Monitoring sales performance
* Reviewing orders
* Monitoring distributor operations
* Tracking targets
* Following up on stock availability
* Coordinating operational issues
* Monitoring field activity
* Generating performance reports
The objective is to provide management with visibility beyond individual orders and into the overall performance of the sales operation.
---
### Distributor / Depot Management
SmartRoute Pro also introduces a digital layer for distributor operations.
Distributor and depot users can manage:
* Incoming orders
* Order processing
* Stock availability
* Order fulfillment
* Delivery preparation
* Sales reconciliation
* Product inventory
* Routes
* Drivers
* Daily operations
* Distributor performance
This creates a bridge between **sales generation and order fulfillment**.
---
### Salesman / Driver
Drivers and salesmen can access the orders assigned to them and manage the delivery process.
The workflow can include:
**Order Received → Processing → Assigned → Dispatched → Delivered → Reconciled**
This provides better visibility into the movement of orders from the distributor to the retailer.
---
### Cooler Technician
FMCG businesses often depend heavily on coolers and other assets installed at retail outlets.
SmartRoute Pro incorporates equipment management so technicians can:
* View reported faults
* Track service requests
* Update repair status
* Record maintenance activities
* Manage assigned jobs
* Maintain equipment history
This creates a digital maintenance trail for customer-facing assets.
---
### System Administrator
The System Administrator provides centralized control over the platform.
Administrative capabilities include:
* User management
* Role management
* Distributor management
* Route management
* Product management
* Sales Team Lead assignment
* Account Developer assignment
* Technician assignment
* Route assignment
* Distributor configuration
* Product configuration
* System settings
* Reporting and monitoring
The administrator effectively controls the operational structure of the entire platform.
---
# Core Features
## B2B Product Ordering
Retailers can browse products and place orders through a dedicated digital ordering interface.
The ordering workflow is designed around the realities of FMCG distribution, including product quantities, cases, order status, fulfillment, and delivery.
---
## Field Sales Management
Account Developers can manage their outlet portfolio directly from the platform.
Instead of relying on spreadsheets or handwritten notes, sales activities become structured digital records.
This creates a historical record of:
* Outlet visits
* Orders
* Stock observations
* Customer complaints
* Competitor activity
* Cooler inspections
* Photos
* New outlet registrations
---
## Route Management
Routes form an important part of the sales operation.
SmartRoute Pro allows administrators and sales managers to structure territories into routes and assign field personnel accordingly.
This provides a foundation for:
* Route planning
* Outlet allocation
* Sales coverage
* Field accountability
* Performance monitoring
---
## GPS-Based Field Visits
Field activity can be associated with geographical coordinates to help verify outlet visits.
This introduces an additional layer of accountability and enables future functionality such as:
* Visit verification
* Route visualization
* Outlet mapping
* Geographic sales analysis
* Territory optimization
---
## Outlet Management
Each retailer can have a digital profile containing operational information such as:
* Business details
* Contact information
* Assigned route
* Sales representative
* Order history
* Visit history
* Stock information
* Equipment information
* Complaints
* Activity history
This creates a centralized **360° view of each outlet**.
---
## Inventory & Product Management
The platform is designed to provide structured product management across the distribution ecosystem.
Products can contain information such as:
* Product name
* Category
* SKU
* Packaging
* Unit/case information
* Pricing
* Availability
* Stock levels
* Product status
This provides a foundation for future inventory intelligence and automated stock management.
---
## Order Lifecycle Management
SmartRoute Pro is designed around a structured order lifecycle.
A typical workflow can move through:
**Draft → Submitted → Confirmed → Processing → Dispatched → Delivered → Completed**
This allows different users to interact with an order according to their responsibilities while maintaining a single source of truth.
---
## Cooler & Asset Management
The platform incorporates customer equipment management, allowing businesses to track assets installed at outlets.
This can include:
* Cooler registration
* Asset identification
* Fault reporting
* Technician assignment
* Repair status
* Maintenance history
* Outlet association
* Photos
---
# Technology Stack
SmartRoute Pro is being developed using a modern web application architecture.
### Backend
**PHP**
The core server-side programming language powering the application.
**Laravel**
The primary backend framework, providing the application's architecture, routing, authentication, validation, database interaction, queues, APIs, and business logic.
### Database
**MySQL**
Used as the primary relational database for storing users, retailers, products, orders, routes, distributors, visits, inventory, equipment, and operational records.
### Frontend
**HTML5**
Provides the semantic structure of the application.
**CSS3**
Used for styling and responsive interfaces.
**JavaScript**
Provides client-side interactions and dynamic functionality.
**Bootstrap**
Used as part of the UI foundation to create responsive and consistent interfaces.
### APIs & Integrations
The architecture is designed to support API-driven communication and future integrations such as:
* Mobile applications
* Payment gateways
* SMS notifications
* WhatsApp communication
* Mapping and GPS services
* Third-party business systems
### Payment Integration
The platform is being designed with **M-Pesa integration** in mind, including support for an **STK Push payment workflow** for applicable transactions.
This is particularly important for the Kenyan market, where mobile payments are deeply integrated into everyday commerce.
---
# Architecture
SmartRoute Pro is being developed with maintainability and scalability in mind.
The application follows Laravel's structured architecture and separates responsibilities across areas such as:
* Models
* Controllers
* Services
* Requests
* Policies
* Middleware
* Database migrations
* Seeders
* Jobs
* Notifications
* APIs
* Views
The goal is to avoid building a tightly coupled application that becomes difficult to maintain as the platform grows.
Instead, SmartRoute Pro is being designed as a **modular business platform** capable of evolving alongside the operational requirements of an FMCG organization.
---
# Security & Access Control
Because the platform handles business-critical information, access control is a major consideration.
SmartRoute Pro uses a role-based approach to determine what each user can access and what actions they can perform.
For example:
**Retailers** should see their own businesses and orders.
**Account Developers** should see their assigned outlets and routes.
**Sales Team Leads** should have broader visibility over their sales teams.
**Distributors** should manage their operational data.
**Administrators** should have system-wide control.
This approach helps maintain data isolation while ensuring that every user receives the tools relevant to their role.
---
# Reporting & Business Intelligence
A major objective of SmartRoute Pro is turning operational activity into usable business information.
Future reporting capabilities include:
* Sales performance
* Order volumes
* Outlet activity
* Route performance
* Sales representative performance
* Product performance
* Distributor performance
* Outlet activation
* Customer growth
* Visit coverage
* Stock movement
* Delivery performance
* Target achievement
The long-term vision is to move beyond simple reporting toward **data-driven decision making**.
---
# Designed for Growth
SmartRoute Pro is being developed with the understanding that an FMCG business may start with a relatively small number of users and eventually grow into thousands of retailers, sales representatives, products, orders, and transactions.
The architecture therefore considers:
* Database scalability
* API readiness
* Modular application design
* Role-based authorization
* Queue-based processing
* Notification systems
* Audit trails
* Reporting
* Mobile integration
* Third-party integrations
The platform can ultimately evolve into a larger **FMCG Distribution Management System** rather than remaining just an ordering portal.
---
# My Role
SmartRoute Pro represents my work across multiple areas of software engineering, including:
* Product conceptualization
* Business process analysis
* System architecture
* Database design
* UI/UX planning
* Backend development
* Frontend development
* Authentication and authorization
* Role-based access control
* API architecture
* Database modelling
* Integration planning
* Testing
* Deployment planning
One of the most valuable aspects of this project is that it is being designed around **real-world business workflows rather than simply building features for the sake of features.**
---
# Current Development Status
🚧 **SmartRoute Pro is currently an ongoing project.**
The platform is being developed incrementally, beginning with the core MVP functionality and expanding toward a more comprehensive FMCG sales and distribution ecosystem.
The development approach focuses on delivering the platform in manageable modules while maintaining a strong foundation for future expansion.
Planned areas of evolution include:
* Advanced analytics
* Mobile applications
* M-Pesa payments
* Automated notifications
* Advanced route optimization
* Real-time delivery tracking
* Inventory intelligence
* Customer segmentation
* Advanced reporting
* API integrations
* Expanded distributor management
* Automated business workflows
---
# The Bigger Vision
SmartRoute Pro is more than an online ordering system.
It is an attempt to answer a larger question:
**What would FMCG distribution look like if the entire sales and fulfillment process was connected digitally?**
From the moment a retailer places an order to the moment that order reaches the customer's doorstep, SmartRoute Pro aims to create visibility across the entire journey.
**Retailer → Sales Representative → Distributor → Depot → Driver → Delivery → Reconciliation**
Every stage can generate data.
Every interaction can become measurable.
And every process can become more efficient.
That is the vision behind SmartRoute Pro.
---
## Technologies
**PHP · Laravel · MySQL · HTML5 · CSS3 · JavaScript · Bootstrap · REST APIs · M-Pesa Integration · GPS/Location Services · Role-Based Access Control**
---
## Project Classification
**Type:** B2B SaaS / Enterprise Web Application
**Industry:** FMCG / Distribution / Retail
**Status:** Ongoing Development
**Architecture:** Laravel MVC / Modular Web Application
**Database:** MySQL
**Primary Backend:** PHP / Laravel
**Frontend:** HTML5 / CSS3 / JavaScript / Bootstrap
**Target Users:** Retailers, Account Developers, Sales Team Leads, Distributors, Drivers, Technicians & System Administrators
---
### Built with a Real Business Problem in Mind
SmartRoute Proo is one of the projects through which I am exploring the intersection of **software engineering, business process automation, sales operations, and digital transformation**.
It represents my approach to software development: understand the real-world problem first, model the business processes, design the architecture, and then build technology around the workflow.
**This project is still evolving — and that is part of the story.**
📈 Results & Impact
▲ Digitized the traditional FMCG ordering process.
▲ Reduced reliance on phone calls, WhatsApp, paper-based orders, and spreadsheets.
▲ Streamlined retailer order placement and management.
▲ Improved the retailer self-service experience.
▲ Centralized retailer, product, order, route, and sales information.
▲ Improved route and territory management.
▲ Enabled structured outlet portfolio management.
▲ Improved order tracking from submission through delivery.
▲ Reduced potential errors associated with manual order capture.
▲ Created a centralized digital record of customer interactions and sales activities.
▲ Improved monitoring of sales targets and performance.
▲ Enabled better tracking of product and stock information.
▲ Streamlined cooler and equipment fault reporting.
🖼 Preview
⚡ Challenges Faced
Translating complex real-world FMCG distribution workflows into a structured digital system.
Designing a system that supports multiple user roles with different responsibilities and permissions.
Modelling complex relationships between retailers, outlets, distributors, routes, sales teams, products, orders, and deliveries.
Designing a database architecture that can scale as the number of users, outlets, products, and transactions grows.
Maintaining strict role-based access control across different dashboards and operational areas.
💡 Key Takeaways
Business processes should come before technology — understanding the actual FMCG workflow made it easier to design meaningful features.
Real-world requirements are complex — seemingly simple processes such as placing an order can involve retailers, sales representatives, distributors, drivers, inventory, payments, and delivery.
Good database design is critical — a strong relational structure is essential when dealing with interconnected users, outlets, products, routes, orders, and transactions.
Role-based architecture is essential for enterprise systems — different users need different permissions, workflows, and levels of visibility.