# nishirajsingh/smart-waste-management-system architecture

> Architecture diagram of the GitHub repository nishirajsingh/smart-waste-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nishirajsingh/smart-waste-management-system
- Repository: https://github.com/nishirajsingh/smart-waste-management-system

## Overview

Smart Waste Management is a Django app for citizen-submitted waste reports and municipal follow-up. Citizens sign up or log in, submit reports with area, street, and landmark details, and view their requests; admins filter reports, assign collectors, and update statuses through resolution. The map separates routing, workflow views, domain records, and rendered pages. Major capabilities come from the README; sampled views and routes support the shown calls, while template internals were not inspected.

Main entry points: [`waste_app/urls.py`](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/urls.py) (App Routes), [`waste_app/models.py`](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/models.py) (Waste Requests), [`waste_app/views.py`](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py) (Signup and Login), [`waste_management/urls.py`](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_management/urls.py) (Project Router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Request Routing"]
  node_project_router["Project Router<br/>[urls.py]"]
  node_app_routes["App Routes<br/>[urls.py]"]
end

subgraph group_identity["Accounts and Roles"]
  node_identity_views["Signup and Login<br/>[views.py]"]
  node_profiles["User Profiles<br/>[models.py]"]
end

subgraph group_citizen["Citizen Reporting"]
  node_citizen_views["Citizen Dashboard<br/>[views.py]"]
  node_report_views["Report Submission<br/>[views.py]"]
  node_signup_page["Signup Page<br/>[signup.html]"]
  node_login_page["Login Page<br/>[login.html]"]
  node_citizen_page["Citizen Dashboard Page"]
  node_report_page["Report Form<br/>[report_form.html]"]
end

subgraph group_operations["Municipal Operations"]
  node_admin_views["Admin Dashboard<br/>[views.py]"]
  node_assignment_views["Collector Assignment<br/>[views.py]"]
  node_status_views["Status Updates<br/>[views.py]"]
  node_admin_page["Admin Dashboard Page"]
end

subgraph group_data["Domain Data"]
  node_waste_requests[("Waste Requests<br/>[models.py]")]
  node_sqlite[("SQLite Database<br/>[settings.py]")]
end

node_citizens(("Citizens"))
node_municipal_admins(("Municipal Admins"))

node_citizens -->|"request routes"| node_project_router
node_municipal_admins -->|"request routes"| node_project_router
node_project_router -->|"includes routes"| node_app_routes
node_app_routes -->|"routes to"| node_identity_views
node_app_routes -->|"routes to"| node_citizen_views
node_app_routes -->|"routes to"| node_report_views
node_app_routes -->|"routes to"| node_admin_views
node_app_routes -->|"routes to"| node_assignment_views
node_app_routes -->|"routes to"| node_status_views
node_identity_views -->|"creates and reads"| node_profiles
node_identity_views -->|"renders"| node_signup_page
node_identity_views -->|"renders"| node_login_page
node_citizen_views -->|"checks role"| node_profiles
node_citizen_views -->|"reads requests"| node_waste_requests
node_citizen_views -->|"renders"| node_citizen_page
node_report_views -->|"creates request"| node_waste_requests
node_report_views -->|"renders"| node_report_page
node_admin_views -->|"checks role"| node_profiles
node_admin_views -->|"filters requests"| node_waste_requests
node_admin_views -->|"renders"| node_admin_page
node_assignment_views -->|"checks role"| node_profiles
node_assignment_views -->|"assigns collector"| node_waste_requests
node_status_views -->|"checks role"| node_profiles
node_status_views -->|"updates status"| node_waste_requests
node_waste_requests -.->|"stored in"| node_sqlite

click node_project_router "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_management/urls.py"
click node_app_routes "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/urls.py"
click node_identity_views "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py"
click node_profiles "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/models.py"
click node_citizen_views "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py"
click node_report_views "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py"
click node_signup_page "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/signup.html"
click node_login_page "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/login.html"
click node_citizen_page "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/citizen_dashboard.html"
click node_report_page "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/report_form.html"
click node_admin_views "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py"
click node_assignment_views "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py"
click node_status_views "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py"
click node_admin_page "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/admin_dashboard.html"
click node_waste_requests "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/models.py"
click node_sqlite "https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_management/settings.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_project_router,node_app_routes toneBlue
class node_identity_views,node_profiles toneAmber
class node_citizen_views,node_report_views,node_signup_page,node_login_page,node_citizen_page,node_report_page toneMint
class node_admin_views,node_assignment_views,node_status_views,node_admin_page toneRose
class node_waste_requests,node_sqlite,node_citizens,node_municipal_admins toneIndigo
```

## Components

### Request Routing

- [Project Router](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_management/urls.py): `waste_management/urls.py`
- [App Routes](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/urls.py): `waste_app/urls.py`

### Accounts and Roles

- [Signup and Login](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py): `waste_app/views.py`
- [User Profiles](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/models.py): `waste_app/models.py`

### Citizen Reporting

- [Citizen Dashboard](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py): `waste_app/views.py`
- [Report Submission](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py): `waste_app/views.py`
- [Signup Page](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/signup.html): `waste_app/templates/signup.html`
- [Login Page](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/login.html): `waste_app/templates/login.html`
- [Citizen Dashboard Page](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/citizen_dashboard.html): `waste_app/templates/citizen_dashboard.html`
- [Report Form](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/report_form.html): `waste_app/templates/report_form.html`

### Municipal Operations

- [Admin Dashboard](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py): `waste_app/views.py`
- [Collector Assignment](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py): `waste_app/views.py`
- [Status Updates](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/views.py): `waste_app/views.py`
- [Admin Dashboard Page](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/templates/admin_dashboard.html): `waste_app/templates/admin_dashboard.html`

### Domain Data

- [Waste Requests](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_app/models.py): `waste_app/models.py`
- [SQLite Database](https://github.com/nishirajsingh/smart-waste-management-system/blob/main/waste_management/settings.py): `waste_management/settings.py`

### Other components

- **Citizens**
- **Municipal Admins**

## Connections

- Citizens → Project Router: request routes (evidence: `README.md`)
- Municipal Admins → Project Router: request routes (evidence: `README.md`)
- Project Router → App Routes: includes routes (evidence: `waste_management/urls.py`)
- App Routes → Signup and Login: routes to (evidence: `waste_app/urls.py`)
- App Routes → Citizen Dashboard: routes to (evidence: `waste_app/urls.py`)
- App Routes → Report Submission: routes to (evidence: `waste_app/urls.py`)
- App Routes → Admin Dashboard: routes to (evidence: `waste_app/urls.py`)
- App Routes → Collector Assignment: routes to (evidence: `waste_app/urls.py`)
- App Routes → Status Updates: routes to (evidence: `waste_app/urls.py`)
- Signup and Login → User Profiles: creates and reads (evidence: `waste_app/views.py`)
- Signup and Login → Signup Page: renders (evidence: `waste_app/views.py`)
- Signup and Login → Login Page: renders (evidence: `waste_app/views.py`)
- Citizen Dashboard → User Profiles: checks role (evidence: `waste_app/views.py`)
- Citizen Dashboard → Waste Requests: reads requests (evidence: `waste_app/views.py`)
- Citizen Dashboard → Citizen Dashboard Page: renders (evidence: `waste_app/views.py`)
- Report Submission → Waste Requests: creates request (evidence: `waste_app/views.py`)
- Report Submission → Report Form: renders (evidence: `waste_app/views.py`)
- Admin Dashboard → User Profiles: checks role (evidence: `waste_app/views.py`)
- Admin Dashboard → Waste Requests: filters requests (evidence: `waste_app/views.py`)
- Admin Dashboard → Admin Dashboard Page: renders (evidence: `waste_app/views.py`)
- Collector Assignment → User Profiles: checks role (evidence: `waste_app/views.py`)
- Collector Assignment → Waste Requests: assigns collector (evidence: `waste_app/views.py`)
- Status Updates → User Profiles: checks role (evidence: `waste_app/views.py`)
- Status Updates → Waste Requests: updates status (evidence: `waste_app/views.py`)
- Waste Requests → SQLite Database: stored in (evidence: `waste_management/settings.py`)
