ianwilliam/dial-a-drink-kenya

🍹 Modern e-commerce platform for beverage delivery in Kenya. Built with React, Node.js, PostgreSQL, and real-time WebSocket notifications. Features mobile-responsive design, admin dashboard, and real-time order management. # Dial a Drink Kenya - Complete Ecosystem Documentation ## Overview Dial a Drink Kenya is a comprehensive beverage delivery platform ecosystem consisting of three integrated applications: 1. **Customer Site** - Web application for customers to browse, order, and track deliveries 2. **Driver App** - Native Android application (Kotlin) for drivers to manage deliveries and earnings 3. **Admin Dashboard** - Web application for administrators to manage orders, inventory, drivers, and financials All three platforms connect to a unified backend API hosted on Google Cloud Run, with data stored in Google Cloud SQL (PostgreSQL). --- ## Architecture ### System Components ``` ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Customer Site │ │ Driver App │ │ Admin Dashboard│ │ (React SPA) │ │ (Android/Kotlin) │ │ (React SPA) │ │ Port: 3000 │ │ (Native APK) │ │ Port: 3001 │ └────────┬────────┘ └────────┬─────────┘ └────────┬────────┘ │ │ │ │ │ │ └──────────────────────┼─────────────────────────┘ │ ┌───────────▼───────────┐ │ Backend API │ │ (Node.js/Express) │ │ Cloud Run │ │ Port: 8080 │ └───────────┬───────────┘ │ ┌───────────▼───────────┐ │ PostgreSQL Database │ │ Cloud SQL │ └───────────────────────┘ ``` ### Technology Stack **Backend:** - Node.js with Express.js - Sequelize ORM - PostgreSQL (Cloud SQL) - Socket.IO for real-time updates - M-Pesa API integration - Google Maps API for delivery calculations **Frontend (Customer & Admin):** - React.js - Material-UI - Axios for API calls - Socket.IO client for real-time updates **Driver App:** - Native Android (Kotlin) - Android Studio for builds - APK distribution - Socket.IO client for real-time updates **Infrastructure:** - Google Cloud Platform (GCP) - Cloud Run for backend and frontend hostin …