# flango2023/pulso architecture

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

- Interactive diagram: https://gitdiagram.com/flango2023/pulso
- Repository: https://github.com/flango2023/pulso

## Overview

Pulso Phase 1 is a data-preparation deliverable, not a running application: it provides a Cleveland heart-disease CSV, scientific text for later NLP, and governance context for downstream AI work. The documented workflow is to use these prepared data assets as inputs to later analysis and modeling; missing-value treatment is explicitly deferred to Phase 2. The repository also documents externally hosted ECG images and a future wearable/IoT direction. No source excerpts were available, so relationships below are limited to README statements.

Main entry points: [`data/heart_disease.csv`](https://github.com/flango2023/pulso/blob/main/data/heart_disease.csv) (Heart disease CSV), [`assets/images/image_manifest.md`](https://github.com/flango2023/pulso/blob/main/assets/images/image_manifest.md) (ECG image manifest), [`assets/texts`](https://github.com/flango2023/pulso/tree/main/assets/texts) (Cardiology texts), [`docs/governance.md`](https://github.com/flango2023/pulso/blob/main/docs/governance.md) (Data governance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_numeric["Clinical data"]
  node_heart_csv[("Heart disease CSV<br/>[heart_disease.csv]")]
end

subgraph group_research["Research materials"]
  node_research_texts["Cardiology texts"]
  node_image_manifest["ECG image manifest<br/>[image_manifest.md]"]
end

subgraph group_governance["Governance and roadmap"]
  node_governance_doc["Data governance<br/>[governance.md]"]
  node_iot_direction["Wearable IoT direction<br/>[README.md]"]
end

node_analyst(("AI analyst"))
node_ecg_images[("External ECG images")]

node_analyst -->|"uses"| node_heart_csv
node_analyst -->|"uses"| node_research_texts
node_heart_csv -->|"documents bias"| node_governance_doc
node_image_manifest -->|"links to"| node_ecg_images
node_heart_csv -->|"prepares for"| node_iot_direction

click node_heart_csv "https://github.com/flango2023/pulso/blob/main/data/heart_disease.csv"
click node_research_texts "https://github.com/flango2023/pulso/tree/main/assets/texts"
click node_governance_doc "https://github.com/flango2023/pulso/blob/main/docs/governance.md"
click node_image_manifest "https://github.com/flango2023/pulso/blob/main/assets/images/image_manifest.md"
click node_iot_direction "https://github.com/flango2023/pulso/blob/main/README.md"

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_heart_csv toneBlue
class node_research_texts,node_image_manifest,node_ecg_images toneAmber
class node_governance_doc,node_iot_direction toneMint
class node_analyst toneIndigo
```

## Components

### Clinical data

- [Heart disease CSV](https://github.com/flango2023/pulso/blob/main/data/heart_disease.csv): `data/heart_disease.csv`

### Research materials

- [Cardiology texts](https://github.com/flango2023/pulso/tree/main/assets/texts): `assets/texts`
- [ECG image manifest](https://github.com/flango2023/pulso/blob/main/assets/images/image_manifest.md): `assets/images/image_manifest.md`

### Governance and roadmap

- [Data governance](https://github.com/flango2023/pulso/blob/main/docs/governance.md): `docs/governance.md`
- [Wearable IoT direction](https://github.com/flango2023/pulso/blob/main/README.md): `README.md`

### Other components

- **AI analyst**
- **External ECG images**

## Connections

- AI analyst → Heart disease CSV: uses (evidence: `README.md`)
- AI analyst → Cardiology texts: uses (evidence: `README.md`)
- Heart disease CSV → Data governance: documents bias (evidence: `README.md`)
- ECG image manifest → External ECG images: links to (evidence: `README.md`)
- Heart disease CSV → Wearable IoT direction: prepares for (evidence: `README.md`)