Sande-abraham/BODA-APP-DEMO

# BodaFuel AI - Faras Clone with AI Fuel Optimization A full-stack logistics platform designed for Kampala's unique topography, helping Boda-Boda riders maximize earnings through AI-driven fuel-efficient routing. ## 🚀 Key Features - **Real-time Ride Matching**: Geolocation-based matching using Socket.io and PostgreSQL. - **AI Fuel Engine**: FastAPI service calculating optimized routes based on Kampala's hills and traffic. - **Dynamic Pricing**: Fares adjust based on terrain incline and traffic density. - **Admin Dashboard**: Real-time analytics on revenue and carbon footprint reduction. - **Wallet System**: Automated commission handling and peer-to-peer payments. ## 🛠️ Tech Stack - **Backend**: Node.js, TypeScript, Express, TypeORM, Socket.io - **Database**: PostgreSQL with PostGIS extension - **AI Service**: Python, FastAPI, NumPy - **Frontend**: Next.js (Admin), React Native (Mobile - conceptual) ## 🏗️ Getting Started ### Prerequisites - Docker & Docker Compose - Node.js 18+ (for local dev) - Python 3.9+ (for local AI dev) ### Installation & Run (Docker - Recommended) 1. Clone the repository 2. Run the full environment: