ARCHITECTURE.md

Architecture Overview

Problem Statement

Waste segregation is a critical challenge for sustainable cities. This project leverages AI to automate waste classification and gamifies eco-friendly behavior.

High-Level Architecture

• src/: Core logic (Flask app, ML integration, business logic)
• config/: Environment and configuration files
• tests/: Unit and integration tests
• docs/: Documentation and diagrams
• scripts/: Automation and developer utilities
• static/, templates/: Web assets

Key Components

• Flask API: Serves web and API endpoints
• YOLO Model: Image-based waste classification
• Gamification: Points, badges, leaderboard
• Config: Environment-driven, no secrets in code

Ownership

• Code: Open-source contributors
• Security: Maintainers, GitGuardian policies
• Documentation: All contributors

Extensibility

• Add new waste types, gamification logic, or ML models via modular src/ structure.

---

See CONTRIBUTING.md for extension guidelines.