# iblamelessly/ngo-data-analysis architecture

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

- Interactive diagram: https://gitdiagram.com/iblamelessly/ngo-data-analysis
- Repository: https://github.com/iblamelessly/ngo-data-analysis

## Overview

A small, single-script NGO donation analytics dashboard: it loads the workbook, computes summary metrics and grouped analytics, then renders and saves a four-panel visualization. The source shows no separate application layers or integrations beyond the spreadsheet input and Matplotlib output.

Main entry points: [`main.py`](https://github.com/iblamelessly/ngo-data-analysis/blob/main/main.py) (Dashboard script), [`ngo_data.xlsx`](https://github.com/iblamelessly/ngo-data-analysis/blob/main/ngo_data.xlsx) (Donation workbook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Donation analytics"]
  node_dashboard_script["Dashboard script<br/>[main.py]"]
end

subgraph group_dashboard["Dashboard output"]
  node_png["Dashboard image"]
  node_display["Interactive display"]
end

node_operator(("Dashboard user"))
node_workbook["Donation workbook<br/>[ngo_data.xlsx]"]

node_operator -->|"runs"| node_dashboard_script
node_dashboard_script -->|"reads"| node_workbook
node_dashboard_script -->|"saves"| node_png
node_dashboard_script -->|"shows"| node_display

click node_workbook "https://github.com/iblamelessly/ngo-data-analysis/blob/main/ngo_data.xlsx"
click node_dashboard_script "https://github.com/iblamelessly/ngo-data-analysis/blob/main/main.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_dashboard_script,node_operator toneBlue
class node_png,node_display toneAmber
class node_workbook toneTeal
```

## Components

### Donation analytics

- [Dashboard script](https://github.com/iblamelessly/ngo-data-analysis/blob/main/main.py): `main.py`

### Dashboard output

- **Dashboard image**
- **Interactive display**

### Other components

- **Dashboard user**
- [Donation workbook](https://github.com/iblamelessly/ngo-data-analysis/blob/main/ngo_data.xlsx): `ngo_data.xlsx`

## Connections

- Dashboard user → Dashboard script: runs
- Dashboard script → Donation workbook: reads (evidence: `main.py`)
- Dashboard script → Dashboard image: saves (evidence: `main.py`)
- Dashboard script → Interactive display: shows (evidence: `main.py`)
