# uibreaker/hospital-report-system architecture

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

- Interactive diagram: https://gitdiagram.com/uibreaker/hospital-report-system
- Repository: https://github.com/uibreaker/hospital-report-system

## Overview

This is a hospital-wide shift-reporting system: department staff submit specialty reports and clinical cases, administrators monitor submissions and locks, then present and export a consolidated view. The graph follows the documented flow and the source-visible API/controller relationships; several UI and service details are documented but unsampled, so those links are omitted rather than inferred. Storage is MySQL; Cloudinary image upload and the broader export/print capabilities are documented in the README.

Main entry points: [`server/src/routes/adminRoutes.js`](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/adminRoutes.js) (Admin routes), [`server/src/app.js`](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/app.js) (Express API), [`server/src/config/db.js`](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/config/db.js) (MySQL database), [`client/src/App.jsx`](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/App.jsx) (Application routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Staff and Admin UI"]
  node_app["Application routes<br/>[App.jsx]"]
  node_authctx["Session context<br/>[AuthContext.jsx]"]
  node_login["Login and registration<br/>[LoginPage.jsx]"]
  node_reportui["Shift report entry<br/>[ReportPage.jsx]"]
  node_cases["Clinical case forms"]
  node_customui["Dynamic forms"]
  node_adminui["Administration<br/>[AdminDashboard.jsx]"]
  node_adminforms["Form management"]
end

subgraph group_presentation["Reporting and Presentation"]
  node_presentationui["Presentation engine"]
  node_exportui["Excel and PDF export"]
end

subgraph group_server["API and Access"]
  node_apisvc["HTTP client<br/>[api.js]"]
  node_authsvc["Authentication service<br/>[authService.js]"]
  node_api["Express API<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_reportroutes["Report routes<br/>[reportRoutes.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_customroutes["Custom form routes"]
  node_authmw["JWT authorization<br/>[auth.js]"]
end

subgraph group_domain["Data Domains"]
  node_reportctrl["Report operations"]
  node_adminctrl["Status and locks<br/>[adminController.js]"]
  node_customctrl["Form submissions"]
  node_usersctrl["Account administration"]
  node_analytics["Hospital analytics"]
  node_history["Submission history"]
  node_archive["Data archive"]
  node_staffctrl["Staff directory<br/>[staffController.js]"]
  node_mysql[("MySQL database<br/>[db.js]")]
end

node_staff(("Department staff"))
node_admin(("Hospital admin"))
node_cloudinary["Cloudinary CDN"]

node_staff -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"provides session"| node_authctx
node_app -->|"routes"| node_login
node_app -->|"routes"| node_reportui
node_app -->|"protects route"| node_adminui
node_authctx -->|"calls"| node_authsvc
node_authsvc -->|"sends requests"| node_apisvc
node_reportui -.->|"collects cases"| node_cases
node_customui -.->|"submits forms"| node_apisvc
node_adminui -.->|"manages forms"| node_adminforms
node_presentationui -.->|"exports reports"| node_exportui
node_apisvc -.->|"HTTP requests"| node_api
node_api -->|"mounts"| node_authroutes
node_api -->|"mounts"| node_reportroutes
node_api -->|"mounts"| node_adminroutes
node_api -->|"mounts"| node_customroutes
node_authroutes -->|"guards"| node_authmw
node_reportroutes -->|"guards"| node_authmw
node_adminroutes -->|"guards"| node_authmw
node_customroutes -->|"guards"| node_authmw
node_reportroutes -->|"dispatches"| node_reportctrl
node_adminroutes -->|"dispatches"| node_adminctrl
node_adminroutes -->|"dispatches"| node_usersctrl
node_adminroutes -->|"dispatches"| node_analytics
node_adminroutes -->|"dispatches"| node_history
node_adminroutes -->|"dispatches"| node_archive
node_customroutes -->|"dispatches"| node_customctrl
node_api -->|"routes staff lookup"| node_staffctrl
node_reportctrl -->|"reads and writes"| node_mysql
node_adminctrl -->|"reads and writes"| node_mysql
node_customctrl -->|"reads and writes"| node_mysql
node_usersctrl -->|"reads and writes"| node_mysql
node_history -->|"queries"| node_mysql
node_archive -->|"queries"| node_mysql
node_staffctrl -->|"queries"| node_mysql
node_adminctrl -.->|"exports reports"| node_exportui
node_reportui -.->|"uploads images"| node_cloudinary

click node_app "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/App.jsx"
click node_authctx "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/contexts/AuthContext.jsx"
click node_login "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/LoginPage.jsx"
click node_reportui "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/ReportPage.jsx"
click node_cases "https://github.com/uibreaker/hospital-report-system/tree/main/client/src/components/forms"
click node_customui "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/components/admin/custom-forms/DynamicFormRenderer.jsx"
click node_adminui "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/AdminDashboard.jsx"
click node_adminforms "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/components/admin/custom-forms/CustomFormBuilder.jsx"
click node_presentationui "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/PresentationPage.jsx"
click node_exportui "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/services/excelExportService.js"
click node_apisvc "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/services/api.js"
click node_authsvc "https://github.com/uibreaker/hospital-report-system/blob/main/client/src/services/authService.js"
click node_api "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/app.js"
click node_authroutes "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/authRoutes.js"
click node_reportroutes "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/reportRoutes.js"
click node_adminroutes "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/adminRoutes.js"
click node_customroutes "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/customFormRoutes.js"
click node_authmw "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/middleware/auth.js"
click node_reportctrl "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/reportController.js"
click node_adminctrl "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/adminController.js"
click node_customctrl "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/customFormController.js"
click node_usersctrl "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/userManageController.js"
click node_analytics "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/analyticsController.js"
click node_history "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/submissionHistoryController.js"
click node_archive "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/dataArchiveController.js"
click node_staffctrl "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/staffController.js"
click node_mysql "https://github.com/uibreaker/hospital-report-system/blob/main/server/src/config/db.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_authctx,node_login,node_reportui,node_cases,node_customui,node_adminui,node_adminforms toneBlue
class node_presentationui,node_exportui toneAmber
class node_apisvc,node_authsvc,node_api,node_authroutes,node_reportroutes,node_adminroutes,node_customroutes,node_authmw toneMint
class node_reportctrl,node_adminctrl,node_customctrl,node_usersctrl,node_analytics,node_history,node_archive,node_staffctrl,node_mysql toneRose
class node_staff,node_admin,node_cloudinary toneIndigo
```

## Components

### Staff and Admin UI

- [Application routes](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Session context](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/contexts/AuthContext.jsx): `client/src/contexts/AuthContext.jsx`
- [Login and registration](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [Shift report entry](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/ReportPage.jsx): `client/src/pages/ReportPage.jsx`
- [Clinical case forms](https://github.com/uibreaker/hospital-report-system/tree/main/client/src/components/forms): `client/src/components/forms`
- [Dynamic forms](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/components/admin/custom-forms/DynamicFormRenderer.jsx): `client/src/components/admin/custom-forms/DynamicFormRenderer.jsx`
- [Administration](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/AdminDashboard.jsx): `client/src/pages/AdminDashboard.jsx`
- [Form management](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/components/admin/custom-forms/CustomFormBuilder.jsx): `client/src/components/admin/custom-forms/CustomFormBuilder.jsx`

### Reporting and Presentation

- [Presentation engine](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/pages/PresentationPage.jsx): `client/src/pages/PresentationPage.jsx`
- [Excel and PDF export](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/services/excelExportService.js): `client/src/services/excelExportService.js`

### API and Access

- [HTTP client](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Authentication service](https://github.com/uibreaker/hospital-report-system/blob/main/client/src/services/authService.js): `client/src/services/authService.js`
- [Express API](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/app.js): `server/src/app.js`
- [Authentication routes](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Report routes](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/reportRoutes.js): `server/src/routes/reportRoutes.js`
- [Admin routes](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/adminRoutes.js): `server/src/routes/adminRoutes.js`
- [Custom form routes](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/routes/customFormRoutes.js): `server/src/routes/customFormRoutes.js`
- [JWT authorization](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/middleware/auth.js): `server/src/middleware/auth.js`

### Data Domains

- [Report operations](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/reportController.js): `server/src/controllers/reportController.js`
- [Status and locks](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/adminController.js): `server/src/controllers/adminController.js`
- [Form submissions](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/customFormController.js): `server/src/controllers/customFormController.js`
- [Account administration](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/userManageController.js): `server/src/controllers/userManageController.js`
- [Hospital analytics](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/analyticsController.js): `server/src/controllers/analyticsController.js`
- [Submission history](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/submissionHistoryController.js): `server/src/controllers/submissionHistoryController.js`
- [Data archive](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/dataArchiveController.js): `server/src/controllers/dataArchiveController.js`
- [Staff directory](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/controllers/staffController.js): `server/src/controllers/staffController.js`
- [MySQL database](https://github.com/uibreaker/hospital-report-system/blob/main/server/src/config/db.js): `server/src/config/db.js`

### Other components

- **Department staff**
- **Hospital admin**
- **Cloudinary CDN**

## Connections

- Department staff → Application routes: uses
- Hospital admin → Application routes: uses
- Application routes → Session context: provides session (evidence: `client/src/App.jsx`)
- Application routes → Login and registration: routes (evidence: `client/src/App.jsx`)
- Application routes → Shift report entry: routes (evidence: `client/src/App.jsx`)
- Application routes → Administration: protects route (evidence: `client/src/App.jsx`)
- Session context → Authentication service: calls (evidence: `client/src/contexts/AuthContext.jsx`)
- Authentication service → HTTP client: sends requests (evidence: `client/src/services/authService.js`)
- Shift report entry → Clinical case forms: collects cases
- Dynamic forms → HTTP client: submits forms
- Administration → Form management: manages forms
- Presentation engine → Excel and PDF export: exports reports
- HTTP client → Express API: HTTP requests
- Express API → Authentication routes: mounts (evidence: `server/src/app.js`)
- Express API → Report routes: mounts (evidence: `server/src/app.js`)
- Express API → Admin routes: mounts (evidence: `server/src/app.js`)
- Express API → Custom form routes: mounts (evidence: `server/src/app.js`)
- Authentication routes → JWT authorization: guards (evidence: `server/src/routes/authRoutes.js`)
- Report routes → JWT authorization: guards (evidence: `server/src/routes/reportRoutes.js`)
- Admin routes → JWT authorization: guards (evidence: `server/src/routes/adminRoutes.js`)
- Custom form routes → JWT authorization: guards (evidence: `server/src/routes/customFormRoutes.js`)
- Report routes → Report operations: dispatches (evidence: `server/src/routes/reportRoutes.js`)
- Admin routes → Status and locks: dispatches (evidence: `server/src/routes/adminRoutes.js`)
- Admin routes → Account administration: dispatches (evidence: `server/src/routes/adminRoutes.js`)
- Admin routes → Hospital analytics: dispatches (evidence: `server/src/routes/adminRoutes.js`)
- Admin routes → Submission history: dispatches (evidence: `server/src/routes/adminRoutes.js`)
- Admin routes → Data archive: dispatches (evidence: `server/src/routes/adminRoutes.js`)
- Custom form routes → Form submissions: dispatches (evidence: `server/src/routes/customFormRoutes.js`)
- Express API → Staff directory: routes staff lookup (evidence: `server/src/app.js`)
- Report operations → MySQL database: reads and writes (evidence: `server/src/controllers/reportController.js`)
- Status and locks → MySQL database: reads and writes (evidence: `server/src/controllers/adminController.js`)
- Form submissions → MySQL database: reads and writes (evidence: `server/src/controllers/customFormController.js`)
- Account administration → MySQL database: reads and writes (evidence: `server/src/controllers/userManageController.js`)
- Submission history → MySQL database: queries (evidence: `server/src/controllers/submissionHistoryController.js`)
- Data archive → MySQL database: queries (evidence: `server/src/controllers/dataArchiveController.js`)
- Staff directory → MySQL database: queries (evidence: `server/src/controllers/staffController.js`)
- Status and locks → Excel and PDF export: exports reports
- Shift report entry → Cloudinary CDN: uploads images
