# pradyumnan-ramanathan/cardio-predictor architecture

> Architecture diagram of the GitHub repository pradyumnan-ramanathan/cardio-predictor, 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/pradyumnan-ramanathan/cardio-predictor
- Repository: https://github.com/pradyumnan-ramanathan/cardio-predictor

## Overview

Cardio Predictor accepts a user’s health measurements, authenticates the request, obtains a risk prediction from the Python ML service, then generates feedback, emails it, and stores prediction history. The repository also contains a separate Python prediction/history API with its own Firebase verification and MongoEngine persistence. Source excerpts show the Node-to-ML request but not token forwarding; the Python endpoint requires a bearer token, so that integration detail remains uncertain. No README was provided, and training artifacts are not mapped because their runtime use is not evidenced.

Main entry points: [`backend/src/routes/predict.js`](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/routes/predict.js) (Prediction Workflow), [`backend/src/server.js`](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/server.js) (HTTP Server), [`backend/ml-service/app.py`](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/app.py) (Prediction API), [`backend/src/routes/authRoutes.js`](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/routes/authRoutes.js) (User Sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_node_api["Node API"]
  node_node_server["HTTP Server<br/>[server.js]"]
  node_node_app["Express App<br/>[app.js]"]
  node_predict_route["Prediction Workflow<br/>[predict.js]"]
end

subgraph group_identity["Identity"]
  node_auth_routes["User Sync<br/>[authRoutes.js]"]
  node_token_middleware["Token Verification"]
  node_firebase_admin["Firebase Admin<br/>[firebase.js]"]
  node_firebase["Firebase Auth"]
end

subgraph group_ml_service["ML Service"]
  node_ml_api["Prediction API<br/>[app.py]"]
  node_ml_auth_setup["Firebase Setup"]
  node_ml_prediction_model[("Prediction Record<br/>[Prediction.py]")]
end

subgraph group_persistence["Persistence"]
  node_user_model[("User Records<br/>[User.js]")]
  node_node_db_config["Mongo Connection<br/>[db.js]"]
  node_mongo[("MongoDB")]
end

subgraph group_feedback["Feedback"]
  node_genai_messages["AI Messages<br/>[genAiMessages.js]"]
  node_groq_client["Groq Client<br/>[groqClient.js]"]
  node_groq_service["Groq API"]
  node_mailer["Email Sender<br/>[mailer.js]"]
  node_email_service["SMTP Email"]
end

node_client(("User"))

node_client -->|"sends requests"| node_node_server
node_node_server -->|"starts"| node_node_app
node_node_server -->|"connects"| node_node_db_config
node_node_server -->|"mounts routes"| node_auth_routes
node_node_server -->|"mounts routes"| node_predict_route
node_node_app -->|"mounts routes"| node_predict_route
node_auth_routes -->|"verifies with"| node_token_middleware
node_auth_routes -->|"reads and creates"| node_user_model
node_token_middleware -->|"uses"| node_firebase_admin
node_firebase_admin -->|"verifies tokens"| node_firebase
node_predict_route -->|"verifies with"| node_token_middleware
node_predict_route -->|"reads and saves"| node_user_model
node_predict_route -->|"posts measurements"| node_ml_api
node_predict_route -->|"generates feedback"| node_genai_messages
node_predict_route -->|"requests email"| node_mailer
node_node_db_config -.->|"connects"| node_mongo
node_ml_api -->|"initializes"| node_ml_auth_setup
node_ml_api -->|"creates and queries"| node_ml_prediction_model
node_ml_api -->|"connects"| node_mongo
node_ml_api -->|"verifies tokens"| node_firebase
node_genai_messages -->|"uses"| node_groq_client
node_groq_client -.->|"sends prompts"| node_groq_service
node_mailer -.->|"sends mail"| node_email_service

click node_node_server "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/server.js"
click node_node_app "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/app.js"
click node_auth_routes "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/routes/authRoutes.js"
click node_token_middleware "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/middleware/verifyFirebaseToken.js"
click node_firebase_admin "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/config/firebase.js"
click node_predict_route "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/routes/predict.js"
click node_user_model "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/models/User.js"
click node_node_db_config "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/config/db.js"
click node_ml_api "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/app.py"
click node_ml_auth_setup "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/firebase_admin_setup.py"
click node_ml_prediction_model "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/models/Prediction.py"
click node_genai_messages "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/utils/genAiMessages.js"
click node_groq_client "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/utils/groqClient.js"
click node_mailer "https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/utils/mailer.js"

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_node_server,node_node_app,node_predict_route,node_client toneBlue
class node_auth_routes,node_token_middleware,node_firebase_admin,node_firebase toneAmber
class node_ml_api,node_ml_auth_setup,node_ml_prediction_model toneMint
class node_user_model,node_node_db_config,node_mongo toneRose
class node_genai_messages,node_groq_client,node_groq_service,node_mailer,node_email_service toneIndigo
```

## Components

### Node API

- [HTTP Server](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/server.js): `backend/src/server.js`
- [Express App](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/app.js): `backend/src/app.js`
- [Prediction Workflow](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/routes/predict.js): `backend/src/routes/predict.js`

### Identity

- [User Sync](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Token Verification](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/middleware/verifyFirebaseToken.js): `backend/src/middleware/verifyFirebaseToken.js`
- [Firebase Admin](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/config/firebase.js): `backend/src/config/firebase.js`
- **Firebase Auth**

### ML Service

- [Prediction API](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/app.py): `backend/ml-service/app.py`
- [Firebase Setup](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/firebase_admin_setup.py): `backend/ml-service/firebase_admin_setup.py`
- [Prediction Record](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/ml-service/models/Prediction.py): `backend/ml-service/models/Prediction.py`

### Persistence

- [User Records](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/models/User.js): `backend/src/models/User.js`
- [Mongo Connection](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- **MongoDB**

### Feedback

- [AI Messages](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/utils/genAiMessages.js): `backend/src/utils/genAiMessages.js`
- [Groq Client](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/utils/groqClient.js): `backend/src/utils/groqClient.js`
- **Groq API**
- [Email Sender](https://github.com/pradyumnan-ramanathan/cardio-predictor/blob/main/backend/src/utils/mailer.js): `backend/src/utils/mailer.js`
- **SMTP Email**

### Other components

- **User**

## Connections

- User → HTTP Server: sends requests (evidence: `backend/src/server.js`)
- HTTP Server → Express App: starts (evidence: `backend/src/server.js`)
- HTTP Server → Mongo Connection: connects (evidence: `backend/src/server.js`)
- HTTP Server → User Sync: mounts routes (evidence: `backend/src/server.js`)
- HTTP Server → Prediction Workflow: mounts routes (evidence: `backend/src/server.js`)
- Express App → Prediction Workflow: mounts routes (evidence: `backend/src/app.js`)
- User Sync → Token Verification: verifies with (evidence: `backend/src/routes/authRoutes.js`)
- User Sync → User Records: reads and creates (evidence: `backend/src/routes/authRoutes.js`)
- Token Verification → Firebase Admin: uses (evidence: `backend/src/middleware/verifyFirebaseToken.js`)
- Firebase Admin → Firebase Auth: verifies tokens (evidence: `backend/src/config/firebase.js`)
- Prediction Workflow → Token Verification: verifies with (evidence: `backend/src/routes/predict.js`)
- Prediction Workflow → User Records: reads and saves (evidence: `backend/src/routes/predict.js`)
- Prediction Workflow → Prediction API: posts measurements (evidence: `backend/src/routes/predict.js`)
- Prediction Workflow → AI Messages: generates feedback (evidence: `backend/src/routes/predict.js`)
- Prediction Workflow → Email Sender: requests email (evidence: `backend/src/routes/predict.js`)
- Mongo Connection → MongoDB: connects
- Prediction API → Firebase Setup: initializes (evidence: `backend/ml-service/app.py`)
- Prediction API → Prediction Record: creates and queries (evidence: `backend/ml-service/app.py`)
- Prediction API → MongoDB: connects (evidence: `backend/ml-service/app.py`)
- Prediction API → Firebase Auth: verifies tokens (evidence: `backend/ml-service/app.py`)
- AI Messages → Groq Client: uses (evidence: `backend/src/utils/genAiMessages.js`)
- Groq Client → Groq API: sends prompts
- Email Sender → SMTP Email: sends mail
