# nhungoc3052003/medequip architecture

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

## Overview

MedEquip is an internal hospital system for managing medical-equipment inventory and reusable supplies. Staff authenticate under role-based permissions, then handle stock intake and removal, departmental requests and allocations, returns, maintenance, damage reports, and role-specific reporting. The README describes staged approvals for requests and returns, Excel-based stock intake/exports, QR-assisted return confirmation, and automated due-date alerts. Source excerpts show the API mounting route modules and several workflows sending notifications; many page and controller implementations were not sampled, so those capabilities are represented without guessing their internal calls.

Main entry points: [`MedEquip/server/routes`](https://github.com/nhungoc3052003/medequip/tree/main/MedEquip/server/routes) (API routes), [`MedEquip/server/utils/notificationHelper.js`](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/utils/notificationHelper.js) (Notification delivery), [`MedEquip/server/server.js`](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/server.js) (Express API), [`MedEquip/client/src/App.tsx`](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/App.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Staff interface"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_authcontext["User session<br/>[AuthContext.tsx]"]
  node_authclient["Login service<br/>[authService.ts]"]
  node_pages["Role-based pages"]
  node_apiclient["REST client<br/>[api.ts]"]
end

subgraph group_api["API and access"]
  node_api["Express API<br/>[server.js]"]
  node_routes["API routes"]
  node_authmw["JWT and roles<br/>[auth.js]"]
  node_authctrl["Authentication<br/>[authController.js]"]
  node_mysql[("MySQL database")]
end

subgraph group_stock["Stock operations"]
  node_imports["Excel intake"]
  node_exports["Stock exports"]
  node_inventory["Inventory"]
  node_equipment["Equipment catalog"]
end

subgraph group_workflows["Equipment workflows"]
  node_allocations["Allocations"]
  node_requests["Department requests"]
  node_returns["Returns and QR"]
  node_damage["Damage reports"]
  node_maintenance["Maintenance"]
  node_departments["Departments and suppliers"]
end

subgraph group_support["Notifications and reports"]
  node_notifications["Notification delivery"]
  node_duecheck["Due-date checks"]
  node_notifyctrl["Notification inbox"]
  node_reports["Reports and exports"]
end

node_staff(("Hospital staff"))

node_staff -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_pages
node_authcontext -.->|"uses"| node_authclient
node_authclient -->|"calls"| node_apiclient
node_apiclient -->|"sends REST requests"| node_api
node_api -->|"mounts"| node_routes
node_routes -.->|"applies access checks"| node_authmw
node_routes -->|"dispatches"| node_authctrl
node_routes -->|"dispatches"| node_imports
node_routes -->|"dispatches"| node_exports
node_routes -->|"dispatches"| node_inventory
node_routes -->|"dispatches"| node_equipment
node_routes -->|"dispatches"| node_allocations
node_routes -.->|"dispatches"| node_requests
node_routes -->|"dispatches"| node_returns
node_routes -->|"dispatches"| node_damage
node_routes -->|"dispatches"| node_maintenance
node_routes -->|"dispatches"| node_departments
node_routes -->|"dispatches"| node_notifyctrl
node_routes -->|"dispatches"| node_reports
node_api -->|"schedules"| node_duecheck
node_requests -->|"sends alerts"| node_notifications
node_returns -->|"sends alerts"| node_notifications
node_imports -->|"sends alerts"| node_notifications
node_exports -->|"sends alerts"| node_notifications
node_maintenance -->|"sends alerts"| node_notifications
node_duecheck -->|"sends reminders"| node_notifications

click node_webapp "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/App.tsx"
click node_authcontext "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/contexts/AuthContext.tsx"
click node_authclient "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/services/authService.ts"
click node_pages "https://github.com/nhungoc3052003/medequip/tree/main/MedEquip/client/src/pages"
click node_apiclient "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/services/api.ts"
click node_api "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/server.js"
click node_routes "https://github.com/nhungoc3052003/medequip/tree/main/MedEquip/server/routes"
click node_authmw "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/middleware/auth.js"
click node_authctrl "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/authController.js"
click node_imports "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/importController.js"
click node_exports "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/exportController.js"
click node_inventory "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/inventoryController.js"
click node_equipment "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/equipmentController.js"
click node_allocations "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/allocationController.js"
click node_requests "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/requestController.js"
click node_returns "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/returnController.js"
click node_damage "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/damageReportController.js"
click node_maintenance "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/maintenanceController.js"
click node_departments "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/departmentController.js"
click node_notifications "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/utils/notificationHelper.js"
click node_duecheck "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/services/dueNotificationService.js"
click node_notifyctrl "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/notificationController.js"
click node_reports "https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/reportController.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_webapp,node_authcontext,node_authclient,node_pages,node_apiclient toneBlue
class node_api,node_routes,node_authmw,node_authctrl,node_mysql toneAmber
class node_imports,node_exports,node_inventory,node_equipment toneMint
class node_allocations,node_requests,node_returns,node_damage,node_maintenance,node_departments toneRose
class node_notifications,node_duecheck,node_notifyctrl,node_reports,node_staff toneIndigo
```

## Components

### Staff interface

- [Web application](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/App.tsx): `MedEquip/client/src/App.tsx`
- [User session](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/contexts/AuthContext.tsx): `MedEquip/client/src/contexts/AuthContext.tsx`
- [Login service](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/services/authService.ts): `MedEquip/client/src/services/authService.ts`
- [Role-based pages](https://github.com/nhungoc3052003/medequip/tree/main/MedEquip/client/src/pages): `MedEquip/client/src/pages`
- [REST client](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/client/src/services/api.ts): `MedEquip/client/src/services/api.ts`

### API and access

- [Express API](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/server.js): `MedEquip/server/server.js`
- [API routes](https://github.com/nhungoc3052003/medequip/tree/main/MedEquip/server/routes): `MedEquip/server/routes`
- [JWT and roles](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/middleware/auth.js): `MedEquip/server/middleware/auth.js`
- [Authentication](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/authController.js): `MedEquip/server/controllers/authController.js`
- **MySQL database**

### Stock operations

- [Excel intake](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/importController.js): `MedEquip/server/controllers/importController.js`
- [Stock exports](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/exportController.js): `MedEquip/server/controllers/exportController.js`
- [Inventory](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/inventoryController.js): `MedEquip/server/controllers/inventoryController.js`
- [Equipment catalog](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/equipmentController.js): `MedEquip/server/controllers/equipmentController.js`

### Equipment workflows

- [Allocations](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/allocationController.js): `MedEquip/server/controllers/allocationController.js`
- [Department requests](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/requestController.js): `MedEquip/server/controllers/requestController.js`
- [Returns and QR](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/returnController.js): `MedEquip/server/controllers/returnController.js`
- [Damage reports](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/damageReportController.js): `MedEquip/server/controllers/damageReportController.js`
- [Maintenance](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/maintenanceController.js): `MedEquip/server/controllers/maintenanceController.js`
- [Departments and suppliers](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/departmentController.js): `MedEquip/server/controllers/departmentController.js`

### Notifications and reports

- [Notification delivery](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/utils/notificationHelper.js): `MedEquip/server/utils/notificationHelper.js`
- [Due-date checks](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/services/dueNotificationService.js): `MedEquip/server/services/dueNotificationService.js`
- [Notification inbox](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/notificationController.js): `MedEquip/server/controllers/notificationController.js`
- [Reports and exports](https://github.com/nhungoc3052003/medequip/blob/main/MedEquip/server/controllers/reportController.js): `MedEquip/server/controllers/reportController.js`

### Other components

- **Hospital staff**

## Connections

- Hospital staff → Web application: uses
- Web application → Role-based pages: routes to (evidence: `MedEquip/client/src/App.tsx`)
- User session → Login service: uses
- Login service → REST client: calls (evidence: `MedEquip/client/src/services/authService.ts`)
- REST client → Express API: sends REST requests (evidence: `MedEquip/client/src/services/api.ts`)
- Express API → API routes: mounts (evidence: `MedEquip/server/server.js`)
- API routes → JWT and roles: applies access checks (evidence: `MedEquip/server/routes/auth.js`)
- API routes → Authentication: dispatches (evidence: `MedEquip/server/routes/auth.js`)
- API routes → Excel intake: dispatches (evidence: `MedEquip/server/routes/imports.js`)
- API routes → Stock exports: dispatches (evidence: `MedEquip/server/routes/exports.js`)
- API routes → Inventory: dispatches (evidence: `MedEquip/server/routes/inventory.js`)
- API routes → Equipment catalog: dispatches (evidence: `MedEquip/server/routes/equipment.js`)
- API routes → Allocations: dispatches (evidence: `MedEquip/server/routes/allocations.js`)
- API routes → Department requests: dispatches
- API routes → Returns and QR: dispatches (evidence: `MedEquip/server/routes/returns.js`)
- API routes → Damage reports: dispatches (evidence: `MedEquip/server/routes/damageReports.js`)
- API routes → Maintenance: dispatches (evidence: `MedEquip/server/routes/maintenance.js`)
- API routes → Departments and suppliers: dispatches (evidence: `MedEquip/server/routes/departments.js`)
- API routes → Notification inbox: dispatches (evidence: `MedEquip/server/routes/notifications.js`)
- API routes → Reports and exports: dispatches (evidence: `MedEquip/server/routes/reports.js`)
- Express API → Due-date checks: schedules (evidence: `MedEquip/server/server.js`)
- Department requests → Notification delivery: sends alerts (evidence: `MedEquip/server/controllers/requestController.js`)
- Returns and QR → Notification delivery: sends alerts (evidence: `MedEquip/server/controllers/returnController.js`)
- Excel intake → Notification delivery: sends alerts (evidence: `MedEquip/server/controllers/importController.js`)
- Stock exports → Notification delivery: sends alerts (evidence: `MedEquip/server/controllers/exportController.js`)
- Maintenance → Notification delivery: sends alerts (evidence: `MedEquip/server/controllers/maintenanceController.js`)
- Due-date checks → Notification delivery: sends reminders (evidence: `MedEquip/server/services/dueNotificationService.js`)
