# nongolosh/ttx-disease-in-children-due-to-climate-change- architecture

> Architecture diagram of the GitHub repository nongolosh/ttx-disease-in-children-due-to-climate-change-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nongolosh/ttx-disease-in-children-due-to-climate-change-
- Repository: https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-

## Overview

CARES is a Lesotho-focused climate and child-health risk intelligence prototype. Its demonstrated workflow reads community and district data, creates lagged features, trains and evaluates a one-month-ahead model, and writes forecast summaries. The README also describes geospatial risk mapping, an interactive dashboard, DHIS2 integration, and a planned community alert layer. The forecast script is sampled; the notebook and dashboard are represented from the README and file tree, so their internal connections are not inferred.

Main entry points: [`index.html`](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/index.html) (Interactive Dashboard), [`forecast_model.py`](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py) (Lagged Features), [`geodata_audit.csv`](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/geodata_audit.csv) (Geospatial Audit), [`Climate_Health_Risk_Kids_Under_5.ipynb`](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/Climate_Health_Risk_Kids_Under_5.ipynb) (Model Explainability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Risk Data"]
  node_source_data["CARES Data<br/>[CARES.csv]"]
  node_feature_file["Feature Dataset"]
  node_geo_data["Geospatial Audit<br/>[geodata_audit.csv]"]
end

subgraph group_prediction["Forecasting"]
  node_feature_prep["Lagged Features<br/>[forecast_model.py]"]
  node_backtest["Temporal Backtest<br/>[forecast_model.py]"]
  node_model["XGBoost Forecast<br/>[forecast_model.py]"]
end

subgraph group_intelligence["Risk Intelligence"]
  node_risk_class["Risk Classification<br/>[forecast_model.py]"]
  node_explainability["Model Explainability"]
  node_risk_map["District Risk Mapping"]
  node_forecast_output["Forecast Summary"]
end

subgraph group_delivery["Decision Support"]
  node_dashboard["Interactive Dashboard<br/>[index.html]"]
  node_dhis2["DHIS2"]
  node_rise["RiSe Alerts"]
end

node_analyst(("Analyst"))
node_decision_maker(("Health Decision Maker"))
node_community_worker(("Community Health Worker"))

node_analyst -->|"runs forecast"| node_feature_prep
node_feature_prep -->|"reads data"| node_source_data
node_feature_prep -->|"writes features"| node_feature_file
node_backtest -->|"reads features"| node_feature_file
node_backtest -->|"trains and evaluates"| node_model
node_model -->|"predicts scores"| node_risk_class
node_risk_class -->|"writes forecasts"| node_forecast_output
node_explainability -.->|"explains predictions"| node_risk_class
node_geo_data -.->|"supports mapping"| node_risk_map
node_forecast_output -.->|"presents risk intelligence"| node_dashboard
node_risk_map -.->|"presents district risks"| node_dashboard
node_dashboard -.->|"supports decisions"| node_decision_maker
node_dhis2 -.->|"planned integration"| node_dashboard
node_dashboard -.->|"planned alert layer"| node_rise
node_rise -.->|"planned alerts"| node_community_worker

click node_source_data "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/CARES.csv"
click node_feature_prep "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py"
click node_backtest "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py"
click node_model "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py"
click node_risk_class "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py"
click node_explainability "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/Climate_Health_Risk_Kids_Under_5.ipynb"
click node_geo_data "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/geodata_audit.csv"
click node_dashboard "https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/index.html"

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_source_data,node_feature_file,node_geo_data toneBlue
class node_feature_prep,node_backtest,node_model toneAmber
class node_risk_class,node_explainability,node_risk_map,node_forecast_output toneMint
class node_dashboard,node_dhis2,node_rise,node_community_worker toneRose
class node_analyst,node_decision_maker toneIndigo
```

## Components

### Risk Data

- [CARES Data](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/CARES.csv): `CARES.csv`
- **Feature Dataset**
- [Geospatial Audit](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/geodata_audit.csv): `geodata_audit.csv`

### Forecasting

- [Lagged Features](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py): `forecast_model.py`
- [Temporal Backtest](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py): `forecast_model.py`
- [XGBoost Forecast](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py): `forecast_model.py`

### Risk Intelligence

- [Risk Classification](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/forecast_model.py): `forecast_model.py`
- [Model Explainability](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/Climate_Health_Risk_Kids_Under_5.ipynb): `Climate_Health_Risk_Kids_Under_5.ipynb`
- **District Risk Mapping**
- **Forecast Summary**

### Decision Support

- [Interactive Dashboard](https://github.com/nongolosh/ttx-disease-in-children-due-to-climate-change-/blob/main/index.html): `index.html`
- **DHIS2**
- **RiSe Alerts**

### Other components

- **Analyst**
- **Health Decision Maker**
- **Community Health Worker**

## Connections

- Analyst → Lagged Features: runs forecast (evidence: `forecast_model.py`)
- Lagged Features → CARES Data: reads data (evidence: `forecast_model.py`)
- Lagged Features → Feature Dataset: writes features (evidence: `forecast_model.py`)
- Temporal Backtest → Feature Dataset: reads features (evidence: `forecast_model.py`)
- Temporal Backtest → XGBoost Forecast: trains and evaluates (evidence: `forecast_model.py`)
- XGBoost Forecast → Risk Classification: predicts scores (evidence: `forecast_model.py`)
- Risk Classification → Forecast Summary: writes forecasts (evidence: `forecast_model.py`)
- Model Explainability → Risk Classification: explains predictions (evidence: `README.md`)
- Geospatial Audit → District Risk Mapping: supports mapping (evidence: `README.md`)
- Forecast Summary → Interactive Dashboard: presents risk intelligence (evidence: `README.md`)
- District Risk Mapping → Interactive Dashboard: presents district risks (evidence: `README.md`)
- Interactive Dashboard → Health Decision Maker: supports decisions (evidence: `README.md`)
- DHIS2 → Interactive Dashboard: planned integration (evidence: `README.md`)
- Interactive Dashboard → RiSe Alerts: planned alert layer (evidence: `README.md`)
- RiSe Alerts → Community Health Worker: planned alerts (evidence: `README.md`)
