Larrykj/big-project

Omnilogistics for truckers in East Africa # OmniLogistics Kenya - East Africa Supply Chain Platform Welcome to **OmniLogistics Kenya**, a next-generation microservices platform designed for high-scale logistics, tracking, and supply chain management across Kenya and East Africa. ## 🌍 Regional Focus This platform is specifically designed for: - **Primary Market**: Kenya (Nairobi, Mombasa, Kisumu, Nakuru, Eldoret) - **Extended Coverage**: Uganda, Tanzania, Rwanda - **Currency**: Kenyan Shilling (KSH) with multi-currency support (USD, EUR, GBP) - **Payment Integration**: M-Pesa, Bank Transfers, RTGS ## 🏗 Architecture Overview This project uses a **Polyglot Microservices Architecture**, meaning each service is built with the language best suited for its specific task. | Service | Language | Tech Stack | Responsibility | Port | | :--- | :--- | :--- | :--- | :--- | | **core-service** | **Java** | Spring Boot | Central ERP, User Auth, Order Management | 8080 | | **finance-service** | **C#** | .NET 8 | Billing, M-Pesa Integration, KRA Reports | 5000 | | **realtime-service** | **Node.js** | Express/Socket.io | Live Map Tracking, WebSocket Notifications | 3000 | | **ai-service** | **Python** | FastAPI / TensorFlow | Route Optimization, Traffic Prediction | 5001 | | **vendor-portal** | **Ruby** | Rails | Vendor Onboarding, Document Management | 3001 | | **hardware-bridge** | **C++** | POCO / Boost | High-performance IoT Data from GPS Trackers | 1883 | | **frontend-portal** | **React** | TypeScript/Vite | Web Dashboard with Kenya Map Integration | 5173 | ## 🚀 Key Features ### For Kenya Market - **Live GPS Tracking**: Real-time vehicle monitoring across major Kenyan highways - **M-Pesa Integration**: Native payment processing for KSH transactions - **Multi-Currency**: Support for USD, EUR, GBP alongside KSH - **KRA Compliance**: Automated tax reporting and invoice generation - **SGR Integration**: Support for Standard Gauge Railway logistics - **Local Routes**: Pre-configured for Nairobi-Mombasa, Nairobi-Kisumu …