# anasimran22/mindlytics-dashboard architecture

> Architecture diagram of the GitHub repository anasimran22/mindlytics-dashboard, 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/anasimran22/mindlytics-dashboard
- Repository: https://github.com/anasimran22/mindlytics-dashboard

## Overview

Mindlytics is a Streamlit dashboard for exploring an anonymized teen mental-health survey. Users select population filters, then inspect updated KPIs and four analytics areas; the risk explorer adds threshold controls and CSV export. The README documents these product stages, while the sampled app.py excerpt confirms KPI calculations and chart construction. Because app.py is a monolith and its data-loading and tab implementations are only partly excerpted, component boundaries follow documented capabilities rather than separate source modules.

Main entry points: [`app.py`](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py) (Filtered Population), [`Teen_Mental_Health_Dataset.csv`](https://github.com/anasimran22/mindlytics-dashboard/blob/main/Teen_Mental_Health_Dataset.csv) (Survey Dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_filtering["Population Filtering"]
  node_dataset[("Survey Dataset")]
  node_filters["Population Filters<br/>[app.py]"]
  node_cohort["Filtered Population<br/>[app.py]"]
end

subgraph group_overview["Dashboard Overview"]
  node_dashboard["Streamlit Dashboard<br/>[app.py]"]
  node_kpis["KPI Summary<br/>[app.py]"]
end

subgraph group_analytics["Analytics Tabs"]
  node_usage["Usage &amp; Sleep<br/>[app.py]"]
  node_stress["Stress &amp; Anxiety<br/>[app.py]"]
  node_academics["Academics &amp; Activity<br/>[app.py]"]
end

subgraph group_risk["Risk Exploration"]
  node_risk["Risk Explorer<br/>[app.py]"]
  node_export["Filtered CSV Export<br/>[app.py]"]
end

node_user(("Dashboard User"))

node_user -->|"opens"| node_dashboard
node_dashboard -->|"reads"| node_dataset
node_user -->|"selects"| node_filters
node_dataset -->|"provides records"| node_cohort
node_filters -->|"filter records"| node_cohort
node_cohort -->|"updates metrics"| node_kpis
node_cohort -->|"updates charts"| node_usage
node_cohort -->|"updates charts"| node_stress
node_cohort -->|"updates charts"| node_academics
node_user -->|"sets thresholds"| node_risk
node_cohort -->|"explores profiles"| node_risk
node_risk -->|"downloads subset"| node_export

click node_dashboard "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_dataset "https://github.com/anasimran22/mindlytics-dashboard/blob/main/Teen_Mental_Health_Dataset.csv"
click node_filters "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_cohort "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_kpis "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_usage "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_stress "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_academics "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_risk "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py"
click node_export "https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.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_dataset,node_filters,node_cohort,node_user toneBlue
class node_dashboard,node_kpis toneAmber
class node_usage,node_stress,node_academics toneMint
class node_risk,node_export toneRose
```

## Components

### Population Filtering

- [Survey Dataset](https://github.com/anasimran22/mindlytics-dashboard/blob/main/Teen_Mental_Health_Dataset.csv): `Teen_Mental_Health_Dataset.csv`
- [Population Filters](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`
- [Filtered Population](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`

### Dashboard Overview

- [Streamlit Dashboard](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`
- [KPI Summary](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`

### Analytics Tabs

- [Usage & Sleep](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`
- [Stress & Anxiety](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`
- [Academics & Activity](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`

### Risk Exploration

- [Risk Explorer](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`
- [Filtered CSV Export](https://github.com/anasimran22/mindlytics-dashboard/blob/main/app.py): `app.py`

### Other components

- **Dashboard User**

## Connections

- Dashboard User → Streamlit Dashboard: opens (evidence: `README.md`)
- Streamlit Dashboard → Survey Dataset: reads (evidence: `README.md`)
- Dashboard User → Population Filters: selects (evidence: `README.md`)
- Survey Dataset → Filtered Population: provides records (evidence: `README.md`)
- Population Filters → Filtered Population: filter records (evidence: `README.md`)
- Filtered Population → KPI Summary: updates metrics (evidence: `README.md`)
- Filtered Population → Usage & Sleep: updates charts (evidence: `README.md`)
- Filtered Population → Stress & Anxiety: updates charts (evidence: `README.md`)
- Filtered Population → Academics & Activity: updates charts (evidence: `README.md`)
- Dashboard User → Risk Explorer: sets thresholds (evidence: `README.md`)
- Filtered Population → Risk Explorer: explores profiles (evidence: `README.md`)
- Risk Explorer → Filtered CSV Export: downloads subset (evidence: `README.md`)
