# avinashcreates/medvault architecture

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

- Interactive diagram: https://gitdiagram.com/avinashcreates/medvault
- Repository: https://github.com/avinashcreates/medvault

## Overview

MedVault is a patient-facing medical-record vault with doctor access and advice workflows. Patients sign in, manage records and vitals, optionally request an AI summary, and share records with a doctor; doctors can access shared records and submit advice. The repository also contains a separate, simpler mock-backed app under `New folder`. Backend excerpts show authentication, records, advice, sharing, and database access; broader UI and backend wiring is based on the source index, so unsampled relationships are omitted.

Main entry points: [`medvault-backend/src/index.js`](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/index.js) (HTTP API), [`medvault/App.tsx`](https://github.com/avinashcreates/medvault/blob/main/medvault/App.tsx) (Vault interface), [`medvault-backend/src/database.js`](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/database.js) (MySQL database), [`medvault/services/apiService.ts`](https://github.com/avinashcreates/medvault/blob/main/medvault/services/apiService.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patient_app["Patient app"]
  node_vault_ui["Vault interface<br/>[App.tsx]"]
  node_api_client["API client<br/>[apiService.ts]"]
  node_mock_store[("Local mock store<br/>[mockBackend.ts]")]
  node_record_ai["Record summaries<br/>[geminiService.ts]"]
end

subgraph group_doctor_app["Doctor workflows"]
  node_share_routes["Sharing routes<br/>[shareRoutes.js]"]
  node_share_logic["Share sessions<br/>[shareController.js]"]
  node_advice_routes["Advice routes"]
  node_advice_logic["Medical advice"]
end

subgraph group_backend["Backend services"]
  node_backend_api["HTTP API<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_logic["Account management<br/>[authController.js]"]
  node_auth_guard["JWT guard<br/>[auth.js]"]
  node_record_routes["Record routes"]
  node_record_logic["Record management"]
  node_db_schema["Database schema<br/>[schema.js]"]
  node_mysql[("MySQL database<br/>[database.js]")]
end

subgraph group_prototype["Mock prototype"]
  node_prototype_ui["Prototype interface<br/>[App.tsx]"]
  node_prototype_mock[("Prototype mock backend<br/>[mockBackend.ts]")]
  node_prototype_ai["Prototype summaries<br/>[geminiService.ts]"]
end

node_patient(("Patient"))
node_doctor(("Doctor"))
node_gemini{{"Gemini API"}}

node_patient -->|"uses"| node_vault_ui
node_doctor -->|"uses"| node_vault_ui
node_vault_ui -->|"requests data"| node_api_client
node_vault_ui -->|"requests summaries"| node_record_ai
node_vault_ui -.->|"uses fallback"| node_mock_store
node_api_client -->|"sends HTTP requests"| node_backend_api
node_api_client -->|"falls back"| node_mock_store
node_record_ai -->|"generates summaries"| node_gemini
node_backend_api -->|"registers routes"| node_auth_routes
node_backend_api -->|"registers routes"| node_record_routes
node_backend_api -->|"registers routes"| node_share_routes
node_backend_api -->|"registers routes"| node_advice_routes
node_auth_routes -->|"dispatches to"| node_auth_logic
node_auth_logic -->|"reads and writes"| node_mysql
node_record_routes -->|"dispatches to"| node_record_logic
node_record_logic -->|"reads and writes"| node_mysql
node_share_routes -->|"dispatches to"| node_share_logic
node_share_routes -->|"guards routes"| node_auth_guard
node_share_logic -->|"reads and writes"| node_mysql
node_advice_routes -->|"dispatches to"| node_advice_logic
node_advice_logic -->|"reads and writes"| node_mysql
node_db_schema -->|"creates schema"| node_mysql
node_patient -.->|"uses"| node_prototype_ui
node_prototype_ui -->|"uses"| node_prototype_mock
node_prototype_ui -.->|"requests summaries"| node_prototype_ai
node_prototype_ai -->|"generates summaries"| node_gemini

click node_vault_ui "https://github.com/avinashcreates/medvault/blob/main/medvault/App.tsx"
click node_api_client "https://github.com/avinashcreates/medvault/blob/main/medvault/services/apiService.ts"
click node_mock_store "https://github.com/avinashcreates/medvault/blob/main/medvault/services/mockBackend.ts"
click node_record_ai "https://github.com/avinashcreates/medvault/blob/main/medvault/services/geminiService.ts"
click node_backend_api "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/index.js"
click node_auth_routes "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/authRoutes.js"
click node_auth_logic "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/authController.js"
click node_auth_guard "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/middleware/auth.js"
click node_record_routes "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalRecordsRoutes.js"
click node_record_logic "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalRecordsController.js"
click node_share_routes "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/shareRoutes.js"
click node_share_logic "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/shareController.js"
click node_advice_routes "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalAdviceRoutes.js"
click node_advice_logic "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalAdviceController.js"
click node_db_schema "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/schema.js"
click node_mysql "https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/database.js"
click node_prototype_ui "https://github.com/avinashcreates/medvault/blob/main/New%20folder/App.tsx"
click node_prototype_mock "https://github.com/avinashcreates/medvault/blob/main/New%20folder/services/mockBackend.ts"
click node_prototype_ai "https://github.com/avinashcreates/medvault/blob/main/New%20folder/services/geminiService.ts"

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_vault_ui,node_api_client,node_mock_store,node_record_ai toneBlue
class node_share_routes,node_share_logic,node_advice_routes,node_advice_logic toneAmber
class node_backend_api,node_auth_routes,node_auth_logic,node_auth_guard,node_record_routes,node_record_logic,node_db_schema,node_mysql,node_gemini toneMint
class node_prototype_ui,node_prototype_mock,node_prototype_ai toneRose
class node_patient,node_doctor toneIndigo
```

## Components

### Patient app

- [Vault interface](https://github.com/avinashcreates/medvault/blob/main/medvault/App.tsx): `medvault/App.tsx`
- [API client](https://github.com/avinashcreates/medvault/blob/main/medvault/services/apiService.ts): `medvault/services/apiService.ts`
- [Local mock store](https://github.com/avinashcreates/medvault/blob/main/medvault/services/mockBackend.ts): `medvault/services/mockBackend.ts`
- [Record summaries](https://github.com/avinashcreates/medvault/blob/main/medvault/services/geminiService.ts): `medvault/services/geminiService.ts`

### Doctor workflows

- [Sharing routes](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/shareRoutes.js): `medvault-backend/src/shareRoutes.js`
- [Share sessions](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/shareController.js): `medvault-backend/src/shareController.js`
- [Advice routes](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalAdviceRoutes.js): `medvault-backend/src/medicalAdviceRoutes.js`
- [Medical advice](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalAdviceController.js): `medvault-backend/src/medicalAdviceController.js`

### Backend services

- [HTTP API](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/index.js): `medvault-backend/src/index.js`
- [Auth routes](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/authRoutes.js): `medvault-backend/src/authRoutes.js`
- [Account management](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/authController.js): `medvault-backend/src/authController.js`
- [JWT guard](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/middleware/auth.js): `medvault-backend/middleware/auth.js`
- [Record routes](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalRecordsRoutes.js): `medvault-backend/src/medicalRecordsRoutes.js`
- [Record management](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/medicalRecordsController.js): `medvault-backend/src/medicalRecordsController.js`
- [Database schema](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/schema.js): `medvault-backend/src/schema.js`
- [MySQL database](https://github.com/avinashcreates/medvault/blob/main/medvault-backend/src/database.js): `medvault-backend/src/database.js`

### Mock prototype

- [Prototype interface](https://github.com/avinashcreates/medvault/blob/main/New%20folder/App.tsx): `New folder/App.tsx`
- [Prototype mock backend](https://github.com/avinashcreates/medvault/blob/main/New%20folder/services/mockBackend.ts): `New folder/services/mockBackend.ts`
- [Prototype summaries](https://github.com/avinashcreates/medvault/blob/main/New%20folder/services/geminiService.ts): `New folder/services/geminiService.ts`

### Other components

- **Patient**
- **Doctor**
- **Gemini API**

## Connections

- Patient → Vault interface: uses
- Doctor → Vault interface: uses
- Vault interface → API client: requests data (evidence: `medvault/App.tsx`)
- Vault interface → Record summaries: requests summaries (evidence: `medvault/App.tsx`)
- Vault interface → Local mock store: uses fallback (evidence: `medvault/App.tsx`)
- API client → HTTP API: sends HTTP requests (evidence: `medvault/services/apiService.ts`)
- API client → Local mock store: falls back (evidence: `medvault/services/apiService.ts`)
- Record summaries → Gemini API: generates summaries (evidence: `medvault/services/geminiService.ts`)
- HTTP API → Auth routes: registers routes (evidence: `medvault-backend/src/index.js`)
- HTTP API → Record routes: registers routes (evidence: `medvault-backend/src/index.js`)
- HTTP API → Sharing routes: registers routes (evidence: `medvault-backend/src/index.js`)
- HTTP API → Advice routes: registers routes (evidence: `medvault-backend/src/index.js`)
- Auth routes → Account management: dispatches to (evidence: `medvault-backend/src/authRoutes.js`)
- Account management → MySQL database: reads and writes (evidence: `medvault-backend/src/authController.js`)
- Record routes → Record management: dispatches to (evidence: `medvault-backend/src/medicalRecordsRoutes.js`)
- Record management → MySQL database: reads and writes (evidence: `medvault-backend/src/medicalRecordsController.js`)
- Sharing routes → Share sessions: dispatches to (evidence: `medvault-backend/src/shareRoutes.js`)
- Sharing routes → JWT guard: guards routes (evidence: `medvault-backend/src/shareRoutes.js`)
- Share sessions → MySQL database: reads and writes (evidence: `medvault-backend/src/shareController.js`)
- Advice routes → Medical advice: dispatches to (evidence: `medvault-backend/src/medicalAdviceRoutes.js`)
- Medical advice → MySQL database: reads and writes (evidence: `medvault-backend/src/medicalAdviceController.js`)
- Database schema → MySQL database: creates schema (evidence: `medvault-backend/src/schema.js`)
- Patient → Prototype interface: uses
- Prototype interface → Prototype mock backend: uses (evidence: `New folder/App.tsx`)
- Prototype interface → Prototype summaries: requests summaries (evidence: `New folder/App.tsx`)
- Prototype summaries → Gemini API: generates summaries (evidence: `New folder/services/geminiService.ts`)
