# tanjim079/medicalsystembackend architecture

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

- Interactive diagram: https://gitdiagram.com/tanjim079/medicalsystembackend
- Repository: https://github.com/tanjim079/medicalsystembackend

## Overview

This is a RUET medical backend: an Express API for authentication and clinical and administrative workflows, backed by Supabase. Requests enter through the app and route registry, then domain routes dispatch to handlers that read or update records. Authentication middleware verifies requests through the auth service; patient-record authorization supports access checks in clinical handlers. The tree and source index document additional billing, directory, laboratory, prescription, certificate, medicine, and user routes, though several implementations were not excerpted. Edges reflect shown imports, calls, or documented route wiring; unsampled behavior is not inferred.

Main entry points: [`src/config/supabase.js`](https://github.com/tanjim079/medicalsystembackend/blob/main/src/config/supabase.js) (Supabase clients), [`src/routes/index.js`](https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/index.js) (Route registry), [`src/controllers/patientController.js`](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/patientController.js) (Patient records), [`src/controllers/appointmentController.js`](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/appointmentController.js) (Appointments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and routing"]
  node_app["Express app<br/>[app.js]"]
  node_route_registry["Route registry<br/>[index.js]"]
  node_auth_routes["Auth endpoints<br/>[authRoutes.js]"]
  node_patient_routes["Patient endpoints<br/>[patientRoutes.js]"]
  node_appointment_routes["Appointment endpoints"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Auth handlers<br/>[authController.js]"]
  node_auth_middleware["Request authentication<br/>[authMiddleware.js]"]
  node_auth_service["Token and roles<br/>[authService.js]"]
end

subgraph group_clinical["Clinical workflows"]
  node_patient_controller["Patient records"]
  node_appointment_controller["Appointments"]
  node_record_auth["Record authorization"]
  node_prescription_controller["Prescriptions"]
  node_laboratory_controller["Laboratory"]
  node_certificate_controller["Certificates"]
end

subgraph group_operations["Operations"]
  node_medicine_controller["Medicines"]
  node_billing_routes["Billing endpoints<br/>[billingRoutes.js]"]
  node_directory_controller["Directory"]
  node_user_controller["User administration<br/>[userController.js]"]
end

subgraph group_platform["Runtime and data"]
  node_supabase_client["Supabase clients<br/>[supabase.js]"]
  node_supabase[("Supabase platform")]
  node_environment["Environment config<br/>[env.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts API"| node_route_registry
node_route_registry -->|"mounts routes"| node_auth_routes
node_route_registry -->|"mounts routes"| node_patient_routes
node_route_registry -->|"mounts routes"| node_appointment_routes
node_auth_routes -->|"dispatches to"| node_auth_controller
node_patient_routes -->|"dispatches to"| node_patient_controller
node_appointment_routes -->|"dispatches to"| node_appointment_controller
node_auth_controller -->|"uses auth"| node_supabase_client
node_auth_middleware -->|"verifies identity"| node_auth_service
node_auth_service -->|"checks tokens and roles"| node_supabase_client
node_patient_controller -->|"checks record access"| node_record_auth
node_appointment_controller -->|"resolves patient IDs"| node_record_auth
node_patient_controller -->|"queries records"| node_supabase_client
node_appointment_controller -->|"reads and writes"| node_supabase_client
node_record_auth -->|"resolves identifiers"| node_supabase_client
node_prescription_controller -->|"uses database"| node_supabase_client
node_laboratory_controller -->|"uses database"| node_supabase_client
node_certificate_controller -->|"uses database"| node_supabase_client
node_medicine_controller -->|"uses database"| node_supabase_client
node_directory_controller -->|"uses database"| node_supabase_client
node_user_controller -->|"uses database"| node_supabase_client
node_supabase_client -->|"connects clients"| node_supabase
node_supabase_client -->|"reads settings"| node_environment
node_billing_routes -->|"uses database"| node_supabase_client

click node_app "https://github.com/tanjim079/medicalsystembackend/blob/main/src/app.js"
click node_route_registry "https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/index.js"
click node_auth_routes "https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/authRoutes.js"
click node_patient_routes "https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/patientRoutes.js"
click node_appointment_routes "https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/appointmentRoutes.js"
click node_auth_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/authController.js"
click node_auth_middleware "https://github.com/tanjim079/medicalsystembackend/blob/main/src/middleware/authMiddleware.js"
click node_auth_service "https://github.com/tanjim079/medicalsystembackend/blob/main/src/services/authService.js"
click node_patient_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/patientController.js"
click node_appointment_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/appointmentController.js"
click node_record_auth "https://github.com/tanjim079/medicalsystembackend/blob/main/src/services/recordAuthorization.js"
click node_prescription_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/prescriptionController.js"
click node_laboratory_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/laboratoryController.js"
click node_certificate_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/certificateController.js"
click node_medicine_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/medicineController.js"
click node_billing_routes "https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/billingRoutes.js"
click node_directory_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/directoryController.js"
click node_user_controller "https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/userController.js"
click node_supabase_client "https://github.com/tanjim079/medicalsystembackend/blob/main/src/config/supabase.js"
click node_environment "https://github.com/tanjim079/medicalsystembackend/blob/main/src/config/env.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_route_registry,node_auth_routes,node_patient_routes,node_appointment_routes,node_client toneBlue
class node_auth_controller,node_auth_middleware,node_auth_service toneAmber
class node_patient_controller,node_appointment_controller,node_record_auth,node_prescription_controller,node_laboratory_controller,node_certificate_controller toneMint
class node_medicine_controller,node_billing_routes,node_directory_controller,node_user_controller toneRose
class node_supabase_client,node_supabase,node_environment toneIndigo
```

## Components

### API and routing

- [Express app](https://github.com/tanjim079/medicalsystembackend/blob/main/src/app.js): `src/app.js`
- [Route registry](https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/index.js): `src/routes/index.js`
- [Auth endpoints](https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/authRoutes.js): `src/routes/authRoutes.js`
- [Patient endpoints](https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/patientRoutes.js): `src/routes/patientRoutes.js`
- [Appointment endpoints](https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/appointmentRoutes.js): `src/routes/appointmentRoutes.js`

### Identity and access

- [Auth handlers](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/authController.js): `src/controllers/authController.js`
- [Request authentication](https://github.com/tanjim079/medicalsystembackend/blob/main/src/middleware/authMiddleware.js): `src/middleware/authMiddleware.js`
- [Token and roles](https://github.com/tanjim079/medicalsystembackend/blob/main/src/services/authService.js): `src/services/authService.js`

### Clinical workflows

- [Patient records](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/patientController.js): `src/controllers/patientController.js`
- [Appointments](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/appointmentController.js): `src/controllers/appointmentController.js`
- [Record authorization](https://github.com/tanjim079/medicalsystembackend/blob/main/src/services/recordAuthorization.js): `src/services/recordAuthorization.js`
- [Prescriptions](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/prescriptionController.js): `src/controllers/prescriptionController.js`
- [Laboratory](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/laboratoryController.js): `src/controllers/laboratoryController.js`
- [Certificates](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/certificateController.js): `src/controllers/certificateController.js`

### Operations

- [Medicines](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/medicineController.js): `src/controllers/medicineController.js`
- [Billing endpoints](https://github.com/tanjim079/medicalsystembackend/blob/main/src/routes/billingRoutes.js): `src/routes/billingRoutes.js`
- [Directory](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/directoryController.js): `src/controllers/directoryController.js`
- [User administration](https://github.com/tanjim079/medicalsystembackend/blob/main/src/controllers/userController.js): `src/controllers/userController.js`

### Runtime and data

- [Supabase clients](https://github.com/tanjim079/medicalsystembackend/blob/main/src/config/supabase.js): `src/config/supabase.js`
- **Supabase platform**
- [Environment config](https://github.com/tanjim079/medicalsystembackend/blob/main/src/config/env.js): `src/config/env.js`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `src/app.js`)
- Express app → Route registry: mounts API (evidence: `src/app.js`)
- Route registry → Auth endpoints: mounts routes (evidence: `src/routes/index.js`)
- Route registry → Patient endpoints: mounts routes (evidence: `src/routes/index.js`)
- Route registry → Appointment endpoints: mounts routes (evidence: `src/routes/index.js`)
- Auth endpoints → Auth handlers: dispatches to (evidence: `src/routes/authRoutes.js`)
- Patient endpoints → Patient records: dispatches to (evidence: `src/routes/patientRoutes.js`)
- Appointment endpoints → Appointments: dispatches to (evidence: `src/routes/appointmentRoutes.js`)
- Auth handlers → Supabase clients: uses auth (evidence: `src/controllers/authController.js`)
- Request authentication → Token and roles: verifies identity (evidence: `src/middleware/authMiddleware.js`)
- Token and roles → Supabase clients: checks tokens and roles (evidence: `src/services/authService.js`)
- Patient records → Record authorization: checks record access (evidence: `src/controllers/patientController.js`)
- Appointments → Record authorization: resolves patient IDs (evidence: `src/controllers/appointmentController.js`)
- Patient records → Supabase clients: queries records (evidence: `src/controllers/patientController.js`)
- Appointments → Supabase clients: reads and writes (evidence: `src/controllers/appointmentController.js`)
- Record authorization → Supabase clients: resolves identifiers (evidence: `src/services/recordAuthorization.js`)
- Prescriptions → Supabase clients: uses database (evidence: `src/controllers/prescriptionController.js`)
- Laboratory → Supabase clients: uses database (evidence: `src/controllers/laboratoryController.js`)
- Certificates → Supabase clients: uses database (evidence: `src/controllers/certificateController.js`)
- Medicines → Supabase clients: uses database (evidence: `src/controllers/medicineController.js`)
- Directory → Supabase clients: uses database (evidence: `src/controllers/directoryController.js`)
- User administration → Supabase clients: uses database (evidence: `src/controllers/userController.js`)
- Supabase clients → Supabase platform: connects clients (evidence: `src/config/supabase.js`)
- Supabase clients → Environment config: reads settings (evidence: `src/config/supabase.js`)
- Billing endpoints → Supabase clients: uses database (evidence: `src/routes/billingRoutes.js`)
