provencal115/SmartWaste-Ghana-Waste-Management-System

SmartWaste Ghana is a PHP MVC-based smart waste management system for garbage collection, bin allocation, inventory management, scheduling, payments, analytics, and AI-assisted customer support. # Smart Garbage Collection & Inventory Management System A professional **PHP MVC** web application for waste management in Ghana — single-stack architecture (no separate React or REST API layer). ## Technology Stack | Layer | Technology | |-------|-----------| | Application | PHP 8+ MVC (controllers, models, views) | | Database | MySQL with PDO | | Frontend | HTML5, CSS3, JavaScript (ES6+) | | CSS Framework | Bootstrap 5 | | Charts | Chart.js | | Alerts | SweetAlert2 | | Animations | AOS (Animate On Scroll) | | Icons | Font Awesome 6 | | PDF | Dompdf | | Server | XAMPP (Apache + MySQL) | | API (internal) | PHP routes via `index.php?url=` (e.g. `api/pricing`, `api/chatbot/send`) | ## Project Structure (MVC) ``` finalyearproject/ ├── config/ # App & database configuration ├── controllers/ # MVC Controllers ├── models/ # MVC Models (PDO) ├── views/ # MVC Views (Bootstrap 5) │ ├── layouts/ │ ├── partials/ │ ├── auth/ │ ├── resident/ │ ├── collector/ │ ├── inventory/ │ ├── admin/ │ └── finance/ ├── includes/ # Router, Auth, CSRF, Helpers ├── assets/ # CSS, JS, uploads ├── database/ # MySQL schema └── index.php # Front controller ``` ## Setup ### 1. Start XAMPP Enable **Apache** and **MySQL**. ### 2. Import Database Import `database/schema.sql` via phpMyAdmin or: ```bash mysql -u root < database/schema.sql ``` If collector seed failed, also run `database/fix_collector_seed.sql`. ### 3. Install PHP Dependencies (optional, for PDF) ```bash composer install ``` ### 4. Access Application Open: **localhost ## Demo Accounts | Role | Email | Password | |------|-------|----------| | Administrator | admin@smartwaste.gh | password | | Finance Manager | finance@smartwaste.gh | password | | Inventory Manager | inventory@smartwaste.gh | password | | Collector | collector@smartwaste.gh | password | Residents register at `/index.php?url=auth/register` ## Featu …