# luckyjaiswal14/disaster-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/luckyjaiswal14/disaster-management-system
- Repository: https://github.com/luckyjaiswal14/disaster-management-system

## Overview

This Flask relief-coordination application lets people register, view active disasters and resources, donate supplies, or request aid; administrators review requests and manage resources, then volunteers take and fulfill approved tasks. The map and dashboards present disaster and workflow information. Source excerpts show the app wiring and core route/model interactions; mapping and several UI details are documented in the README but their implementation is not sampled.

Main entry points: [`backend/app.py`](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/app.py) (Flask App), [`backend/models.py`](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/models.py) (Domain Models), [`backend/routes/user.py`](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/user.py) (User Relief Routes), [`backend/routes/volunteer.py`](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/volunteer.py) (Volunteer Tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_factory["Flask App<br/>[app.py]"]
  node_auth_routes["Authentication<br/>[auth.py]"]
end

subgraph group_relief["Relief Coordination"]
  node_user_routes["User Relief Routes<br/>[user.py]"]
  node_map_ui["Disaster Map"]
end

subgraph group_operations["Administration &amp; Fulfillment"]
  node_admin_routes["Admin Operations<br/>[admin.py]"]
  node_volunteer_routes["Volunteer Tasks<br/>[volunteer.py]"]
end

subgraph group_data["Data &amp; Security"]
  node_models["Domain Models<br/>[models.py]"]
  node_database[("SQLite Database<br/>[disaster.db]")]
  node_config["App Configuration<br/>[config.py]"]
  node_extensions["Flask Extensions<br/>[extensions.py]"]
  node_csrf["CSRF Protection<br/>[extensions.py]"]
end

node_public(("User"))
node_admin_actor(("Administrator"))
node_volunteer_actor(("Volunteer"))
node_mapping_service["Leaflet / OpenStreetMap"]

node_public -->|"registers or signs in"| node_auth_routes
node_auth_routes -->|"queries and creates users"| node_models
node_public -->|"requests or donates"| node_user_routes
node_user_routes -->|"reads and updates relief data"| node_models
node_user_routes -->|"supplies event data"| node_map_ui
node_map_ui -->|"visualizes events"| node_mapping_service
node_admin_actor -->|"reviews and manages"| node_admin_routes
node_admin_routes -->|"approves and allocates"| node_models
node_volunteer_actor -->|"takes and updates tasks"| node_volunteer_routes
node_admin_actor -->|"assigns volunteers"| node_volunteer_routes
node_volunteer_routes -->|"updates assignments"| node_models
node_app_factory -->|"registers blueprint"| node_auth_routes
node_app_factory -->|"registers blueprint"| node_user_routes
node_app_factory -->|"registers blueprint"| node_admin_routes
node_app_factory -->|"registers blueprint"| node_volunteer_routes
node_app_factory -->|"loads configuration"| node_config
node_app_factory -->|"initializes extensions"| node_extensions
node_app_factory -->|"enables protection"| node_csrf
node_extensions -->|"provides ORM base"| node_models
node_models -->|"defines persisted tables"| node_database

click node_app_factory "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/app.py"
click node_auth_routes "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/auth.py"
click node_user_routes "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/user.py"
click node_map_ui "https://github.com/luckyjaiswal14/disaster-management-system/tree/main/backend/templates"
click node_admin_routes "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/admin.py"
click node_volunteer_routes "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/volunteer.py"
click node_models "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/models.py"
click node_database "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/disaster.db"
click node_config "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/config.py"
click node_extensions "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/extensions.py"
click node_csrf "https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/extensions.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_app_factory,node_auth_routes,node_public toneBlue
class node_user_routes,node_map_ui toneAmber
class node_admin_routes,node_volunteer_routes toneMint
class node_models,node_database,node_config,node_extensions,node_csrf toneRose
class node_admin_actor,node_volunteer_actor,node_mapping_service toneIndigo
```

## Components

### Application

- [Flask App](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/app.py): `backend/app.py`
- [Authentication](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/auth.py): `backend/routes/auth.py`

### Relief Coordination

- [User Relief Routes](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/user.py): `backend/routes/user.py`
- [Disaster Map](https://github.com/luckyjaiswal14/disaster-management-system/tree/main/backend/templates): `backend/templates`

### Administration & Fulfillment

- [Admin Operations](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/admin.py): `backend/routes/admin.py`
- [Volunteer Tasks](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/routes/volunteer.py): `backend/routes/volunteer.py`

### Data & Security

- [Domain Models](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/models.py): `backend/models.py`
- [SQLite Database](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/disaster.db): `backend/disaster.db`
- [App Configuration](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/config.py): `backend/config.py`
- [Flask Extensions](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/extensions.py): `backend/extensions.py`
- [CSRF Protection](https://github.com/luckyjaiswal14/disaster-management-system/blob/main/backend/extensions.py): `backend/extensions.py`

### Other components

- **User**
- **Administrator**
- **Volunteer**
- **Leaflet / OpenStreetMap**

## Connections

- User → Authentication: registers or signs in (evidence: `backend/routes/auth.py`)
- Authentication → Domain Models: queries and creates users (evidence: `backend/routes/auth.py`)
- User → User Relief Routes: requests or donates (evidence: `backend/routes/user.py`)
- User Relief Routes → Domain Models: reads and updates relief data (evidence: `backend/routes/user.py`)
- User Relief Routes → Disaster Map: supplies event data (evidence: `README.md`)
- Disaster Map → Leaflet / OpenStreetMap: visualizes events (evidence: `README.md`)
- Administrator → Admin Operations: reviews and manages (evidence: `backend/routes/admin.py`)
- Admin Operations → Domain Models: approves and allocates (evidence: `backend/routes/admin.py`)
- Volunteer → Volunteer Tasks: takes and updates tasks (evidence: `backend/routes/volunteer.py`)
- Administrator → Volunteer Tasks: assigns volunteers (evidence: `backend/routes/volunteer.py`)
- Volunteer Tasks → Domain Models: updates assignments (evidence: `backend/routes/volunteer.py`)
- Flask App → Authentication: registers blueprint (evidence: `backend/app.py`)
- Flask App → User Relief Routes: registers blueprint (evidence: `backend/app.py`)
- Flask App → Admin Operations: registers blueprint (evidence: `backend/app.py`)
- Flask App → Volunteer Tasks: registers blueprint (evidence: `backend/app.py`)
- Flask App → App Configuration: loads configuration (evidence: `backend/app.py`)
- Flask App → Flask Extensions: initializes extensions (evidence: `backend/app.py`)
- Flask App → CSRF Protection: enables protection (evidence: `backend/app.py`)
- Flask Extensions → Domain Models: provides ORM base (evidence: `backend/models.py`)
- Domain Models → SQLite Database: defines persisted tables (evidence: `README.md`)
