AXpress (Assured Express)

AXpress is a next-generation logistics and delivery platform designed for merchants in Lagos, Nigeria. It provides a comprehensive ecosystem for managing deliveries, tracking riders in real-time, and scaling logistics operations through automated zone management and AI-driven intelligence.

---

🚀 Project Overview

AXpress bridges the gap between merchants and dispatchers with a unified platform. It features a robust Django/FastAPI Backend, a premium Next.js Merchant Dashboard, and a high-performance Vite-based Dispatcher Portal.

Core Value Propositions:

• Scalability: Optimized for local and multi-zone delivery operations.
• Intelligence: Integrated with Google Cloud Vertex AI and Gemini for smarter logistics.
• Real-time: Live rider tracking and order updates powered by Ably.
• Financial Integration: Built-in wallet systems with virtual account funding and flexible subscription plans (Prepaid/Postpaid).

---

🛠 Project Structure

This repository is managed as a monorepo:

• backend/: Django 4.2 + DRF & FastAPI. Handles core logic, order routing, and AI integrations.
• frontend/: Next.js 16 + React 19 Merchant Portal. Focuses on premium merchant UX/UI.
• dispatcher-frontend/: Vite + React 19 Operations Dashboard for real-time fleet management.
• functions/: Serverless functions for extended backend capabilities.

---

🏗 Tech Stack

Backend (Python)

• Frameworks: Django 4.2, Django REST Framework, FastAPI
• Primary DB: PostgreSQL
• Cache/Broker: Redis
• Task Queue: Celery
• AI/ML: Google Cloud Vertex AI, Google GenAI (Gemini)
• Real-time: Ably

Merchant Frontend (TypeScript)

• Framework: Next.js 16 (App Router)
• Library: React 19
• Styling: Tailwind CSS 4
• Animations: Framer Motion
• State/Real-time: Ably SDK

Dispatcher Portal (JavaScript)

• Tooling: Vite
• Library: React 19
• Real-time: Ably SDK

---

🚦 Getting Started

Prerequisites

• Python 3.12+
• Node.js 20+
• Docker & Docker Compose
• PostgreSQL & Redis

1. Backend Setup

cd backend
source venv/bin/activate
pip install -r requirements.txt
python manage.py migrate

2. Frontend Setup (Merchant)

cd frontend
npm install
npm run dev

3. Dispatcher Setup

cd dispatcher-frontend
npm install
npm run dev

---

🧪 Seeding & Development

AXpress requires several data layers (Vehicles, Zones, Verticals) to function correctly.

Initial Data Seeding:

python manage.py seed_vehicles                 # Vehicle types & pricing
python manage.py seed_verticals_and_zones      # Geographic delivery zones
python manage.py populate_users                # Test roles
python manage.py seed_occ_test_data            # OCC components (Captains, Targets)

Background Tasks:

celery -A ax_merchant_api worker -l info
celery -A ax_merchant_api beat -l info

---

📖 Documentation & Standards

• API Endpoints: Full reference for all REST endpoints and webhooks.
• Development Rules: Mandatory coding standards and API patterns.
• Changelog: History of features and bug fixes.

---

🔐 Authentication Modes

1. JWT (Simple JWT): Used by Merchants and Riders for standard platform access.
2. Service API Keys: Scoped, SHA-256 hashed keys for server-to-server communication (e.g., OCC to Backend).

---

© 2026 Assured Express. All rights reserved.