# aranchaimoonkum/patient-monitoring-system architecture

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

- Interactive diagram: https://gitdiagram.com/aranchaimoonkum/patient-monitoring-system
- Repository: https://github.com/aranchaimoonkum/patient-monitoring-system

## Overview

Patient Staff Assignment is a real-time registration and monitoring app. Patients complete a validated form, confirm submission, and send it through the patient API for persistence and live notification. Staff view submitted records with filters and pagination, while Ably Presence exposes in-progress drafts. The graph includes the documented database-backed form options and shared form controls. Some UI-to-API and real-time links are documented in the README; unsampled implementation details are not inferred beyond those relationships.

Main entry points: [`components/patient/patient-form.tsx`](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/patient/patient-form.tsx) (Patient form), [`components/staff/patient-monitor.tsx`](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/staff/patient-monitor.tsx) (Staff monitor), [`lib/prisma/api.ts`](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/prisma/api.ts) (Patient data access), [`app/api/patients/route.ts`](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/api/patients/route.ts) (Patient API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_registration["Patient registration"]
  node_registration_page["Registration page<br/>[page.tsx]"]
  node_patient_form["Patient form<br/>[patient-form.tsx]"]
  node_form_controls["Form controls<br/>[inputs.tsx]"]
  node_select["Accessible select<br/>[select.tsx]"]
  node_date_picker["Date picker<br/>[date-picker.tsx]"]
  node_field["Field components<br/>[field.tsx]"]
  node_alert_dialog["Alert dialogs<br/>[alert-dialog.tsx]"]
end

subgraph group_staff["Staff monitoring"]
  node_staff_page["Staff page<br/>[page.tsx]"]
  node_staff_monitor["Staff monitor"]
  node_staff_api["Staff patients API<br/>[route.ts]"]
  node_pagination["Pagination control<br/>[pagination.tsx]"]
  node_staff_search["Search and pagination rules<br/>[staff-search.ts]"]
end

subgraph group_realtime["Realtime services"]
  node_publisher["Ably publisher<br/>[publish.ts]"]
  node_patient_presence["Patient presence hook"]
  node_presence_model["Presence model<br/>[form-presence.ts]"]
  node_ably_client["Ably client<br/>[modelsClient.ts]"]
  node_presence_members["Presence members hook"]
end

subgraph group_data["Data and validation"]
  node_validation["Patient validation<br/>[patient.ts]"]
  node_patient_api["Patient API<br/>[route.ts]"]
  node_prisma_api["Patient data access<br/>[api.ts]"]
  node_postgres[("Neon Postgres")]
  node_outbox["Event outbox<br/>[api.ts]"]
end

node_patient(("Patient"))
node_staff_user(("Staff user"))

node_patient -->|"opens form"| node_registration_page
node_registration_page -->|"renders"| node_patient_form
node_patient_form -->|"validates with"| node_validation
node_patient_form -->|"renders"| node_form_controls
node_patient_form -->|"renders"| node_select
node_patient_form -->|"renders"| node_date_picker
node_select -->|"uses"| node_field
node_patient_form -->|"confirms submit"| node_alert_dialog
node_patient_form -->|"POSTs submission"| node_patient_api
node_patient_api -->|"parses with"| node_validation
node_patient_api -->|"stores patient"| node_prisma_api
node_prisma_api -->|"writes and queries"| node_postgres
node_prisma_api -->|"records event"| node_outbox
node_patient_api -->|"publishes event"| node_publisher
node_publisher -.->|"sends to Ably"| node_ably_client
node_patient_form -->|"tracks draft"| node_patient_presence
node_patient_presence -->|"uses helpers"| node_presence_model
node_patient_presence -->|"gets connection"| node_ably_client
node_staff_user -->|"opens monitor"| node_staff_page
node_staff_page -->|"loads patients and options"| node_prisma_api
node_prisma_api -->|"reads records and options"| node_postgres
node_staff_page -->|"renders"| node_staff_monitor
node_staff_monitor -->|"requests filtered page"| node_staff_api
node_staff_api -->|"queries patients"| node_prisma_api
node_staff_monitor -->|"renders"| node_pagination
node_staff_monitor -->|"applies URL filters"| node_staff_search
node_staff_monitor -->|"subscribes to drafts"| node_presence_members
node_presence_members -->|"parses members"| node_presence_model
node_presence_members -->|"gets connection"| node_ably_client
node_ably_client -->|"delivers patient events"| node_staff_monitor

click node_registration_page "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/page.tsx"
click node_patient_form "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/patient/patient-form.tsx"
click node_validation "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/schemas/patient.ts"
click node_form_controls "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/inputs.tsx"
click node_select "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/select.tsx"
click node_date_picker "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/date-picker.tsx"
click node_field "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/field.tsx"
click node_alert_dialog "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/alert-dialog.tsx"
click node_patient_api "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/api/patients/route.ts"
click node_prisma_api "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/prisma/api.ts"
click node_outbox "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/prisma/api.ts"
click node_publisher "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/ably/publish.ts"
click node_patient_presence "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/models/use-patient-form-presence.ts"
click node_presence_model "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/ably/form-presence.ts"
click node_ably_client "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/models/modelsClient.ts"
click node_presence_members "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/models/use-form-presence-members.ts"
click node_staff_page "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/staff/page.tsx"
click node_staff_monitor "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/staff/patient-monitor.tsx"
click node_staff_api "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/api/staff/patients/route.ts"
click node_pagination "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/pagination.tsx"
click node_staff_search "https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/types/staff-search.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_registration_page,node_patient_form,node_form_controls,node_select,node_date_picker,node_field,node_alert_dialog,node_staff_user toneBlue
class node_staff_page,node_staff_monitor,node_staff_api,node_pagination,node_staff_search toneAmber
class node_publisher,node_patient_presence,node_presence_model,node_ably_client,node_presence_members toneMint
class node_validation,node_patient_api,node_prisma_api,node_postgres,node_outbox toneRose
class node_patient toneIndigo
```

## Components

### Patient registration

- [Registration page](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/page.tsx): `app/page.tsx`
- [Patient form](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/patient/patient-form.tsx): `components/patient/patient-form.tsx`
- [Form controls](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/inputs.tsx): `components/inputs.tsx`
- [Accessible select](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/select.tsx): `components/select.tsx`
- [Date picker](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/date-picker.tsx): `components/date-picker.tsx`
- [Field components](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/field.tsx): `components/field.tsx`
- [Alert dialogs](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/alert-dialog.tsx): `components/alert-dialog.tsx`

### Staff monitoring

- [Staff page](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/staff/page.tsx): `app/staff/page.tsx`
- [Staff monitor](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/staff/patient-monitor.tsx): `components/staff/patient-monitor.tsx`
- [Staff patients API](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/api/staff/patients/route.ts): `app/api/staff/patients/route.ts`
- [Pagination control](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/components/pagination.tsx): `components/pagination.tsx`
- [Search and pagination rules](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/types/staff-search.ts): `types/staff-search.ts`

### Realtime services

- [Ably publisher](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/ably/publish.ts): `lib/ably/publish.ts`
- [Patient presence hook](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/models/use-patient-form-presence.ts): `lib/models/use-patient-form-presence.ts`
- [Presence model](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/ably/form-presence.ts): `lib/ably/form-presence.ts`
- [Ably client](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/models/modelsClient.ts): `lib/models/modelsClient.ts`
- [Presence members hook](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/models/use-form-presence-members.ts): `lib/models/use-form-presence-members.ts`

### Data and validation

- [Patient validation](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/schemas/patient.ts): `schemas/patient.ts`
- [Patient API](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/app/api/patients/route.ts): `app/api/patients/route.ts`
- [Patient data access](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/prisma/api.ts): `lib/prisma/api.ts`
- **Neon Postgres**
- [Event outbox](https://github.com/aranchaimoonkum/patient-monitoring-system/blob/main/lib/prisma/api.ts): `lib/prisma/api.ts`

### Other components

- **Patient**
- **Staff user**

## Connections

- Patient → Registration page: opens form (evidence: `README.md`)
- Registration page → Patient form: renders (evidence: `app/page.tsx`)
- Patient form → Patient validation: validates with (evidence: `components/patient/patient-form.tsx`)
- Patient form → Form controls: renders (evidence: `components/patient/patient-form.tsx`)
- Patient form → Accessible select: renders (evidence: `components/patient/patient-form.tsx`)
- Patient form → Date picker: renders (evidence: `components/patient/patient-form.tsx`)
- Accessible select → Field components: uses (evidence: `components/select.tsx`)
- Patient form → Alert dialogs: confirms submit (evidence: `README.md`)
- Patient form → Patient API: POSTs submission (evidence: `README.md`)
- Patient API → Patient validation: parses with (evidence: `app/api/patients/route.ts`)
- Patient API → Patient data access: stores patient (evidence: `app/api/patients/route.ts`)
- Patient data access → Neon Postgres: writes and queries (evidence: `lib/prisma/api.ts`)
- Patient data access → Event outbox: records event (evidence: `lib/prisma/api.ts`)
- Patient API → Ably publisher: publishes event (evidence: `app/api/patients/route.ts`)
- Ably publisher → Ably client: sends to Ably (evidence: `README.md`)
- Patient form → Patient presence hook: tracks draft (evidence: `components/patient/patient-form.tsx`)
- Patient presence hook → Presence model: uses helpers (evidence: `lib/models/use-patient-form-presence.ts`)
- Patient presence hook → Ably client: gets connection (evidence: `lib/models/use-patient-form-presence.ts`)
- Staff user → Staff page: opens monitor (evidence: `README.md`)
- Staff page → Patient data access: loads patients and options (evidence: `app/staff/page.tsx`)
- Patient data access → Neon Postgres: reads records and options (evidence: `lib/prisma/api.ts`)
- Staff page → Staff monitor: renders (evidence: `app/staff/page.tsx`)
- Staff monitor → Staff patients API: requests filtered page (evidence: `README.md`)
- Staff patients API → Patient data access: queries patients (evidence: `app/api/staff/patients/route.ts`)
- Staff monitor → Pagination control: renders (evidence: `components/staff/patient-monitor.tsx`)
- Staff monitor → Search and pagination rules: applies URL filters (evidence: `components/staff/patient-monitor.tsx`)
- Staff monitor → Presence members hook: subscribes to drafts (evidence: `components/staff/patient-monitor.tsx`)
- Presence members hook → Presence model: parses members (evidence: `lib/models/use-form-presence-members.ts`)
- Presence members hook → Ably client: gets connection (evidence: `lib/models/use-form-presence-members.ts`)
- Ably client → Staff monitor: delivers patient events (evidence: `README.md`)
