# shridhar-1/medikiosk architecture

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

- Interactive diagram: https://gitdiagram.com/shridhar-1/medikiosk
- Repository: https://github.com/shridhar-1/medikiosk

## Overview

MediKiosk is a hospital self-check-in and clinical handoff product. Patients identify themselves and complete a consented, multilingual kiosk intake; the system prepares a structured summary and emergency alerts, places the visit in a queue, and lets a physician review it and share advice through the patient portal. The source index confirms several module dependencies, while the README documents the larger product flow and optional integrations; unsampled route internals are represented only where the README supports their role.

Main entry points: [`src/components/kiosk/kiosk-app.tsx`](https://github.com/shridhar-1/medikiosk/blob/main/src/components/kiosk/kiosk-app.tsx) (Kiosk Intake), [`src/lib/summary-engine.ts`](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/summary-engine.ts) (Summary Engine), [`src/db/schema.ts`](https://github.com/shridhar-1/medikiosk/blob/main/src/db/schema.ts) (PostgreSQL Records), [`src/app/api/sessions/[id]/submit/route.ts`](https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/sessions/%5Bid%5D/submit/route.ts) (Intake Submission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Patient Intake"]
  node_kiosk["Kiosk Intake<br/>[kiosk-app.tsx]"]
  node_phone_auth["Phone OTP<br/>[PhoneAuth.tsx]"]
  node_interview["Interview Flow<br/>[interview.ts]"]
  node_language["Language Support<br/>[i18n.ts]"]
  node_session_api["Session API<br/>[route.ts]"]
end

subgraph group_clinical["Clinical Processing"]
  node_chat_extract["Chat Extraction<br/>[chat-extract.ts]"]
  node_document_processing["Document OCR<br/>[ocr.ts]"]
  node_summary_engine["Summary Engine<br/>[summary-engine.ts]"]
  node_ai_router["AI Routing<br/>[ai-router.ts]"]
  node_redflags["Emergency Checks<br/>[redflags.ts]"]
  node_drug_safety["Drug Safety<br/>[drug-safety.ts]"]
  node_submit_api["Intake Submission<br/>[route.ts]"]
  node_alerts["Alert Delivery<br/>[notify.ts]"]
end

subgraph group_care["Care Delivery"]
  node_queue_api["Queue API<br/>[route.ts]"]
  node_physician["Physician Review"]
  node_portal["Patient Portal<br/>[page.tsx]"]
end

subgraph group_platform["Identity and Records"]
  node_patient_api["Patient API<br/>[route.ts]"]
  node_database[("PostgreSQL Records<br/>[schema.ts]")]
  node_auth["Session Auth<br/>[auth.ts]"]
end

node_patient(("Patient"))
node_his["Hospital System"]

node_patient -->|"starts intake"| node_kiosk
node_kiosk -->|"uses OTP"| node_phone_auth
node_kiosk -->|"runs interview"| node_interview
node_kiosk -->|"uses translations"| node_language
node_kiosk -->|"uses extraction"| node_chat_extract
node_kiosk -->|"creates sessions"| node_session_api
node_kiosk -->|"registers patients"| node_patient_api
node_patient_api -->|"reads and writes"| node_database
node_session_api -->|"reads and writes"| node_database
node_session_api -.->|"uses identity"| node_auth
node_submit_api -->|"generates summary"| node_summary_engine
node_summary_engine -->|"selects engine"| node_ai_router
node_summary_engine -->|"summarizes documents"| node_document_processing
node_summary_engine -->|"checks red flags"| node_redflags
node_summary_engine -->|"checks medications"| node_drug_safety
node_summary_engine -->|"persists summary"| node_database
node_submit_api -->|"sends alerts"| node_alerts
node_submit_api -->|"updates visit"| node_database
node_submit_api -.->|"sets queue status"| node_queue_api
node_patient -->|"checks queue"| node_queue_api
node_queue_api -->|"reads and updates"| node_database
node_physician -->|"reviews visit data"| node_database
node_physician -->|"confirms record"| node_his
node_patient -->|"views advice"| node_portal
node_portal -.->|"loads visit history"| node_database
node_submit_api -->|"prepares FHIR handoff"| node_his

click node_kiosk "https://github.com/shridhar-1/medikiosk/blob/main/src/components/kiosk/kiosk-app.tsx"
click node_phone_auth "https://github.com/shridhar-1/medikiosk/blob/main/src/components/PhoneAuth.tsx"
click node_interview "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/interview.ts"
click node_language "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/i18n.ts"
click node_session_api "https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/sessions/route.ts"
click node_patient_api "https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/patients/route.ts"
click node_chat_extract "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/chat-extract.ts"
click node_document_processing "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/ocr.ts"
click node_summary_engine "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/summary-engine.ts"
click node_ai_router "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/ai-router.ts"
click node_redflags "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/redflags.ts"
click node_drug_safety "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/drug-safety.ts"
click node_submit_api "https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/sessions/%5Bid%5D/submit/route.ts"
click node_alerts "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/notify.ts"
click node_queue_api "https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/queue/route.ts"
click node_physician "https://github.com/shridhar-1/medikiosk/blob/main/src/components/physician/review-workspace.tsx"
click node_portal "https://github.com/shridhar-1/medikiosk/blob/main/src/app/portal/page.tsx"
click node_database "https://github.com/shridhar-1/medikiosk/blob/main/src/db/schema.ts"
click node_auth "https://github.com/shridhar-1/medikiosk/blob/main/src/lib/auth.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_kiosk,node_phone_auth,node_interview,node_language,node_session_api toneBlue
class node_chat_extract,node_document_processing,node_summary_engine,node_ai_router,node_redflags,node_drug_safety,node_submit_api,node_alerts toneAmber
class node_queue_api,node_physician,node_portal toneMint
class node_patient_api,node_database,node_auth toneRose
class node_patient,node_his toneIndigo
```

## Components

### Patient Intake

- [Kiosk Intake](https://github.com/shridhar-1/medikiosk/blob/main/src/components/kiosk/kiosk-app.tsx): `src/components/kiosk/kiosk-app.tsx`
- [Phone OTP](https://github.com/shridhar-1/medikiosk/blob/main/src/components/PhoneAuth.tsx): `src/components/PhoneAuth.tsx`
- [Interview Flow](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/interview.ts): `src/lib/interview.ts`
- [Language Support](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/i18n.ts): `src/lib/i18n.ts`
- [Session API](https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/sessions/route.ts): `src/app/api/sessions/route.ts`

### Clinical Processing

- [Chat Extraction](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/chat-extract.ts): `src/lib/chat-extract.ts`
- [Document OCR](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/ocr.ts): `src/lib/ocr.ts`
- [Summary Engine](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/summary-engine.ts): `src/lib/summary-engine.ts`
- [AI Routing](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/ai-router.ts): `src/lib/ai-router.ts`
- [Emergency Checks](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/redflags.ts): `src/lib/redflags.ts`
- [Drug Safety](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/drug-safety.ts): `src/lib/drug-safety.ts`
- [Intake Submission](https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/sessions/%5Bid%5D/submit/route.ts): `src/app/api/sessions/[id]/submit/route.ts`
- [Alert Delivery](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/notify.ts): `src/lib/notify.ts`

### Care Delivery

- [Queue API](https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/queue/route.ts): `src/app/api/queue/route.ts`
- [Physician Review](https://github.com/shridhar-1/medikiosk/blob/main/src/components/physician/review-workspace.tsx): `src/components/physician/review-workspace.tsx`
- [Patient Portal](https://github.com/shridhar-1/medikiosk/blob/main/src/app/portal/page.tsx): `src/app/portal/page.tsx`

### Identity and Records

- [Patient API](https://github.com/shridhar-1/medikiosk/blob/main/src/app/api/patients/route.ts): `src/app/api/patients/route.ts`
- [PostgreSQL Records](https://github.com/shridhar-1/medikiosk/blob/main/src/db/schema.ts): `src/db/schema.ts`
- [Session Auth](https://github.com/shridhar-1/medikiosk/blob/main/src/lib/auth.ts): `src/lib/auth.ts`

### Other components

- **Patient**
- **Hospital System**

## Connections

- Patient → Kiosk Intake: starts intake (evidence: `README.md`)
- Kiosk Intake → Phone OTP: uses OTP (evidence: `README.md`)
- Kiosk Intake → Interview Flow: runs interview (evidence: `src/components/kiosk/kiosk-app.tsx`)
- Kiosk Intake → Language Support: uses translations (evidence: `src/components/kiosk/kiosk-app.tsx`)
- Kiosk Intake → Chat Extraction: uses extraction (evidence: `src/components/kiosk/kiosk-app.tsx`)
- Kiosk Intake → Session API: creates sessions (evidence: `README.md`)
- Kiosk Intake → Patient API: registers patients (evidence: `README.md`)
- Patient API → PostgreSQL Records: reads and writes (evidence: `src/app/api/patients/route.ts`)
- Session API → PostgreSQL Records: reads and writes (evidence: `src/app/api/sessions/route.ts`)
- Session API → Session Auth: uses identity
- Intake Submission → Summary Engine: generates summary (evidence: `README.md`)
- Summary Engine → AI Routing: selects engine (evidence: `src/lib/summary-engine.ts`)
- Summary Engine → Document OCR: summarizes documents (evidence: `src/lib/summary-engine.ts`)
- Summary Engine → Emergency Checks: checks red flags (evidence: `src/lib/summary-engine.ts`)
- Summary Engine → Drug Safety: checks medications (evidence: `src/lib/summary-engine.ts`)
- Summary Engine → PostgreSQL Records: persists summary (evidence: `src/lib/summary-engine.ts`)
- Intake Submission → Alert Delivery: sends alerts (evidence: `src/app/api/sessions/[id]/submit/route.ts`)
- Intake Submission → PostgreSQL Records: updates visit (evidence: `src/app/api/sessions/[id]/submit/route.ts`)
- Intake Submission → Queue API: sets queue status
- Patient → Queue API: checks queue (evidence: `README.md`)
- Queue API → PostgreSQL Records: reads and updates (evidence: `src/app/api/queue/route.ts`)
- Physician Review → PostgreSQL Records: reviews visit data (evidence: `src/components/physician/review-workspace.tsx`)
- Physician Review → Hospital System: confirms record (evidence: `README.md`)
- Patient → Patient Portal: views advice (evidence: `README.md`)
- Patient Portal → PostgreSQL Records: loads visit history
- Intake Submission → Hospital System: prepares FHIR handoff (evidence: `src/app/api/sessions/[id]/submit/route.ts`)
