# yonetici/ch_response_project architecture

> Architecture diagram of the GitHub repository yonetici/ch_response_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yonetici/ch_response_project
- Repository: https://github.com/yonetici/ch_response_project

## Overview

CH-RIS is a Django disaster-response platform for cultural heritage. The principal workflow assigns teams to worksites, then lets field experts record site and building inventories, hazard damage, movable assets and intangible-heritage impacts; operational dashboards and mission reports expose the resulting data. Personnel, team, sector and worksite management support that workflow, while reporting and role-based access are documented product capabilities. Source excerpts show core URL routing, view/form/model relationships; several capability links rely on the README because their implementation was not sampled.

Main entry points: [`core/views.py`](https://github.com/yonetici/ch_response_project/blob/main/core/views.py) (Operations Views), [`core/models.py`](https://github.com/yonetici/ch_response_project/blob/main/core/models.py) (Operational Records), [`core/urls.py`](https://github.com/yonetici/ch_response_project/blob/main/core/urls.py) (Application Routes), [`core/forms.py`](https://github.com/yonetici/ch_response_project/blob/main/core/forms.py) (Assessment Forms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Field Operations"]
  node_routes["Application Routes<br/>[urls.py]"]
  node_operations_views["Operations Views<br/>[views.py]"]
  node_team_assignment["Teams &amp; Missions<br/>[views.py]"]
  node_field_dashboard["Field Dashboard<br/>[views.py]"]
  node_operational_map["Operational Map<br/>[views.py]"]
  node_personnel["Personnel Management<br/>[views.py]"]
end

subgraph group_assessment["Heritage Assessment"]
  node_assessment_forms["Assessment Forms<br/>[forms.py]"]
  node_site_building["Site &amp; Building Inventory<br/>[models.py]"]
  node_damage["Damage Assessment<br/>[models.py]"]
  node_movable["Movable Heritage<br/>[models.py]"]
  node_tracking["Artifact Logistics<br/>[models.py]"]
  node_intangible["Intangible Heritage<br/>[models.py]"]
end

subgraph group_data["Domain Data"]
  node_domain_store[("Operational Records<br/>[models.py]")]
end

subgraph group_reporting["Reporting &amp; Access"]
  node_reporting["Reports &amp; Analytics<br/>[views.py]"]
  node_report_template["PDF Report Template"]
  node_access["Role-Based Access<br/>[settings.py]"]
end

node_expert(("Field Expert"))
node_admin(("Administrator"))
node_pdf_engine["PDF Generator"]

node_expert -->|"uses"| node_routes
node_admin -->|"uses"| node_routes
node_routes -->|"routes to"| node_operations_views
node_operations_views -->|"uses forms"| node_assessment_forms
node_operations_views -->|"reads/writes"| node_domain_store
node_assessment_forms -->|"models"| node_domain_store
node_operations_views -.->|"handles"| node_team_assignment
node_operations_views -->|"renders"| node_field_dashboard
node_operations_views -->|"prepares map data"| node_operational_map
node_operations_views -.->|"manages"| node_personnel
node_field_dashboard -.->|"records"| node_site_building
node_field_dashboard -.->|"records"| node_damage
node_field_dashboard -.->|"records"| node_movable
node_field_dashboard -.->|"tracks transfers"| node_tracking
node_field_dashboard -.->|"assesses"| node_intangible
node_site_building -.->|"persists in"| node_domain_store
node_damage -.->|"persists in"| node_domain_store
node_movable -.->|"persists in"| node_domain_store
node_tracking -.->|"persists in"| node_domain_store
node_intangible -.->|"persists in"| node_domain_store
node_operations_views -->|"generates"| node_reporting
node_reporting -.->|"renders"| node_report_template
node_reporting -.->|"generates PDF"| node_pdf_engine
node_admin -.->|"full access"| node_access
node_expert -.->|"task-restricted"| node_access

click node_routes "https://github.com/yonetici/ch_response_project/blob/main/core/urls.py"
click node_operations_views "https://github.com/yonetici/ch_response_project/blob/main/core/views.py"
click node_team_assignment "https://github.com/yonetici/ch_response_project/blob/main/core/views.py"
click node_field_dashboard "https://github.com/yonetici/ch_response_project/blob/main/core/views.py"
click node_operational_map "https://github.com/yonetici/ch_response_project/blob/main/core/views.py"
click node_personnel "https://github.com/yonetici/ch_response_project/blob/main/core/views.py"
click node_assessment_forms "https://github.com/yonetici/ch_response_project/blob/main/core/forms.py"
click node_site_building "https://github.com/yonetici/ch_response_project/blob/main/core/models.py"
click node_damage "https://github.com/yonetici/ch_response_project/blob/main/core/models.py"
click node_movable "https://github.com/yonetici/ch_response_project/blob/main/core/models.py"
click node_tracking "https://github.com/yonetici/ch_response_project/blob/main/core/models.py"
click node_intangible "https://github.com/yonetici/ch_response_project/blob/main/core/models.py"
click node_domain_store "https://github.com/yonetici/ch_response_project/blob/main/core/models.py"
click node_reporting "https://github.com/yonetici/ch_response_project/blob/main/core/views.py"
click node_report_template "https://github.com/yonetici/ch_response_project/blob/main/templates/core/report_pdf_template.html"
click node_access "https://github.com/yonetici/ch_response_project/blob/main/ch_response/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_routes,node_operations_views,node_team_assignment,node_field_dashboard,node_operational_map,node_personnel toneBlue
class node_assessment_forms,node_site_building,node_damage,node_movable,node_tracking,node_intangible toneAmber
class node_domain_store toneMint
class node_reporting,node_report_template,node_access toneRose
class node_expert,node_admin,node_pdf_engine toneIndigo
```

## Components

### Field Operations

- [Application Routes](https://github.com/yonetici/ch_response_project/blob/main/core/urls.py): `core/urls.py`
- [Operations Views](https://github.com/yonetici/ch_response_project/blob/main/core/views.py): `core/views.py`
- [Teams & Missions](https://github.com/yonetici/ch_response_project/blob/main/core/views.py): `core/views.py`
- [Field Dashboard](https://github.com/yonetici/ch_response_project/blob/main/core/views.py): `core/views.py`
- [Operational Map](https://github.com/yonetici/ch_response_project/blob/main/core/views.py): `core/views.py`
- [Personnel Management](https://github.com/yonetici/ch_response_project/blob/main/core/views.py): `core/views.py`

### Heritage Assessment

- [Assessment Forms](https://github.com/yonetici/ch_response_project/blob/main/core/forms.py): `core/forms.py`
- [Site & Building Inventory](https://github.com/yonetici/ch_response_project/blob/main/core/models.py): `core/models.py`
- [Damage Assessment](https://github.com/yonetici/ch_response_project/blob/main/core/models.py): `core/models.py`
- [Movable Heritage](https://github.com/yonetici/ch_response_project/blob/main/core/models.py): `core/models.py`
- [Artifact Logistics](https://github.com/yonetici/ch_response_project/blob/main/core/models.py): `core/models.py`
- [Intangible Heritage](https://github.com/yonetici/ch_response_project/blob/main/core/models.py): `core/models.py`

### Domain Data

- [Operational Records](https://github.com/yonetici/ch_response_project/blob/main/core/models.py): `core/models.py`

### Reporting & Access

- [Reports & Analytics](https://github.com/yonetici/ch_response_project/blob/main/core/views.py): `core/views.py`
- [PDF Report Template](https://github.com/yonetici/ch_response_project/blob/main/templates/core/report_pdf_template.html): `templates/core/report_pdf_template.html`
- [Role-Based Access](https://github.com/yonetici/ch_response_project/blob/main/ch_response/settings.py): `ch_response/settings.py`

### Other components

- **Field Expert**
- **Administrator**
- **PDF Generator**

## Connections

- Field Expert → Application Routes: uses (evidence: `core/urls.py`)
- Administrator → Application Routes: uses (evidence: `core/urls.py`)
- Application Routes → Operations Views: routes to (evidence: `core/urls.py`)
- Operations Views → Assessment Forms: uses forms (evidence: `core/views.py`)
- Operations Views → Operational Records: reads/writes (evidence: `core/views.py`)
- Assessment Forms → Operational Records: models (evidence: `core/forms.py`)
- Operations Views → Teams & Missions: handles (evidence: `README.md`)
- Operations Views → Field Dashboard: renders (evidence: `core/views.py`)
- Operations Views → Operational Map: prepares map data (evidence: `core/views.py`)
- Operations Views → Personnel Management: manages (evidence: `README.md`)
- Field Dashboard → Site & Building Inventory: records (evidence: `README.md`)
- Field Dashboard → Damage Assessment: records (evidence: `README.md`)
- Field Dashboard → Movable Heritage: records (evidence: `README.md`)
- Field Dashboard → Artifact Logistics: tracks transfers (evidence: `README.md`)
- Field Dashboard → Intangible Heritage: assesses (evidence: `README.md`)
- Site & Building Inventory → Operational Records: persists in (evidence: `README.md`)
- Damage Assessment → Operational Records: persists in (evidence: `README.md`)
- Movable Heritage → Operational Records: persists in (evidence: `README.md`)
- Artifact Logistics → Operational Records: persists in (evidence: `README.md`)
- Intangible Heritage → Operational Records: persists in (evidence: `README.md`)
- Operations Views → Reports & Analytics: generates (evidence: `core/views.py`)
- Reports & Analytics → PDF Report Template: renders (evidence: `README.md`)
- Reports & Analytics → PDF Generator: generates PDF (evidence: `README.md`)
- Administrator → Role-Based Access: full access (evidence: `README.md`)
- Field Expert → Role-Based Access: task-restricted (evidence: `README.md`)
