A comprehensive AI-powered logistics platform designed for Nigeria & ECOWAS region, featuring a Universal Freight Form, intelligent classification system, and multi-modal transport support.
# π Logistics AI Platform - Nigeria & ECOWAS
**One barcode, one dashboard, complete freight visibility.**
A revolutionary AI-powered logistics platform transforming freight operations across Nigeria and ECOWAS. Built with Next.js, TypeScript, and cutting-edge AI optimization.
## π Features
### β
**Platform 1 - Domestic Logistics** (COMPLETED)
- **Universal Barcode System** - LNG-{TYPE}-{ROUTE}-{ID} format
- **Load Board & Carrier Matching** - AI-powered freight marketplace
- **Real-Time Tracking Dashboard** - GPS tracking with driver updates
- **Analytics & Insights** - Performance metrics and route optimization
- **Mobile-First Design** - Beautiful, responsive Nigerian-themed UI
### π§ **Platform 2 - Freight Forwarding & Customs** (PLANNED)
- AI HS Code Classification
- Customs Duty Estimation
- Document Automation
- ECOWAS Cross-Border Support
### π€ **AI Services** (PLANNED)
- LTL Load Optimization
- ETA Prediction Models
- Fraud Detection
- Road Intelligence Analytics
## ποΈ Architecture
```
logistics-ai/
βββ apps/
β βββ platform1/ # Domestic Logistics (Next.js)
β βββ platform2/ # Freight Forwarding (Planned)
βββ packages/
β βββ shared/ # Utilities & Types
β βββ database/ # Prisma Schema
β βββ ai-services/ # ML Models
βββ turbo.json # Monorepo Config
```
## π Quick Start
### Prerequisites
- Node.js 18+
- npm 8+
### Installation
```bash
# Clone and install
git clone
cd logistics-ai-platform
npm install
# Set up environment variables
cp .env.example apps/platform1/.env.local
# Edit apps/platform1/.env.local with your configuration
# Set up database
cd packages/database
npm run db:seed
# Start development
npm run dev
```
### Access Points
- **Platform**:
localhost
- **Homepage**: Beautiful hero with call-to-action
- **Login**: `/auth/signin` - Access dashboards
- **Signup**: `/auth/signup` - Create new account
- **Universal Freight Form**: `/send-packages` - Create shipmen β¦