# arupgarai2004/clinicdesk architecture

> Architecture diagram of the GitHub repository arupgarai2004/clinicdesk, 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/arupgarai2004/clinicdesk
- Repository: https://github.com/arupgarai2004/clinicdesk

## Overview

ClinicDesk is a clinic-operations and appointment-management product. Staff use the Angular dashboard to find and manage appointments and clinics, view schedules, and request AI suggestions; the dashboard’s shared stores and HTTP services connect those workflows to the NestJS API and PostgreSQL. Patients can browse clinics and enter a booking flow in the Next.js app. Auth, doctor endpoints, and AI are separate backend capabilities. The patient app is documented as a scaffold, and only sampled or README-documented relationships are shown.

Main entry points: [`apps/clinic-dashboard/src/app/app.routes.ts`](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/app.routes.ts) (Dashboard routes), [`apps/api/src/app.module.ts`](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/src/app.module.ts) (API application), [`apps/api/prisma/prisma.service.ts`](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/prisma/prisma.service.ts) (Prisma service), [`libs/api/src/lib`](https://github.com/arupgarai2004/clinicdesk/tree/main/libs/api/src/lib) (HTTP services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_staff["Staff dashboard"]
  node_routes["Dashboard routes<br/>[app.routes.ts]"]
  node_appt_pages["Appointment pages"]
  node_clinic_pages["Clinic pages"]
  node_calendar["Weekly calendar<br/>[weekly-calendar.ts]"]
  node_settings["Settings<br/>[settings.ts]"]
  node_layout["Dashboard shell<br/>[app.ts]"]
end

subgraph group_shared["Shared dashboard layers"]
  node_stores["Signal stores"]
  node_http_services["HTTP services"]
  node_models["Shared models"]
end

subgraph group_backend["NestJS API"]
  node_api_entry["API application<br/>[app.module.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_appointments["Appointment API"]
  node_clinics["Clinic API<br/>[clinics.service.ts]"]
  node_doctors["Doctor API<br/>[doctors.service.ts]"]
  node_ai_api["AI suggestions API<br/>[ai.service.ts]"]
end

subgraph group_patient["Patient app"]
  node_patient_browse["Clinic discovery<br/>[page.tsx]"]
  node_patient_booking["Booking flow<br/>[BookingForm.tsx]"]
  node_patient_confirmation["Booking confirmation<br/>[page.tsx]"]
  node_patient_auth["Patient auth screens<br/>[loginForm.tsx]"]
end

subgraph group_storage["Persistence and integrations"]
  node_prisma["Prisma service<br/>[prisma.service.ts]"]
  node_postgres[("PostgreSQL")]
  node_gemini["Google Gemini"]
end

node_staff_actor(("Clinic staff"))

node_staff_actor -->|"uses"| node_routes
node_routes -->|"routes to"| node_appt_pages
node_routes -->|"routes to"| node_clinic_pages
node_routes -->|"routes to"| node_calendar
node_routes -->|"routes to"| node_settings
node_layout -->|"hosts"| node_routes
node_appt_pages -->|"uses"| node_stores
node_clinic_pages -->|"uses"| node_stores
node_stores -->|"calls"| node_http_services
node_http_services -->|"HTTP requests"| node_appointments
node_http_services -->|"HTTP requests"| node_clinics
node_http_services -->|"HTTP requests"| node_ai_api
node_api_entry -->|"registers"| node_appointments
node_api_entry -->|"registers"| node_clinics
node_api_entry -->|"registers"| node_doctors
node_api_entry -->|"registers"| node_ai_api
node_api_entry -->|"registers"| node_auth
node_appointments -->|"queries"| node_prisma
node_clinics -->|"queries"| node_prisma
node_doctors -->|"queries"| node_prisma
node_auth -->|"queries"| node_prisma
node_prisma -->|"connects to"| node_postgres
node_patient_browse -->|"opens booking"| node_patient_booking
node_patient_browse -->|"fetches clinics"| node_clinics
node_patient_booking -.->|"submits booking"| node_patient_confirmation
node_patient_confirmation -->|"uses API"| node_appointments
node_patient_auth -.->|"auth endpoints"| node_auth
node_ai_api -->|"requests suggestions"| node_gemini

click node_routes "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/app.routes.ts"
click node_appt_pages "https://github.com/arupgarai2004/clinicdesk/tree/main/apps/clinic-dashboard/src/app/features/pages"
click node_clinic_pages "https://github.com/arupgarai2004/clinicdesk/tree/main/apps/clinic-dashboard/src/app/features/pages"
click node_calendar "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/features/pages/weekly-calendar/weekly-calendar.ts"
click node_settings "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/features/pages/settings/settings.ts"
click node_layout "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/app.ts"
click node_stores "https://github.com/arupgarai2004/clinicdesk/tree/main/libs/data-access/src/lib"
click node_http_services "https://github.com/arupgarai2004/clinicdesk/tree/main/libs/api/src/lib"
click node_models "https://github.com/arupgarai2004/clinicdesk/tree/main/libs/shared/models/src/lib"
click node_api_entry "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/src/app.module.ts"
click node_auth "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/auth/auth.service.ts"
click node_appointments "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/appointments/appointments.service.ts"
click node_clinics "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/clinics/clinics.service.ts"
click node_doctors "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/doctors/doctors.service.ts"
click node_ai_api "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/ai/ai.service.ts"
click node_patient_browse "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/page.tsx"
click node_patient_booking "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/book/%5BbookingId%5D/BookingForm.tsx"
click node_patient_confirmation "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/confirmation/page.tsx"
click node_patient_auth "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/login/loginForm.tsx"
click node_prisma "https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/prisma/prisma.service.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_routes,node_appt_pages,node_clinic_pages,node_calendar,node_settings,node_layout toneBlue
class node_stores,node_http_services,node_models toneAmber
class node_api_entry,node_auth,node_appointments,node_clinics,node_doctors,node_ai_api toneMint
class node_patient_browse,node_patient_booking,node_patient_confirmation,node_patient_auth toneRose
class node_prisma,node_postgres,node_gemini,node_staff_actor toneIndigo
```

## Components

### Staff dashboard

- [Dashboard routes](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/app.routes.ts): `apps/clinic-dashboard/src/app/app.routes.ts`
- [Appointment pages](https://github.com/arupgarai2004/clinicdesk/tree/main/apps/clinic-dashboard/src/app/features/pages): `apps/clinic-dashboard/src/app/features/pages`
- [Clinic pages](https://github.com/arupgarai2004/clinicdesk/tree/main/apps/clinic-dashboard/src/app/features/pages): `apps/clinic-dashboard/src/app/features/pages`
- [Weekly calendar](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/features/pages/weekly-calendar/weekly-calendar.ts): `apps/clinic-dashboard/src/app/features/pages/weekly-calendar/weekly-calendar.ts`
- [Settings](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/features/pages/settings/settings.ts): `apps/clinic-dashboard/src/app/features/pages/settings/settings.ts`
- [Dashboard shell](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/clinic-dashboard/src/app/app.ts): `apps/clinic-dashboard/src/app/app.ts`

### Shared dashboard layers

- [Signal stores](https://github.com/arupgarai2004/clinicdesk/tree/main/libs/data-access/src/lib): `libs/data-access/src/lib`
- [HTTP services](https://github.com/arupgarai2004/clinicdesk/tree/main/libs/api/src/lib): `libs/api/src/lib`
- [Shared models](https://github.com/arupgarai2004/clinicdesk/tree/main/libs/shared/models/src/lib): `libs/shared/models/src/lib`

### NestJS API

- [API application](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/src/app.module.ts): `apps/api/src/app.module.ts`
- [Authentication](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/auth/auth.service.ts): `apps/api/modules/auth/auth.service.ts`
- [Appointment API](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/appointments/appointments.service.ts): `apps/api/modules/appointments/appointments.service.ts`
- [Clinic API](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/clinics/clinics.service.ts): `apps/api/modules/clinics/clinics.service.ts`
- [Doctor API](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/doctors/doctors.service.ts): `apps/api/modules/doctors/doctors.service.ts`
- [AI suggestions API](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/modules/ai/ai.service.ts): `apps/api/modules/ai/ai.service.ts`

### Patient app

- [Clinic discovery](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/page.tsx): `apps/patient-web/src/app/page.tsx`
- [Booking flow](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/book/%5BbookingId%5D/BookingForm.tsx): `apps/patient-web/src/app/book/[bookingId]/BookingForm.tsx`
- [Booking confirmation](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/confirmation/page.tsx): `apps/patient-web/src/app/confirmation/page.tsx`
- [Patient auth screens](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/patient-web/src/app/login/loginForm.tsx): `apps/patient-web/src/app/login/loginForm.tsx`

### Persistence and integrations

- [Prisma service](https://github.com/arupgarai2004/clinicdesk/blob/main/apps/api/prisma/prisma.service.ts): `apps/api/prisma/prisma.service.ts`
- **PostgreSQL**
- **Google Gemini**

### Other components

- **Clinic staff**

## Connections

- Clinic staff → Dashboard routes: uses (evidence: `README.md`)
- Dashboard routes → Appointment pages: routes to (evidence: `apps/clinic-dashboard/src/app/app.routes.ts`)
- Dashboard routes → Clinic pages: routes to (evidence: `apps/clinic-dashboard/src/app/app.routes.ts`)
- Dashboard routes → Weekly calendar: routes to (evidence: `apps/clinic-dashboard/src/app/app.routes.ts`)
- Dashboard routes → Settings: routes to (evidence: `apps/clinic-dashboard/src/app/app.routes.ts`)
- Dashboard shell → Dashboard routes: hosts (evidence: `apps/clinic-dashboard/src/app/app.ts`)
- Appointment pages → Signal stores: uses (evidence: `apps/clinic-dashboard/src/app/features/pages/appointment-details/appointment-details.ts`)
- Clinic pages → Signal stores: uses (evidence: `apps/clinic-dashboard/src/app/features/pages/manage-clinic/manage-clinic.ts`)
- Signal stores → HTTP services: calls (evidence: `libs/data-access/src/lib/appointment/appointment.store.ts`)
- HTTP services → Appointment API: HTTP requests (evidence: `README.md`)
- HTTP services → Clinic API: HTTP requests (evidence: `README.md`)
- HTTP services → AI suggestions API: HTTP requests (evidence: `README.md`)
- API application → Appointment API: registers (evidence: `apps/api/src/app.module.ts`)
- API application → Clinic API: registers (evidence: `apps/api/src/app.module.ts`)
- API application → Doctor API: registers (evidence: `apps/api/src/app.module.ts`)
- API application → AI suggestions API: registers (evidence: `apps/api/src/app.module.ts`)
- API application → Authentication: registers (evidence: `apps/api/src/app.module.ts`)
- Appointment API → Prisma service: queries (evidence: `apps/api/modules/appointments/appointments.service.ts`)
- Clinic API → Prisma service: queries (evidence: `apps/api/modules/clinics/clinics.service.ts`)
- Doctor API → Prisma service: queries (evidence: `apps/api/modules/doctors/doctors.service.ts`)
- Authentication → Prisma service: queries (evidence: `apps/api/modules/auth/auth.service.ts`)
- Prisma service → PostgreSQL: connects to (evidence: `apps/api/prisma/prisma.service.ts`)
- Clinic discovery → Booking flow: opens booking (evidence: `apps/patient-web/src/app/page.tsx`)
- Clinic discovery → Clinic API: fetches clinics (evidence: `apps/patient-web/src/app/page.tsx`)
- Booking flow → Booking confirmation: submits booking
- Booking confirmation → Appointment API: uses API (evidence: `apps/patient-web/src/app/confirmation/page.tsx`)
- Patient auth screens → Authentication: auth endpoints
- AI suggestions API → Google Gemini: requests suggestions (evidence: `README.md`)
