# xzhe0014/fit4701-4702-fyp architecture

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

- Interactive diagram: https://gitdiagram.com/xzhe0014/fit4701-4702-fyp
- Repository: https://github.com/xzhe0014/fit4701-4702-fyp

## Overview

Cardio Vision AI is a web app for cardiovascular disease prediction. Users enter patient data manually, upload a file, or select a dataset, then request predictions and can view results. The backend exposes prediction, dataset, patient-result, and authentication APIs; inference preprocesses inputs and invokes a loaded model. Users can also save and manage patient/result records. The repository includes a separate model-training workflow. Edges reflect excerpts, SOURCE INDEX references, or README statements; unsampled page behavior and unshown connections are omitted.

Main entry points: [`cardio-vision-ai/backend/server.js`](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/server.js) (HTTP server), [`cardio-vision-ai/frontend/src/pages/PredictionPage.js`](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/pages/PredictionPage.js) (Prediction page), [`cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js`](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js) (Ensemble training), [`cardio-vision-ai/frontend/src/App.js`](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/App.js) (Page routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Page routing<br/>[App.js]"]
  node_authui["Auth context<br/>[AuthContext.js]"]
  node_predictionui["Prediction page<br/>[PredictionPage.js]"]
  node_datasetselect["Dataset selector<br/>[DatasetSelector.js]"]
  node_fileupload["File uploader<br/>[FileUploader.js]"]
  node_manualentry["Manual entry<br/>[ManualEntry.js]"]
  node_resultspage["Results page<br/>[ResultsPage.js]"]
  node_resultview["Result display"]
  node_charts["Prediction charts"]
end

subgraph group_api["Backend APIs"]
  node_server["HTTP server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_authguard["JWT guard<br/>[authMiddleware.js]"]
  node_predroutes["Prediction routes"]
  node_predcontroller["Prediction controller"]
  node_datasetroutes["Dataset routes<br/>[datasetRoutes.js]"]
  node_datasetcontroller["Dataset processing"]
  node_patientroutes["Patient routes<br/>[patientRoutes.js]"]
  node_patientcontroller["Patient results"]
end

subgraph group_data["Persistence"]
  node_dbconfig["DB connection<br/>[db.js]"]
  node_users[("User records<br/>[User.js]")]
  node_datasets[("Dataset records<br/>[Dataset.js]")]
  node_patients[("Patient records<br/>[Patient.js]")]
  node_savedresults[("Saved predictions")]
end

subgraph group_ml["Model workflow"]
  node_model["Model loader<br/>[loadModel.js]"]
  node_preprocess["Input preprocessing<br/>[preprocessInput.js]"]
  node_trainingrun["Training runner<br/>[run.js]"]
  node_processdata["Data processing<br/>[processData.js]"]
  node_ensemble["Ensemble training<br/>[ensemble.js]"]
  node_encoder["Label encoding<br/>[labelEncoder.js]"]
  node_split["Train test split<br/>[trainTestSplit.js]"]
  node_metrics["Model metrics<br/>[metrics.js]"]
end

node_user(("User"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_predictionui
node_app -->|"routes to"| node_resultspage
node_user -->|"authenticates"| node_authui
node_predictionui -->|"renders"| node_datasetselect
node_predictionui -->|"renders"| node_fileupload
node_predictionui -->|"renders"| node_manualentry
node_resultspage -->|"renders"| node_resultview
node_resultspage -->|"renders"| node_charts
node_predictionui -->|"posts prediction"| node_server
node_authui -->|"calls auth API"| node_server
node_server -->|"connects"| node_dbconfig
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_predroutes
node_server -->|"mounts"| node_datasetroutes
node_server -->|"mounts"| node_patientroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"protects user route"| node_authguard
node_authcontroller -->|"reads and writes"| node_users
node_authguard -->|"loads user"| node_users
node_predroutes -->|"dispatches"| node_predcontroller
node_predcontroller -->|"preprocesses input"| node_preprocess
node_predcontroller -->|"loads model"| node_model
node_datasetroutes -->|"dispatches"| node_datasetcontroller
node_datasetcontroller -->|"reads and writes"| node_datasets
node_patientroutes -->|"dispatches"| node_patientcontroller
node_patientroutes -->|"protects routes"| node_authguard
node_patientcontroller -->|"reads and writes"| node_patients
node_patientcontroller -->|"reads and writes"| node_savedresults
node_dbconfig -->|"connects"| node_mongodb
node_trainingrun -->|"uses"| node_processdata
node_trainingrun -->|"runs training"| node_ensemble
node_ensemble -->|"uses"| node_encoder
node_ensemble -->|"uses"| node_split
node_ensemble -->|"uses"| node_metrics

click node_app "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/App.js"
click node_authui "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/context/AuthContext.js"
click node_predictionui "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/pages/PredictionPage.js"
click node_datasetselect "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/DatasetSelector.js"
click node_fileupload "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/FileUploader.js"
click node_manualentry "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/ManualEntry.js"
click node_resultspage "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/pages/ResultsPage.js"
click node_resultview "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/PredictionResults.js"
click node_charts "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/PredictionCharts.js"
click node_server "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/server.js"
click node_authroutes "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/authRoutes.js"
click node_authcontroller "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/authController.js"
click node_authguard "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/middleware/authMiddleware.js"
click node_predroutes "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/predictionRoutes.js"
click node_predcontroller "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/predictionController.js"
click node_datasetroutes "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/datasetRoutes.js"
click node_datasetcontroller "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/datasetController.js"
click node_patientroutes "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/patientRoutes.js"
click node_patientcontroller "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/patientController.js"
click node_dbconfig "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/config/db.js"
click node_users "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/User.js"
click node_datasets "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/Dataset.js"
click node_patients "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/Patient.js"
click node_savedresults "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/PredictionResult.js"
click node_model "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/loadModel.js"
click node_preprocess "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/utils/preprocessInput.js"
click node_trainingrun "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/run.js"
click node_processdata "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/processData.js"
click node_ensemble "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js"
click node_encoder "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/labelEncoder.js"
click node_split "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/trainTestSplit.js"
click node_metrics "https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/metrics.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_app,node_authui,node_predictionui,node_datasetselect,node_fileupload,node_manualentry,node_resultspage,node_resultview,node_charts,node_user toneBlue
class node_server,node_authroutes,node_authcontroller,node_authguard,node_predroutes,node_predcontroller,node_datasetroutes,node_datasetcontroller,node_patientroutes,node_patientcontroller,node_mongodb toneAmber
class node_dbconfig,node_users,node_datasets,node_patients,node_savedresults toneMint
class node_model,node_preprocess,node_trainingrun,node_processdata,node_ensemble,node_encoder,node_split,node_metrics toneRose
```

## Components

### Web application

- [Page routing](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/App.js): `cardio-vision-ai/frontend/src/App.js`
- [Auth context](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/context/AuthContext.js): `cardio-vision-ai/frontend/src/context/AuthContext.js`
- [Prediction page](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/pages/PredictionPage.js): `cardio-vision-ai/frontend/src/pages/PredictionPage.js`
- [Dataset selector](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/DatasetSelector.js): `cardio-vision-ai/frontend/src/components/DatasetSelector.js`
- [File uploader](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/FileUploader.js): `cardio-vision-ai/frontend/src/components/FileUploader.js`
- [Manual entry](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/ManualEntry.js): `cardio-vision-ai/frontend/src/components/ManualEntry.js`
- [Results page](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/pages/ResultsPage.js): `cardio-vision-ai/frontend/src/pages/ResultsPage.js`
- [Result display](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/PredictionResults.js): `cardio-vision-ai/frontend/src/components/PredictionResults.js`
- [Prediction charts](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/frontend/src/components/PredictionCharts.js): `cardio-vision-ai/frontend/src/components/PredictionCharts.js`

### Backend APIs

- [HTTP server](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/server.js): `cardio-vision-ai/backend/server.js`
- [Auth routes](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/authRoutes.js): `cardio-vision-ai/backend/routes/authRoutes.js`
- [Auth controller](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/authController.js): `cardio-vision-ai/backend/controllers/authController.js`
- [JWT guard](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/middleware/authMiddleware.js): `cardio-vision-ai/backend/middleware/authMiddleware.js`
- [Prediction routes](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/predictionRoutes.js): `cardio-vision-ai/backend/routes/predictionRoutes.js`
- [Prediction controller](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/predictionController.js): `cardio-vision-ai/backend/controllers/predictionController.js`
- [Dataset routes](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/datasetRoutes.js): `cardio-vision-ai/backend/routes/datasetRoutes.js`
- [Dataset processing](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/datasetController.js): `cardio-vision-ai/backend/controllers/datasetController.js`
- [Patient routes](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/routes/patientRoutes.js): `cardio-vision-ai/backend/routes/patientRoutes.js`
- [Patient results](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/controllers/patientController.js): `cardio-vision-ai/backend/controllers/patientController.js`

### Persistence

- [DB connection](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/config/db.js): `cardio-vision-ai/backend/config/db.js`
- [User records](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/User.js): `cardio-vision-ai/backend/models/User.js`
- [Dataset records](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/Dataset.js): `cardio-vision-ai/backend/models/Dataset.js`
- [Patient records](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/Patient.js): `cardio-vision-ai/backend/models/Patient.js`
- [Saved predictions](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/PredictionResult.js): `cardio-vision-ai/backend/models/PredictionResult.js`

### Model workflow

- [Model loader](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/models/loadModel.js): `cardio-vision-ai/backend/models/loadModel.js`
- [Input preprocessing](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/utils/preprocessInput.js): `cardio-vision-ai/backend/utils/preprocessInput.js`
- [Training runner](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/run.js): `cardio-vision-ai/backend/trainedModels/trainingScript/run.js`
- [Data processing](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/processData.js): `cardio-vision-ai/backend/trainedModels/trainingScript/processData.js`
- [Ensemble training](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js): `cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js`
- [Label encoding](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/labelEncoder.js): `cardio-vision-ai/backend/trainedModels/trainingScript/labelEncoder.js`
- [Train test split](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/trainTestSplit.js): `cardio-vision-ai/backend/trainedModels/trainingScript/trainTestSplit.js`
- [Model metrics](https://github.com/xzhe0014/fit4701-4702-fyp/blob/main/cardio-vision-ai/backend/trainedModels/trainingScript/metrics.js): `cardio-vision-ai/backend/trainedModels/trainingScript/metrics.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Page routing: uses
- Page routing → Prediction page: routes to (evidence: `cardio-vision-ai/frontend/src/App.js`)
- Page routing → Results page: routes to (evidence: `cardio-vision-ai/frontend/src/App.js`)
- User → Auth context: authenticates (evidence: `cardio-vision-ai/frontend/src/context/AuthContext.js`)
- Prediction page → Dataset selector: renders (evidence: `cardio-vision-ai/frontend/src/pages/PredictionPage.js`)
- Prediction page → File uploader: renders (evidence: `cardio-vision-ai/frontend/src/pages/PredictionPage.js`)
- Prediction page → Manual entry: renders (evidence: `cardio-vision-ai/frontend/src/pages/PredictionPage.js`)
- Results page → Result display: renders (evidence: `cardio-vision-ai/frontend/src/pages/ResultsPage.js`)
- Results page → Prediction charts: renders (evidence: `cardio-vision-ai/frontend/src/pages/ResultsPage.js`)
- Prediction page → HTTP server: posts prediction (evidence: `cardio-vision-ai/frontend/src/pages/PredictionPage.js`)
- Auth context → HTTP server: calls auth API (evidence: `cardio-vision-ai/frontend/src/context/AuthContext.js`)
- HTTP server → DB connection: connects (evidence: `cardio-vision-ai/backend/server.js`)
- HTTP server → Auth routes: mounts (evidence: `cardio-vision-ai/backend/server.js`)
- HTTP server → Prediction routes: mounts (evidence: `cardio-vision-ai/backend/server.js`)
- HTTP server → Dataset routes: mounts (evidence: `cardio-vision-ai/backend/server.js`)
- HTTP server → Patient routes: mounts (evidence: `cardio-vision-ai/backend/server.js`)
- Auth routes → Auth controller: dispatches (evidence: `cardio-vision-ai/backend/routes/authRoutes.js`)
- Auth routes → JWT guard: protects user route (evidence: `cardio-vision-ai/backend/routes/authRoutes.js`)
- Auth controller → User records: reads and writes (evidence: `cardio-vision-ai/backend/controllers/authController.js`)
- JWT guard → User records: loads user (evidence: `cardio-vision-ai/backend/middleware/authMiddleware.js`)
- Prediction routes → Prediction controller: dispatches (evidence: `cardio-vision-ai/backend/routes/predictionRoutes.js`)
- Prediction controller → Input preprocessing: preprocesses input (evidence: `cardio-vision-ai/backend/controllers/predictionController.js`)
- Prediction controller → Model loader: loads model (evidence: `cardio-vision-ai/backend/controllers/predictionController.js`)
- Dataset routes → Dataset processing: dispatches (evidence: `cardio-vision-ai/backend/routes/datasetRoutes.js`)
- Dataset processing → Dataset records: reads and writes (evidence: `cardio-vision-ai/backend/controllers/datasetController.js`)
- Patient routes → Patient results: dispatches (evidence: `cardio-vision-ai/backend/routes/patientRoutes.js`)
- Patient routes → JWT guard: protects routes (evidence: `cardio-vision-ai/backend/routes/patientRoutes.js`)
- Patient results → Patient records: reads and writes (evidence: `cardio-vision-ai/backend/controllers/patientController.js`)
- Patient results → Saved predictions: reads and writes (evidence: `cardio-vision-ai/backend/controllers/patientController.js`)
- DB connection → MongoDB: connects (evidence: `README.md`)
- Training runner → Data processing: uses (evidence: `cardio-vision-ai/backend/trainedModels/trainingScript/run.js`)
- Training runner → Ensemble training: runs training (evidence: `cardio-vision-ai/backend/trainedModels/trainingScript/run.js`)
- Ensemble training → Label encoding: uses (evidence: `cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js`)
- Ensemble training → Train test split: uses (evidence: `cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js`)
- Ensemble training → Model metrics: uses (evidence: `cardio-vision-ai/backend/trainedModels/trainingScript/ensemble.js`)
