# praman918/personalized-cardiovascular-disease-risk-prediction architecture

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

- Interactive diagram: https://gitdiagram.com/praman918/personalized-cardiovascular-disease-risk-prediction
- Repository: https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction

## Overview

This is a cardiovascular-risk web application backed by a simulated three-hospital federated-learning training workflow. The user enters 15 clinical features in the Streamlit app, which loads the trained model and presents a risk prediction, contributing factors, and recommendations. Separately, simulation orchestration generates and partitions synthetic records, coordinates local client training and server aggregation, evaluates the global model, and saves weights for the app. The graph preserves the README-described reporting capabilities; unsampled app sections are represented at subsystem level rather than treated as inspected implementation.

Main entry points: [`app.py`](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py) (Risk Inference), [`server.py`](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/server.py) (FL Server), [`client.py`](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/client.py) (Hospital Client), [`run_simulation.py`](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/run_simulation.py) (Simulation Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clinical["Clinical Risk App"]
  node_clinical_form["Clinical Form<br/>[app.py]"]
  node_risk_inference["Risk Inference<br/>[app.py]"]
  node_risk_gauge["Risk Gauge<br/>[app.py]"]
  node_risk_factors["Risk Badges<br/>[app.py]"]
  node_recommendations["Clinical Advice<br/>[app.py]"]
  node_xai_bars["Feature Contributions<br/>[app.py]"]
end

subgraph group_training["Federated Training"]
  node_simulation["Simulation Runner<br/>[run_simulation.py]"]
  node_fl_server["FL Server<br/>[server.py]"]
  node_hospital_client["Hospital Client<br/>[client.py]"]
end

subgraph group_modeling["Model and Data"]
  node_synthetic_data["EHR Generator<br/>[data_generator.py]"]
  node_training_data[("Partitioned CSV Data")]
  node_global_model["Global Model<br/>[model.py]"]
  node_model_weights["Saved Weights"]
end

node_patient(("Patient"))

node_patient -->|"enters data"| node_clinical_form
node_clinical_form -->|"submits features"| node_risk_inference
node_risk_inference -->|"loads and predicts"| node_global_model
node_risk_inference -->|"loads weights"| node_model_weights
node_risk_inference -->|"shows risk"| node_risk_gauge
node_risk_inference -->|"identifies factors"| node_risk_factors
node_risk_inference -->|"generates advice"| node_recommendations
node_risk_inference -->|"shows contributions"| node_xai_bars
node_simulation -->|"runs generator"| node_synthetic_data
node_synthetic_data -->|"writes partitions"| node_training_data
node_simulation -->|"starts clients"| node_hospital_client
node_simulation -->|"starts server"| node_fl_server
node_fl_server -->|"requests local training"| node_hospital_client
node_hospital_client -->|"reads client records"| node_training_data
node_hospital_client -->|"trains model"| node_global_model
node_fl_server -->|"aggregates and evaluates"| node_global_model
node_fl_server -->|"reads test set"| node_training_data
node_fl_server -->|"saves weights"| node_model_weights

click node_clinical_form "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py"
click node_risk_inference "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py"
click node_risk_gauge "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py"
click node_risk_factors "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py"
click node_recommendations "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py"
click node_xai_bars "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py"
click node_simulation "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/run_simulation.py"
click node_synthetic_data "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/data_generator.py"
click node_fl_server "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/server.py"
click node_hospital_client "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/client.py"
click node_global_model "https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/model.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_clinical_form,node_risk_inference,node_risk_gauge,node_risk_factors,node_recommendations,node_xai_bars toneBlue
class node_simulation,node_fl_server,node_hospital_client toneAmber
class node_synthetic_data,node_training_data,node_global_model,node_model_weights toneMint
class node_patient toneIndigo
```

## Components

### Clinical Risk App

- [Clinical Form](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py): `app.py`
- [Risk Inference](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py): `app.py`
- [Risk Gauge](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py): `app.py`
- [Risk Badges](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py): `app.py`
- [Clinical Advice](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py): `app.py`
- [Feature Contributions](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/app.py): `app.py`

### Federated Training

- [Simulation Runner](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/run_simulation.py): `run_simulation.py`
- [FL Server](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/server.py): `server.py`
- [Hospital Client](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/client.py): `client.py`

### Model and Data

- [EHR Generator](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/data_generator.py): `data_generator.py`
- **Partitioned CSV Data**
- [Global Model](https://github.com/praman918/personalized-cardiovascular-disease-risk-prediction/blob/main/model.py): `model.py`
- **Saved Weights**

### Other components

- **Patient**

## Connections

- Patient → Clinical Form: enters data (evidence: `README.md`)
- Clinical Form → Risk Inference: submits features (evidence: `README.md`)
- Risk Inference → Global Model: loads and predicts (evidence: `app.py`)
- Risk Inference → Saved Weights: loads weights (evidence: `app.py`)
- Risk Inference → Risk Gauge: shows risk (evidence: `README.md`)
- Risk Inference → Risk Badges: identifies factors (evidence: `README.md`)
- Risk Inference → Clinical Advice: generates advice (evidence: `app.py`)
- Risk Inference → Feature Contributions: shows contributions (evidence: `README.md`)
- Simulation Runner → EHR Generator: runs generator (evidence: `run_simulation.py`)
- EHR Generator → Partitioned CSV Data: writes partitions (evidence: `data_generator.py`)
- Simulation Runner → Hospital Client: starts clients (evidence: `run_simulation.py`)
- Simulation Runner → FL Server: starts server (evidence: `run_simulation.py`)
- FL Server → Hospital Client: requests local training (evidence: `server.py`)
- Hospital Client → Partitioned CSV Data: reads client records (evidence: `client.py`)
- Hospital Client → Global Model: trains model (evidence: `client.py`)
- FL Server → Global Model: aggregates and evaluates (evidence: `README.md`)
- FL Server → Partitioned CSV Data: reads test set (evidence: `server.py`)
- FL Server → Saved Weights: saves weights (evidence: `server.py`)
