# natchapon22105-sys/smarth-hospital architecture

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

- Interactive diagram: https://gitdiagram.com/natchapon22105-sys/smarth-hospital
- Repository: https://github.com/natchapon22105-sys/smarth-hospital

## Overview

NudMedi is a hospital appointment and patient-care system: patients register, manage health profiles, receive AI symptom guidance, book appointments and access records; nurses handle daily queues and lab results; administrators manage staff, settings and service metrics. The README documents the shared API used by the two Next.js applications. Source excerpts confirm selected controller, route and storage relationships; other documented capabilities are represented without implying uninspected call paths.

Main entry points: [`backend/src/app.ts`](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/app.ts) (Express API), [`backend/src/db/db.ts`](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/db/db.ts) (SQLite data store), [`backend/src/controllers/booking.controller.ts`](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/booking.controller.ts) (Appointments and queues), [`backend/src/utils/ai.service.ts`](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/ai.service.ts) (Symptom guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patient["Patient services"]
  node_auth["Member accounts<br/>[auth.controller.ts]"]
  node_profile["Patient profiles"]
  node_ocr["ID-card OCR<br/>[ocr.controller.ts]"]
  node_family["Family members"]
  node_symptom_ai["Symptom guidance<br/>[ai.service.ts]"]
  node_booking["Appointments and queues"]
  node_lab["Lab results<br/>[lab.controller.ts]"]
end

subgraph group_staff["Staff operations"]
  node_admin["Admin management"]
  node_nurse_auth["Nurse approval"]
  node_nurse_ops["Nurse queue actions"]
  node_departments["Departments"]
end

subgraph group_backend["API and data"]
  node_api["Express API<br/>[app.ts]"]
  node_auth_gate["Session authorization<br/>[auth.middleware.ts]"]
  node_sessions["Session service<br/>[session.ts]"]
  node_database[("SQLite data store<br/>[db.ts]")]
  node_mail["Email delivery<br/>[mail.ts]"]
  node_pdf["PDF documents<br/>[pdf.ts]"]
end

subgraph group_clients["Web applications"]
  node_patient_web["Patient portal<br/>[page.tsx]"]
  node_staff_web["Staff portal<br/>[page.tsx]"]
end

node_patient_actor(("Patient"))
node_staff_actor(("Nurse / admin"))

node_patient_actor -->|"uses"| node_patient_web
node_staff_actor -->|"uses"| node_staff_web
node_patient_web -->|"calls API"| node_api
node_staff_web -->|"calls API"| node_api
node_api -->|"routes auth"| node_auth
node_api -->|"routes profiles"| node_profile
node_api -->|"routes bookings"| node_booking
node_api -->|"routes OCR"| node_ocr
node_api -->|"routes family"| node_family
node_api -->|"routes lab"| node_lab
node_api -->|"routes admin"| node_admin
node_api -->|"routes nurse"| node_nurse_ops
node_api -->|"routes nurse auth"| node_nurse_auth
node_api -->|"routes departments"| node_departments
node_booking -->|"requests analysis"| node_symptom_ai
node_booking -->|"reads and writes"| node_database
node_booking -->|"sends confirmation"| node_mail
node_booking -->|"generates tickets"| node_pdf
node_profile -->|"reads and writes"| node_database
node_symptom_ai -->|"records usage"| node_database
node_auth_gate -->|"looks up session"| node_sessions
node_auth_gate -->|"resolves patient"| node_database
node_sessions -->|"stores sessions"| node_database
node_lab -.->|"lab records"| node_database
node_nurse_ops -.->|"queue updates"| node_database
node_admin -->|"settings and metrics"| node_database
node_nurse_auth -->|"nurse records"| node_database
node_departments -->|"department records"| node_database
node_family -.->|"family records"| node_database
node_ocr -.->|"external AI OCR"| node_symptom_ai

click node_patient_web "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/frontend/app/booking/page.tsx"
click node_staff_web "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/staff/app/nurse/page.tsx"
click node_auth "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/auth.controller.ts"
click node_profile "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/patient.controller.ts"
click node_ocr "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/ocr.controller.ts"
click node_family "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/family.controller.ts"
click node_symptom_ai "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/ai.service.ts"
click node_booking "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/booking.controller.ts"
click node_lab "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/lab.controller.ts"
click node_admin "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/admin.controller.ts"
click node_nurse_auth "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/nurse-auth.controller.ts"
click node_nurse_ops "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/nurse.controller.ts"
click node_departments "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/department.controller.ts"
click node_api "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/app.ts"
click node_auth_gate "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/middleware/auth.middleware.ts"
click node_sessions "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/session.ts"
click node_database "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/db/db.ts"
click node_mail "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/mail.ts"
click node_pdf "https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/pdf.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_auth,node_profile,node_ocr,node_family,node_symptom_ai,node_booking,node_lab toneBlue
class node_admin,node_nurse_auth,node_nurse_ops,node_departments toneAmber
class node_api,node_auth_gate,node_sessions,node_database,node_mail,node_pdf toneMint
class node_patient_web,node_staff_web toneRose
class node_patient_actor,node_staff_actor toneIndigo
```

## Components

### Patient services

- [Member accounts](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Patient profiles](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/patient.controller.ts): `backend/src/controllers/patient.controller.ts`
- [ID-card OCR](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/ocr.controller.ts): `backend/src/controllers/ocr.controller.ts`
- [Family members](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/family.controller.ts): `backend/src/controllers/family.controller.ts`
- [Symptom guidance](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/ai.service.ts): `backend/src/utils/ai.service.ts`
- [Appointments and queues](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/booking.controller.ts): `backend/src/controllers/booking.controller.ts`
- [Lab results](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/lab.controller.ts): `backend/src/controllers/lab.controller.ts`

### Staff operations

- [Admin management](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/admin.controller.ts): `backend/src/controllers/admin.controller.ts`
- [Nurse approval](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/nurse-auth.controller.ts): `backend/src/controllers/nurse-auth.controller.ts`
- [Nurse queue actions](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/nurse.controller.ts): `backend/src/controllers/nurse.controller.ts`
- [Departments](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/controllers/department.controller.ts): `backend/src/controllers/department.controller.ts`

### API and data

- [Express API](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Session authorization](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/middleware/auth.middleware.ts): `backend/src/middleware/auth.middleware.ts`
- [Session service](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/session.ts): `backend/src/utils/session.ts`
- [SQLite data store](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/db/db.ts): `backend/src/db/db.ts`
- [Email delivery](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/mail.ts): `backend/src/utils/mail.ts`
- [PDF documents](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/backend/src/utils/pdf.ts): `backend/src/utils/pdf.ts`

### Web applications

- [Patient portal](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/frontend/app/booking/page.tsx): `frontend/app/booking/page.tsx`
- [Staff portal](https://github.com/natchapon22105-sys/smarth-hospital/blob/main/staff/app/nurse/page.tsx): `staff/app/nurse/page.tsx`

### Other components

- **Patient**
- **Nurse / admin**

## Connections

- Patient → Patient portal: uses
- Nurse / admin → Staff portal: uses
- Patient portal → Express API: calls API
- Staff portal → Express API: calls API
- Express API → Member accounts: routes auth (evidence: `backend/src/app.ts`)
- Express API → Patient profiles: routes profiles (evidence: `backend/src/app.ts`)
- Express API → Appointments and queues: routes bookings (evidence: `backend/src/app.ts`)
- Express API → ID-card OCR: routes OCR (evidence: `backend/src/app.ts`)
- Express API → Family members: routes family (evidence: `backend/src/app.ts`)
- Express API → Lab results: routes lab (evidence: `backend/src/app.ts`)
- Express API → Admin management: routes admin (evidence: `backend/src/app.ts`)
- Express API → Nurse queue actions: routes nurse (evidence: `backend/src/app.ts`)
- Express API → Nurse approval: routes nurse auth (evidence: `backend/src/app.ts`)
- Express API → Departments: routes departments
- Appointments and queues → Symptom guidance: requests analysis (evidence: `backend/src/controllers/booking.controller.ts`)
- Appointments and queues → SQLite data store: reads and writes (evidence: `backend/src/controllers/booking.controller.ts`)
- Appointments and queues → Email delivery: sends confirmation (evidence: `backend/src/controllers/booking.controller.ts`)
- Appointments and queues → PDF documents: generates tickets (evidence: `backend/src/controllers/booking.controller.ts`)
- Patient profiles → SQLite data store: reads and writes (evidence: `backend/src/controllers/patient.controller.ts`)
- Symptom guidance → SQLite data store: records usage (evidence: `backend/src/utils/ai.service.ts`)
- Session authorization → Session service: looks up session (evidence: `backend/src/middleware/auth.middleware.ts`)
- Session authorization → SQLite data store: resolves patient (evidence: `backend/src/middleware/auth.middleware.ts`)
- Session service → SQLite data store: stores sessions (evidence: `backend/src/utils/session.ts`)
- Lab results → SQLite data store: lab records
- Nurse queue actions → SQLite data store: queue updates
- Admin management → SQLite data store: settings and metrics (evidence: `backend/src/controllers/admin.controller.ts`)
- Nurse approval → SQLite data store: nurse records (evidence: `backend/src/controllers/nurse-auth.controller.ts`)
- Departments → SQLite data store: department records (evidence: `backend/src/controllers/department.controller.ts`)
- Family members → SQLite data store: family records
- ID-card OCR → Symptom guidance: external AI OCR
