# trizhax/clinicsync-clinic-management-system architecture

> Architecture diagram of the GitHub repository trizhax/clinicsync-clinic-management-system, 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/trizhax/clinicsync-clinic-management-system
- Repository: https://github.com/trizhax/clinicsync-clinic-management-system

## Overview

ClinicSync is a school-clinic management application for staff and patients. Its principal workflow is account setup or sign-in, role-scoped access to clinic records, then patient registration and appointment/consultation tracking, with reports and audit history supporting clinic administration. The graph shows sampled API-to-service and page-to-database relationships; several capabilities are documented in the README but lack a distinct implementation path in the supplied tree. Source excerpts and the SOURCE INDEX support the cited links; unsampled integrations are not inferred.

Main entry points: [`lib/prisma.ts`](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/prisma.ts) (Prisma data access), [`lib/audit.ts`](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/audit.ts) (Audit recording), [`app/api/setup/route.ts`](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/setup/route.ts) (Initial setup endpoint), [`lib/auth.ts`](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/auth.ts) (Authentication and roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Clinic interface"]
  node_login_ui["Sign-in form<br/>[auth-form.tsx]"]
  node_setup_ui["Setup form<br/>[auth-form.tsx]"]
  node_shell["Protected app shell<br/>[app-shell.tsx]"]
end

subgraph group_clinical["Clinical workflows"]
  node_patient_pages["Patient records"]
  node_appointment_pages["Appointments"]
  node_consultation_pages["Consultations<br/>[page.tsx]"]
  node_patient_api["Patient API<br/>[route.ts]"]
  node_patient_detail_api["Patient detail API<br/>[route.ts]"]
  node_appointment_api["Appointment API<br/>[route.ts]"]
  node_consultation_api["Consultation API<br/>[route.ts]"]
  node_vitals_api["Vitals API<br/>[route.ts]"]
end

subgraph group_admin["Clinic administration"]
  node_doctors_api["Doctor management<br/>[route.ts]"]
  node_reports["Clinic reports<br/>[route.ts]"]
  node_audit_pages["Audit log view<br/>[page.tsx]"]
  node_inventory["Medicine inventory"]
end

subgraph group_services["Application services"]
  node_login_api["Login endpoint<br/>[route.ts]"]
  node_setup_api["Initial setup endpoint<br/>[route.ts]"]
  node_auth["Authentication and roles<br/>[auth.ts]"]
  node_api_helpers["API response helpers<br/>[api.ts]"]
  node_validation["Input validation<br/>[validation.ts]"]
  node_audit_service["Audit recording<br/>[audit.ts]"]
end

subgraph group_data["Persistence"]
  node_prisma["Prisma data access<br/>[prisma.ts]"]
  node_database[("Clinic database")]
end

node_staff(("Clinic staff"))
node_patient_actor(("Patient"))

node_staff -->|"signs in"| node_login_ui
node_patient_actor -->|"signs in"| node_login_ui
node_login_ui -->|"submits credentials"| node_login_api
node_staff -->|"sets up clinic"| node_setup_ui
node_setup_ui -->|"submits setup"| node_setup_api
node_login_api -->|"uses sessions"| node_auth
node_login_api -->|"validates input"| node_validation
node_setup_api -->|"creates session"| node_auth
node_setup_api -->|"validates setup"| node_validation
node_setup_api -->|"records setup"| node_audit_service
node_patient_pages -->|"reads records"| node_prisma
node_appointment_pages -->|"reads appointments"| node_prisma
node_consultation_pages -->|"reads consultations"| node_prisma
node_patient_api -->|"reads and creates"| node_prisma
node_patient_api -->|"validates patient"| node_validation
node_patient_api -->|"records changes"| node_audit_service
node_patient_detail_api -->|"accesses patient"| node_prisma
node_appointment_api -->|"reads and creates"| node_prisma
node_appointment_api -->|"validates appointment"| node_validation
node_appointment_api -->|"records creation"| node_audit_service
node_consultation_api -->|"records consultation"| node_prisma
node_consultation_api -->|"records creation"| node_audit_service
node_consultation_api -->|"returns responses"| node_api_helpers
node_vitals_api -->|"accesses vitals"| node_prisma
node_doctors_api -->|"manages doctors"| node_prisma
node_doctors_api -->|"hashes passwords"| node_auth
node_doctors_api -->|"records creation"| node_audit_service
node_reports -->|"queries reports"| node_prisma
node_audit_pages -->|"reads audit logs"| node_prisma
node_auth -->|"reads sessions"| node_prisma
node_audit_service -->|"writes audit logs"| node_prisma
node_prisma -.->|"persists data"| node_database

click node_login_ui "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/components/auth-form.tsx"
click node_setup_ui "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/components/auth-form.tsx"
click node_shell "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/components/app-shell.tsx"
click node_patient_pages "https://github.com/trizhax/clinicsync-clinic-management-system/tree/main/app/(protected)/patients"
click node_appointment_pages "https://github.com/trizhax/clinicsync-clinic-management-system/tree/main/app/(protected)/appointments"
click node_consultation_pages "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/(protected)/consultations/page.tsx"
click node_patient_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/patients/route.ts"
click node_patient_detail_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/patients/%5Bid%5D/route.ts"
click node_appointment_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/appointments/route.ts"
click node_consultation_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/consultations/route.ts"
click node_vitals_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/vitals/route.ts"
click node_doctors_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/doctors/route.ts"
click node_reports "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/reports/route.ts"
click node_audit_pages "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/(protected)/audit-logs/page.tsx"
click node_login_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/auth/login/route.ts"
click node_setup_api "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/setup/route.ts"
click node_auth "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/auth.ts"
click node_api_helpers "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/api.ts"
click node_validation "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/validation.ts"
click node_audit_service "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/audit.ts"
click node_prisma "https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/prisma.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_ui,node_setup_ui,node_shell toneBlue
class node_patient_pages,node_appointment_pages,node_consultation_pages,node_patient_api,node_patient_detail_api,node_appointment_api,node_consultation_api,node_vitals_api toneAmber
class node_doctors_api,node_reports,node_audit_pages,node_inventory toneMint
class node_login_api,node_setup_api,node_auth,node_api_helpers,node_validation,node_audit_service toneRose
class node_prisma,node_database,node_staff,node_patient_actor toneIndigo
```

## Components

### Clinic interface

- [Sign-in form](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/components/auth-form.tsx): `components/auth-form.tsx`
- [Setup form](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/components/auth-form.tsx): `components/auth-form.tsx`
- [Protected app shell](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/components/app-shell.tsx): `components/app-shell.tsx`

### Clinical workflows

- [Patient records](https://github.com/trizhax/clinicsync-clinic-management-system/tree/main/app/(protected)/patients): `app/(protected)/patients`
- [Appointments](https://github.com/trizhax/clinicsync-clinic-management-system/tree/main/app/(protected)/appointments): `app/(protected)/appointments`
- [Consultations](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/(protected)/consultations/page.tsx): `app/(protected)/consultations/page.tsx`
- [Patient API](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/patients/route.ts): `app/api/patients/route.ts`
- [Patient detail API](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/patients/%5Bid%5D/route.ts): `app/api/patients/[id]/route.ts`
- [Appointment API](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/appointments/route.ts): `app/api/appointments/route.ts`
- [Consultation API](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/consultations/route.ts): `app/api/consultations/route.ts`
- [Vitals API](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/vitals/route.ts): `app/api/vitals/route.ts`

### Clinic administration

- [Doctor management](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/doctors/route.ts): `app/api/doctors/route.ts`
- [Clinic reports](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/reports/route.ts): `app/api/reports/route.ts`
- [Audit log view](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/(protected)/audit-logs/page.tsx): `app/(protected)/audit-logs/page.tsx`
- **Medicine inventory**

### Application services

- [Login endpoint](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Initial setup endpoint](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/app/api/setup/route.ts): `app/api/setup/route.ts`
- [Authentication and roles](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/auth.ts): `lib/auth.ts`
- [API response helpers](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/api.ts): `lib/api.ts`
- [Input validation](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/validation.ts): `lib/validation.ts`
- [Audit recording](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/audit.ts): `lib/audit.ts`

### Persistence

- [Prisma data access](https://github.com/trizhax/clinicsync-clinic-management-system/blob/main/lib/prisma.ts): `lib/prisma.ts`
- **Clinic database**

### Other components

- **Clinic staff**
- **Patient**

## Connections

- Clinic staff → Sign-in form: signs in (evidence: `components/auth-form.tsx`)
- Patient → Sign-in form: signs in (evidence: `components/auth-form.tsx`)
- Sign-in form → Login endpoint: submits credentials (evidence: `components/auth-form.tsx`)
- Clinic staff → Setup form: sets up clinic (evidence: `components/auth-form.tsx`)
- Setup form → Initial setup endpoint: submits setup (evidence: `components/auth-form.tsx`)
- Login endpoint → Authentication and roles: uses sessions (evidence: `app/api/auth/login/route.ts`)
- Login endpoint → Input validation: validates input (evidence: `app/api/auth/login/route.ts`)
- Initial setup endpoint → Authentication and roles: creates session (evidence: `app/api/setup/route.ts`)
- Initial setup endpoint → Input validation: validates setup (evidence: `app/api/setup/route.ts`)
- Initial setup endpoint → Audit recording: records setup (evidence: `app/api/setup/route.ts`)
- Patient records → Prisma data access: reads records (evidence: `app/(protected)/patients/page.tsx`)
- Appointments → Prisma data access: reads appointments (evidence: `app/(protected)/appointments/page.tsx`)
- Consultations → Prisma data access: reads consultations (evidence: `app/(protected)/consultations/page.tsx`)
- Patient API → Prisma data access: reads and creates (evidence: `app/api/patients/route.ts`)
- Patient API → Input validation: validates patient (evidence: `app/api/patients/route.ts`)
- Patient API → Audit recording: records changes (evidence: `app/api/patients/route.ts`)
- Patient detail API → Prisma data access: accesses patient (evidence: `app/api/patients/[id]/route.ts`)
- Appointment API → Prisma data access: reads and creates (evidence: `app/api/appointments/route.ts`)
- Appointment API → Input validation: validates appointment (evidence: `app/api/appointments/route.ts`)
- Appointment API → Audit recording: records creation (evidence: `app/api/appointments/route.ts`)
- Consultation API → Prisma data access: records consultation (evidence: `app/api/consultations/route.ts`)
- Consultation API → Audit recording: records creation (evidence: `app/api/consultations/route.ts`)
- Consultation API → API response helpers: returns responses (evidence: `app/api/consultations/route.ts`)
- Vitals API → Prisma data access: accesses vitals (evidence: `app/api/vitals/route.ts`)
- Doctor management → Prisma data access: manages doctors (evidence: `app/api/doctors/route.ts`)
- Doctor management → Authentication and roles: hashes passwords (evidence: `app/api/doctors/route.ts`)
- Doctor management → Audit recording: records creation (evidence: `app/api/doctors/route.ts`)
- Clinic reports → Prisma data access: queries reports (evidence: `app/api/reports/route.ts`)
- Audit log view → Prisma data access: reads audit logs
- Authentication and roles → Prisma data access: reads sessions (evidence: `lib/auth.ts`)
- Audit recording → Prisma data access: writes audit logs (evidence: `lib/audit.ts`)
- Prisma data access → Clinic database: persists data
