ike-code-code/waste-management-ghana

waste management system for Ghana # 🗑️ Waste Management System **Atwima Kwanwoma District Assembly** **Ghana Flag Colors:** 🟥 Red | 🟨 Gold | 🟩 Green | ⬛ Black Complete mobile-first waste collection system for household solid waste management in Ghana. --- ## 📋 Table of Contents - Overview - Features - Tech Stack - Project Structure - Installation - Configuration - Running the Application - API Documentation - Mobile App - Deployment - Testing - Contributing --- ## 🎯 Overview This system digitizes waste collection operations including: - ✅ Household registration with GPS - ✅ Automated collection scheduling - ✅ Real-time GPS tracking of collectors - ✅ Dynamic billing based on waste weight, type, and distance - ✅ Mobile Money payments (MTN, Vodafone, AirtelTigo) - ✅ Offline-first mobile apps - ✅ Administrative dashboards - ✅ AI route optimization --- ## ✨ Features ### For Clients (Households) - Self-registration via mobile app - Schedule viewing and notifications - Multiple waste types (Domestic, Plastics, Papers) - Multiple bin types (240L, 1100L, Waste Bags) - One-time or recurring pickups - Bill viewing and Mobile Money payments - Collection confirmation ### For Waste Collectors - Daily task list with GPS navigation - Offline report submission - Automatic GPS and timestamp capture - Weight recording (manual or scale) - Performance metrics ### For Administrators - Dashboard with real-time stats - User management - Schedule creation and optimization - Pricing configuration - Revenue and waste reports - Route optimization AI --- ## 🛠️ Tech Stack ### Backend - **Runtime:** Node.js 18+ - **Framework:** Express.js - **Database:** PostgreSQL 14+ with PostGIS - **Authentication:** JWT (JSON Web Tokens) - **Password Hashing:** bcrypt - **Payments:** Hubtel API (Mobile Money) ### Mobile App - **Framework:** Flutter 3.x - **State Management:** Provider - **Local Database:** Sqflite - **Maps:** Google Maps Flutter - **HTTP:** Dio ### Admin Dashboard - **Framework:** React / Vue.js (TBD) - **Ch …