# pattaraladadara/ku-med architecture

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

- Interactive diagram: https://gitdiagram.com/pattaraladadara/ku-med
- Repository: https://github.com/pattaraladadara/ku-med

## Overview

KU-MED is a university-clinic patient and staff workflow application. Staff register or look up patients, then manage clinical records, appointments, triage, medications, certificates, and payments; dashboard and reporting views summarize operational data. Separate branches cover staff account approval and evaluation workflows. The README documents major product behavior; sampled routes and the source index support several internal dependencies. Some UI-to-API wiring and unsampled route behavior are not shown, so those connections are omitted rather than inferred.

Main entry points: [`src/lib/db.ts`](https://github.com/pattaraladadara/ku-med/blob/main/src/lib/db.ts) (PostgreSQL data), [`src/components/patient-profile.tsx`](https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-profile.tsx) (Patient profile), [`src/components/registration-form.tsx`](https://github.com/pattaraladadara/ku-med/blob/main/src/components/registration-form.tsx) (Registration form), [`src/lib/email.ts`](https://github.com/pattaraladadara/ku-med/blob/main/src/lib/email.ts) (Account email)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and accounts"]
  node_login["Login and registration<br/>[login-form.tsx]"]
  node_authapi["Authentication routes<br/>[route.ts]"]
  node_accountadmin["Account administration<br/>[account-admin.tsx]"]
  node_accountapi["Account admin API<br/>[route.ts]"]
  node_email["Account email<br/>[email.ts]"]
end

subgraph group_patient["Patient care"]
  node_patient["Patient<br/>[route.ts]"]
  node_registration["Registration form"]
  node_studentlookup["Student lookup<br/>[route.ts]"]
  node_cardreader["Citizen card reader<br/>[route.ts]"]
  node_search["Patient search<br/>[patient-search.tsx]"]
  node_patientprofile["Patient profile"]
  node_patientapi["Patient records API<br/>[route.ts]"]
  node_patientdetails["Care detail views"]
  node_patientdocs["Certificates and documents"]
  node_treatmentactions["Treatment actions"]
  node_medications["Medication dispensing"]
end

subgraph group_operations["Operations and finance"]
  node_payments["Payment workflow"]
  node_dashboard["Dashboard<br/>[dashboard.tsx]"]
  node_dashboardapi["Dashboard data API<br/>[route.ts]"]
  node_reports["Reports panel<br/>[reports-panel.tsx]"]
  node_finance["Finance reports"]
  node_reportsapi["Reports data API<br/>[route.ts]"]
  node_settings["User settings<br/>[route.ts]"]
end

subgraph group_evaluation["Evaluations"]
  node_serviceeval["Service evaluations<br/>[route.ts]"]
  node_evaluationform["Evaluation form"]
  node_systemeval["System evaluations<br/>[route.ts]"]
end

subgraph group_platform["Shared services"]
  node_database[("PostgreSQL data<br/>[db.ts]")]
  node_validation["API validation<br/>[api-validation.ts]"]
  node_demo["Demo session gate"]
  node_demosession["Demo session state<br/>[demo-session.ts]"]
end

node_staff(("Clinic staff"))
node_kuallogin(("KU All-Login"))
node_studentservice(("Student lookup service"))
node_googleforms[("Google Sheets")]

node_staff -->|"registers patient"| node_registration
node_registration -->|"looks up student"| node_studentlookup
node_studentlookup -->|"fetches details"| node_studentservice
node_staff -->|"reads identity"| node_cardreader
node_registration -->|"saves patient"| node_patient
node_staff -->|"searches records"| node_search
node_search -->|"opens patient"| node_patientapi
node_patientprofile -->|"renders"| node_patientdetails
node_patientprofile -->|"renders"| node_patientdocs
node_patientprofile -->|"renders"| node_treatmentactions
node_patientprofile -->|"renders"| node_medications
node_patientprofile -->|"renders"| node_payments
node_patientapi -->|"reads and writes"| node_database
node_registration -->|"persists after review"| node_patient
node_staff -->|"views activity"| node_dashboard
node_dashboardapi -->|"queries metrics"| node_database
node_staff -->|"views summaries"| node_reports
node_reports -->|"renders"| node_finance
node_reportsapi -->|"queries summaries"| node_database
node_staff -->|"signs in"| node_login
node_login -->|"submits account"| node_authapi
node_login -.->|"starts login"| node_kuallogin
node_staff -->|"reviews accounts"| node_accountadmin
node_accountapi -->|"updates accounts"| node_database
node_accountapi -->|"sends status mail"| node_email
node_email -.->|"uses support settings"| node_database
node_email -.->|"sends notifications"| node_staff
node_staff -->|"submits evaluation"| node_evaluationform
node_evaluationform -.->|"imports responses"| node_serviceeval
node_serviceeval -->|"downloads responses"| node_googleforms
node_serviceeval -->|"stores evaluations"| node_database
node_systemeval -->|"stores evaluations"| node_database
node_settings -->|"reads and writes"| node_database
node_authapi -->|"stores accounts"| node_database
node_authapi -->|"sends verification"| node_email
node_demo -->|"checks session"| node_demosession
node_patient -->|"creates patient"| node_database
node_patient -->|"validates input"| node_validation
node_patientapi -->|"validates input"| node_validation

click node_patient "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/patients/route.ts"
click node_registration "https://github.com/pattaraladadara/ku-med/blob/main/src/components/registration-form.tsx"
click node_studentlookup "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/student-lookup/%5BstudentId%5D/route.ts"
click node_cardreader "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/citizen-card/read/route.ts"
click node_search "https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-search.tsx"
click node_patientprofile "https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-profile.tsx"
click node_patientapi "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/patients/%5Bid%5D/route.ts"
click node_patientdetails "https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-general.tsx"
click node_patientdocs "https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-documents.tsx"
click node_treatmentactions "https://github.com/pattaraladadara/ku-med/blob/main/src/components/treatment-record-actions.tsx"
click node_payments "https://github.com/pattaraladadara/ku-med/blob/main/src/components/payment-workflow.tsx"
click node_medications "https://github.com/pattaraladadara/ku-med/blob/main/src/components/medication-dispensing.tsx"
click node_dashboard "https://github.com/pattaraladadara/ku-med/blob/main/src/components/dashboard.tsx"
click node_dashboardapi "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/dashboard/route.ts"
click node_reports "https://github.com/pattaraladadara/ku-med/blob/main/src/components/reports-panel.tsx"
click node_finance "https://github.com/pattaraladadara/ku-med/blob/main/src/components/finance-reports.tsx"
click node_reportsapi "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/reports/route.ts"
click node_login "https://github.com/pattaraladadara/ku-med/blob/main/src/components/login-form.tsx"
click node_authapi "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/auth/register/route.ts"
click node_accountadmin "https://github.com/pattaraladadara/ku-med/blob/main/src/components/account-admin.tsx"
click node_accountapi "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/admin/accounts/route.ts"
click node_email "https://github.com/pattaraladadara/ku-med/blob/main/src/lib/email.ts"
click node_serviceeval "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/evaluations/service/route.ts"
click node_evaluationform "https://github.com/pattaraladadara/ku-med/blob/main/src/components/evaluation-form.tsx"
click node_systemeval "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/evaluations/system/route.ts"
click node_settings "https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/settings/route.ts"
click node_database "https://github.com/pattaraladadara/ku-med/blob/main/src/lib/db.ts"
click node_validation "https://github.com/pattaraladadara/ku-med/blob/main/src/lib/api-validation.ts"
click node_demo "https://github.com/pattaraladadara/ku-med/blob/main/src/components/demo-session-gate.tsx"
click node_demosession "https://github.com/pattaraladadara/ku-med/blob/main/src/lib/demo-session.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_login,node_authapi,node_accountadmin,node_accountapi,node_email toneBlue
class node_patient,node_registration,node_studentlookup,node_cardreader,node_search,node_patientprofile,node_patientapi,node_patientdetails,node_patientdocs,node_treatmentactions,node_medications,node_googleforms toneAmber
class node_payments,node_dashboard,node_dashboardapi,node_reports,node_finance,node_reportsapi,node_settings toneMint
class node_serviceeval,node_evaluationform,node_systemeval toneRose
class node_database,node_validation,node_demo,node_demosession,node_staff,node_kuallogin,node_studentservice toneIndigo
```

## Components

### Access and accounts

- [Login and registration](https://github.com/pattaraladadara/ku-med/blob/main/src/components/login-form.tsx): `src/components/login-form.tsx`
- [Authentication routes](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/auth/register/route.ts): `src/app/api/auth/register/route.ts`
- [Account administration](https://github.com/pattaraladadara/ku-med/blob/main/src/components/account-admin.tsx): `src/components/account-admin.tsx`
- [Account admin API](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/admin/accounts/route.ts): `src/app/api/admin/accounts/route.ts`
- [Account email](https://github.com/pattaraladadara/ku-med/blob/main/src/lib/email.ts): `src/lib/email.ts`

### Patient care

- [Patient](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/patients/route.ts): `src/app/api/patients/route.ts`
- [Registration form](https://github.com/pattaraladadara/ku-med/blob/main/src/components/registration-form.tsx): `src/components/registration-form.tsx`
- [Student lookup](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/student-lookup/%5BstudentId%5D/route.ts): `src/app/api/student-lookup/[studentId]/route.ts`
- [Citizen card reader](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/citizen-card/read/route.ts): `src/app/api/citizen-card/read/route.ts`
- [Patient search](https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-search.tsx): `src/components/patient-search.tsx`
- [Patient profile](https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-profile.tsx): `src/components/patient-profile.tsx`
- [Patient records API](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/patients/%5Bid%5D/route.ts): `src/app/api/patients/[id]/route.ts`
- [Care detail views](https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-general.tsx): `src/components/patient-general.tsx`
- [Certificates and documents](https://github.com/pattaraladadara/ku-med/blob/main/src/components/patient-documents.tsx): `src/components/patient-documents.tsx`
- [Treatment actions](https://github.com/pattaraladadara/ku-med/blob/main/src/components/treatment-record-actions.tsx): `src/components/treatment-record-actions.tsx`
- [Medication dispensing](https://github.com/pattaraladadara/ku-med/blob/main/src/components/medication-dispensing.tsx): `src/components/medication-dispensing.tsx`

### Operations and finance

- [Payment workflow](https://github.com/pattaraladadara/ku-med/blob/main/src/components/payment-workflow.tsx): `src/components/payment-workflow.tsx`
- [Dashboard](https://github.com/pattaraladadara/ku-med/blob/main/src/components/dashboard.tsx): `src/components/dashboard.tsx`
- [Dashboard data API](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/dashboard/route.ts): `src/app/api/dashboard/route.ts`
- [Reports panel](https://github.com/pattaraladadara/ku-med/blob/main/src/components/reports-panel.tsx): `src/components/reports-panel.tsx`
- [Finance reports](https://github.com/pattaraladadara/ku-med/blob/main/src/components/finance-reports.tsx): `src/components/finance-reports.tsx`
- [Reports data API](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/reports/route.ts): `src/app/api/reports/route.ts`
- [User settings](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/settings/route.ts): `src/app/api/settings/route.ts`

### Evaluations

- [Service evaluations](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/evaluations/service/route.ts): `src/app/api/evaluations/service/route.ts`
- [Evaluation form](https://github.com/pattaraladadara/ku-med/blob/main/src/components/evaluation-form.tsx): `src/components/evaluation-form.tsx`
- [System evaluations](https://github.com/pattaraladadara/ku-med/blob/main/src/app/api/evaluations/system/route.ts): `src/app/api/evaluations/system/route.ts`

### Shared services

- [PostgreSQL data](https://github.com/pattaraladadara/ku-med/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [API validation](https://github.com/pattaraladadara/ku-med/blob/main/src/lib/api-validation.ts): `src/lib/api-validation.ts`
- [Demo session gate](https://github.com/pattaraladadara/ku-med/blob/main/src/components/demo-session-gate.tsx): `src/components/demo-session-gate.tsx`
- [Demo session state](https://github.com/pattaraladadara/ku-med/blob/main/src/lib/demo-session.ts): `src/lib/demo-session.ts`

### Other components

- **Clinic staff**
- **KU All-Login**
- **Student lookup service**
- **Google Sheets**

## Connections

- Clinic staff → Registration form: registers patient
- Registration form → Student lookup: looks up student
- Student lookup → Student lookup service: fetches details
- Clinic staff → Citizen card reader: reads identity
- Registration form → Patient: saves patient
- Clinic staff → Patient search: searches records
- Patient search → Patient records API: opens patient
- Patient profile → Care detail views: renders (evidence: `src/components/patient-profile.tsx`)
- Patient profile → Certificates and documents: renders (evidence: `src/components/patient-profile.tsx`)
- Patient profile → Treatment actions: renders (evidence: `src/components/patient-profile.tsx`)
- Patient profile → Medication dispensing: renders (evidence: `src/components/patient-profile.tsx`)
- Patient profile → Payment workflow: renders (evidence: `src/components/patient-profile.tsx`)
- Patient records API → PostgreSQL data: reads and writes (evidence: `src/app/api/patients/[id]/route.ts`)
- Registration form → Patient: persists after review
- Clinic staff → Dashboard: views activity
- Dashboard data API → PostgreSQL data: queries metrics (evidence: `src/app/api/dashboard/route.ts`)
- Clinic staff → Reports panel: views summaries
- Reports panel → Finance reports: renders (evidence: `src/components/reports-panel.tsx`)
- Reports data API → PostgreSQL data: queries summaries (evidence: `src/app/api/reports/route.ts`)
- Clinic staff → Login and registration: signs in
- Login and registration → Authentication routes: submits account
- Login and registration → KU All-Login: starts login
- Clinic staff → Account administration: reviews accounts
- Account admin API → PostgreSQL data: updates accounts (evidence: `src/app/api/admin/accounts/route.ts`)
- Account admin API → Account email: sends status mail (evidence: `src/app/api/admin/accounts/route.ts`)
- Account email → PostgreSQL data: uses support settings
- Account email → Clinic staff: sends notifications
- Clinic staff → Evaluation form: submits evaluation
- Evaluation form → Service evaluations: imports responses
- Service evaluations → Google Sheets: downloads responses (evidence: `src/app/api/evaluations/service/route.ts`)
- Service evaluations → PostgreSQL data: stores evaluations (evidence: `src/app/api/evaluations/service/route.ts`)
- System evaluations → PostgreSQL data: stores evaluations (evidence: `src/app/api/evaluations/system/route.ts`)
- User settings → PostgreSQL data: reads and writes (evidence: `src/app/api/settings/route.ts`)
- Authentication routes → PostgreSQL data: stores accounts (evidence: `src/app/api/auth/register/route.ts`)
- Authentication routes → Account email: sends verification (evidence: `src/app/api/auth/register/route.ts`)
- Demo session gate → Demo session state: checks session (evidence: `src/components/demo-session-gate.tsx`)
- Patient → PostgreSQL data: creates patient (evidence: `src/app/api/patients/route.ts`)
- Patient → API validation: validates input (evidence: `src/app/api/patients/route.ts`)
- Patient records API → API validation: validates input (evidence: `src/app/api/patients/[id]/route.ts`)
