# ishaq-5012/retinavision architecture

> Architecture diagram of the GitHub repository ishaq-5012/retinavision, 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/ishaq-5012/retinavision
- Repository: https://github.com/ishaq-5012/retinavision

## Overview

RetinaVision (branded CardioVisionAI in the backend) is a retinal cardiovascular-risk screening application with patient, doctor, and researcher experiences. Users authenticate, submit retinal scans and clinical factors, and view screening results; the backend exposes upload, prediction, and result endpoints. The source index supports the backend pipeline’s internal stages and Groq integration, but the sampled frontend excerpts do not establish how the browser reaches those endpoints. Research, care-team, analytics, and model-training capabilities are shown as distinct branches where supported by the tree and index.

Main entry points: [`src/App.tsx`](https://github.com/ishaq-5012/retinavision/blob/main/src/App.tsx) (Route application), [`backend/ai_engine/prediction/predict.py`](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/prediction/predict.py) (Risk prediction pipeline), [`backend/api/predict.py`](https://github.com/ishaq-5012/retinavision/blob/main/backend/api/predict.py) (Prediction route), [`backend/main.py`](https://github.com/ishaq-5012/retinavision/blob/main/backend/main.py) (FastAPI endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Route application<br/>[App.tsx]"]
  node_uploadui["Scan upload<br/>[UploadPage.tsx]"]
  node_resultui["Prediction results"]
  node_explainui["AI explanation"]
  node_patientui["Patient dashboard"]
  node_doctorui["Doctor dashboard"]
  node_careui["Care team<br/>[CareTeamPage.tsx]"]
  node_historyui["Scan history"]
  node_analyticsui["Analytics dashboard"]
end

subgraph group_identity["Identity and data"]
  node_auth["Auth provider<br/>[useAuth.tsx]"]
  node_supabase[("Supabase platform<br/>[supabase.ts]")]
end

subgraph group_screening["Screening backend"]
  node_api["FastAPI endpoints<br/>[main.py]"]
  node_api_routes["Upload / result routes<br/>[upload.py]"]
  node_predict_route["Prediction route<br/>[predict.py]"]
  node_pipeline["Risk prediction pipeline<br/>[predict.py]"]
  node_preprocess["Image preprocessing<br/>[preprocess.py]"]
  node_biomarkers["Vessel biomarkers<br/>[extraction.py]"]
  node_clinical["Clinical risk model<br/>[clinical_model.py]"]
  node_fusion["Risk fusion<br/>[fusion_model.py]"]
  node_gradcam["Saliency explanation<br/>[gradcam.py]"]
  node_groq["Groq vision interpretation"]
end

subgraph group_research["Research and training"]
  node_researchui["Research hub"]
  node_researchdata["Research data access<br/>[research.ts]"]
  node_training["Model training<br/>[train.py]"]
end

node_user(("Patient / clinician"))

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"routes to"| node_uploadui
node_app -->|"routes to"| node_resultui
node_app -->|"routes to"| node_explainui
node_app -->|"routes to"| node_patientui
node_app -->|"routes to"| node_doctorui
node_app -->|"routes to"| node_careui
node_app -->|"routes to"| node_historyui
node_app -->|"routes to"| node_analyticsui
node_app -->|"routes to"| node_researchui
node_auth -->|"auth and profile access"| node_supabase
node_researchui -->|"loads research data"| node_researchdata
node_api -->|"registers routes"| node_api_routes
node_api -->|"registers routes"| node_predict_route
node_predict_route -->|"runs prediction"| node_pipeline
node_predict_route -->|"requests interpretation"| node_groq
node_pipeline -->|"preprocesses image"| node_preprocess
node_pipeline -->|"extracts biomarkers"| node_biomarkers
node_pipeline -->|"encodes clinical factors"| node_clinical
node_pipeline -->|"combines risk inputs"| node_fusion
node_pipeline -->|"generates saliency"| node_gradcam
node_training -.->|"exports artifacts"| node_supabase

click node_app "https://github.com/ishaq-5012/retinavision/blob/main/src/App.tsx"
click node_auth "https://github.com/ishaq-5012/retinavision/blob/main/src/hooks/useAuth.tsx"
click node_supabase "https://github.com/ishaq-5012/retinavision/blob/main/src/lib/supabase.ts"
click node_uploadui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/UploadPage.tsx"
click node_resultui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/PredictionResultPage.tsx"
click node_explainui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/ExplainableAIPage.tsx"
click node_patientui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/PatientDashboard.tsx"
click node_doctorui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/DoctorDashboard.tsx"
click node_careui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/CareTeamPage.tsx"
click node_historyui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/ScanHistoryPage.tsx"
click node_analyticsui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/AnalyticsDashboard.tsx"
click node_researchui "https://github.com/ishaq-5012/retinavision/blob/main/src/pages/ResearchHubPage.tsx"
click node_researchdata "https://github.com/ishaq-5012/retinavision/blob/main/src/lib/research.ts"
click node_api "https://github.com/ishaq-5012/retinavision/blob/main/backend/main.py"
click node_api_routes "https://github.com/ishaq-5012/retinavision/blob/main/backend/api/upload.py"
click node_predict_route "https://github.com/ishaq-5012/retinavision/blob/main/backend/api/predict.py"
click node_pipeline "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/prediction/predict.py"
click node_preprocess "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/preprocessing/preprocess.py"
click node_biomarkers "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/biomarkers/extraction.py"
click node_clinical "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/clinical_model.py"
click node_fusion "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/fusion_model.py"
click node_gradcam "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/explainability/gradcam.py"
click node_groq "https://github.com/ishaq-5012/retinavision/blob/main/backend/services/groq_vision_service.py"
click node_training "https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/training/train.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_app,node_uploadui,node_resultui,node_explainui,node_patientui,node_doctorui,node_careui,node_historyui,node_analyticsui toneBlue
class node_auth,node_supabase toneAmber
class node_api,node_api_routes,node_predict_route,node_pipeline,node_preprocess,node_biomarkers,node_clinical,node_fusion,node_gradcam,node_groq toneMint
class node_researchui,node_researchdata,node_training toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Route application](https://github.com/ishaq-5012/retinavision/blob/main/src/App.tsx): `src/App.tsx`
- [Scan upload](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/UploadPage.tsx): `src/pages/UploadPage.tsx`
- [Prediction results](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/PredictionResultPage.tsx): `src/pages/PredictionResultPage.tsx`
- [AI explanation](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/ExplainableAIPage.tsx): `src/pages/ExplainableAIPage.tsx`
- [Patient dashboard](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/PatientDashboard.tsx): `src/pages/PatientDashboard.tsx`
- [Doctor dashboard](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/DoctorDashboard.tsx): `src/pages/DoctorDashboard.tsx`
- [Care team](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/CareTeamPage.tsx): `src/pages/CareTeamPage.tsx`
- [Scan history](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/ScanHistoryPage.tsx): `src/pages/ScanHistoryPage.tsx`
- [Analytics dashboard](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/AnalyticsDashboard.tsx): `src/pages/AnalyticsDashboard.tsx`

### Identity and data

- [Auth provider](https://github.com/ishaq-5012/retinavision/blob/main/src/hooks/useAuth.tsx): `src/hooks/useAuth.tsx`
- [Supabase platform](https://github.com/ishaq-5012/retinavision/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`

### Screening backend

- [FastAPI endpoints](https://github.com/ishaq-5012/retinavision/blob/main/backend/main.py): `backend/main.py`
- [Upload / result routes](https://github.com/ishaq-5012/retinavision/blob/main/backend/api/upload.py): `backend/api/upload.py`
- [Prediction route](https://github.com/ishaq-5012/retinavision/blob/main/backend/api/predict.py): `backend/api/predict.py`
- [Risk prediction pipeline](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/prediction/predict.py): `backend/ai_engine/prediction/predict.py`
- [Image preprocessing](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/preprocessing/preprocess.py): `backend/ai_engine/preprocessing/preprocess.py`
- [Vessel biomarkers](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/biomarkers/extraction.py): `backend/ai_engine/biomarkers/extraction.py`
- [Clinical risk model](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/clinical_model.py): `backend/ai_engine/clinical_model.py`
- [Risk fusion](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/fusion_model.py): `backend/ai_engine/fusion_model.py`
- [Saliency explanation](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/explainability/gradcam.py): `backend/ai_engine/explainability/gradcam.py`
- [Groq vision interpretation](https://github.com/ishaq-5012/retinavision/blob/main/backend/services/groq_vision_service.py): `backend/services/groq_vision_service.py`

### Research and training

- [Research hub](https://github.com/ishaq-5012/retinavision/blob/main/src/pages/ResearchHubPage.tsx): `src/pages/ResearchHubPage.tsx`
- [Research data access](https://github.com/ishaq-5012/retinavision/blob/main/src/lib/research.ts): `src/lib/research.ts`
- [Model training](https://github.com/ishaq-5012/retinavision/blob/main/backend/ai_engine/training/train.py): `backend/ai_engine/training/train.py`

### Other components

- **Patient / clinician**

## Connections

- Patient / clinician → Route application: uses (evidence: `src/App.tsx`)
- Route application → Auth provider: provides auth (evidence: `src/App.tsx`)
- Route application → Scan upload: routes to (evidence: `src/App.tsx`)
- Route application → Prediction results: routes to (evidence: `src/App.tsx`)
- Route application → AI explanation: routes to (evidence: `src/App.tsx`)
- Route application → Patient dashboard: routes to (evidence: `src/App.tsx`)
- Route application → Doctor dashboard: routes to (evidence: `src/App.tsx`)
- Route application → Care team: routes to (evidence: `src/App.tsx`)
- Route application → Scan history: routes to (evidence: `src/App.tsx`)
- Route application → Analytics dashboard: routes to (evidence: `src/App.tsx`)
- Route application → Research hub: routes to (evidence: `src/App.tsx`)
- Auth provider → Supabase platform: auth and profile access (evidence: `src/hooks/useAuth.tsx`)
- Research hub → Research data access: loads research data (evidence: `src/pages/ResearchHubPage.tsx`)
- FastAPI endpoints → Upload / result routes: registers routes (evidence: `backend/main.py`)
- FastAPI endpoints → Prediction route: registers routes (evidence: `backend/main.py`)
- Prediction route → Risk prediction pipeline: runs prediction (evidence: `backend/api/predict.py`)
- Prediction route → Groq vision interpretation: requests interpretation (evidence: `backend/api/predict.py`)
- Risk prediction pipeline → Image preprocessing: preprocesses image (evidence: `backend/ai_engine/prediction/predict.py`)
- Risk prediction pipeline → Vessel biomarkers: extracts biomarkers (evidence: `backend/ai_engine/prediction/predict.py`)
- Risk prediction pipeline → Clinical risk model: encodes clinical factors (evidence: `backend/ai_engine/prediction/predict.py`)
- Risk prediction pipeline → Risk fusion: combines risk inputs (evidence: `backend/ai_engine/prediction/predict.py`)
- Risk prediction pipeline → Saliency explanation: generates saliency (evidence: `backend/ai_engine/prediction/predict.py`)
- Model training → Supabase platform: exports artifacts
