MutisyaGeoffrey/Waterflow

WaterFlow is a full‑stack SaaS platform for water refilling stations in Kenya. Replaces manual notebooks with real‑time dashboards, employee performance tracking, daily summaries, WhatsApp reports, and exportable analytics. # 💧 WaterFlow – Smart Business Management for Water Refilling Stations **WaterFlow** is a complete SaaS platform that replaces manual notebook tracking for water refilling stations in Kenya and similar markets. Owners get a real‑time dashboard, employees can record sales in 3 taps (mobile app planned), and the system automatically calculates totals, tracks cash vs M‑Pesa, exports reports, and sends daily summaries via WhatsApp. > 🚀 **Live demo** > Frontend: waterflow.vercel.app > Backend health: waterflow-ioty.onrender.com > Test owner: `+254711111111` / PIN `0000` --- ## 📌 Table of Contents - Problem Statement - Solution & Features - Tech Stack - Architecture Overview - API Endpoints - Getting Started (Local Development) - Deployment - Screenshots - Future Roadmap - License --- ## ❓ Problem Statement Water refilling stations in Nairobi and across Africa use paper notebooks to record sales. Employees write down liters sold, money received, and payment method (Cash or M‑Pesa). At the end of the day, owners manually reconcile totals – a process prone to errors, no remote visibility, and no insights into employee performance or popular container sizes. ## 💡 Solution & Features **WaterFlow** digitises the entire operation: ### For Owners (Web Dashboard) - **Live summary** – total liters, revenue, cash vs M‑Pesa split, pickups vs deliveries, transaction count. - **Weekly sales chart** – liters and revenue trend. - **Payment method pie chart** – instant cash / M‑Pesa breakdown. - **Employee leaderboard** – see who sold the most, earns the most revenue. - **Container management** – add, edit price, activate/deactivate container sizes (5L, 10L, 20L etc.). - **Employee management** – add, edit, reset PIN, activate/deactivate. - **Transaction history** – filter by date, employee, payment method, service type; paginated. - **Export reports** – CSV, PDF (full history or daily summary). - **WhatsApp report** – one‑click generation of a pre …