# keancaballero/recoverease architecture

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

- Interactive diagram: https://gitdiagram.com/keancaballero/recoverease
- Repository: https://github.com/keancaballero/recoverease

## Overview

RecoverEase is a post-treatment recovery management application for patients, doctors, and administrators. Users authenticate and enter role-specific screens; the frontend sends API requests to the backend, whose domain handlers manage care workflows and persistent records. Major product branches include treatment and medication tracking, recovery logs, appointments, AI chat, notifications, reporting, and administration. Backend controller-to-store links are supported by sampled source references; several frontend-to-endpoint and unsampled subsystem details are documented only at feature level, so those links use README evidence.

Main entry points: [`backend/src/routes`](https://github.com/keancaballero/recoverease/tree/main/backend/src/routes) (API Routes), [`frontend/src/App.tsx`](https://github.com/keancaballero/recoverease/blob/main/frontend/src/App.tsx) (Role Screens), [`backend/src/lib/prisma.ts`](https://github.com/keancaballero/recoverease/blob/main/backend/src/lib/prisma.ts) (Prisma Client), [`frontend/src/lib/api.ts`](https://github.com/keancaballero/recoverease/blob/main/frontend/src/lib/api.ts) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User Application"]
  node_app["Role Screens<br/>[App.tsx]"]
  node_authstate["Auth State<br/>[AuthContext.tsx]"]
  node_carepages["Care Pages"]
  node_doctorpages["Doctor Pages"]
  node_adminpages["Admin Pages"]
  node_chatpage["Patient Chat"]
  node_notifycontext["Notification State"]
  node_api["API Client<br/>[api.ts]"]
end

subgraph group_backend["API and Access"]
  node_express["Express API<br/>[index.ts]"]
  node_routes["API Routes"]
  node_access["JWT Access Control<br/>[auth.middleware.ts]"]
  node_authlogic["Authentication<br/>[auth.controller.ts]"]
  node_prisma["Prisma Client<br/>[prisma.ts]"]
end

subgraph group_care["Recovery Care"]
  node_carelogic["Care Workflows"]
  node_appointments["Appointments"]
  node_reports["Reports<br/>[report.routes.ts]"]
end

subgraph group_engagement["Communication"]
  node_chatlogic["AI Chat Support<br/>[chat.controller.ts]"]
  node_notifications["Notifications"]
  node_announcements["Announcements"]
end

subgraph group_admin["Clinic Administration"]
  node_adminlogic["Administration"]
  node_audit["Audit Logs<br/>[audit.ts]"]
  node_settings["System Settings<br/>[setting.routes.ts]"]
end

node_patients(("Patients"))
node_doctors(("Doctors"))
node_admins(("Administrators"))
node_database[("Supabase PostgreSQL")]
node_claude{{"Anthropic Claude"}}

node_patients -->|"use"| node_app
node_doctors -->|"use"| node_app
node_admins -->|"use"| node_app
node_app -->|"provides auth"| node_authstate
node_app -->|"routes to"| node_carepages
node_app -->|"routes to"| node_doctorpages
node_app -->|"routes to"| node_adminpages
node_app -->|"routes to"| node_chatpage
node_carepages -.->|"requests data"| node_api
node_doctorpages -.->|"requests data"| node_api
node_adminpages -.->|"requests data"| node_api
node_chatpage -->|"sends chat"| node_api
node_notifycontext -->|"polls notifications"| node_api
node_api -->|"sends API requests"| node_express
node_express -->|"registers routes"| node_routes
node_routes -->|"guards requests"| node_access
node_routes -.->|"dispatches auth"| node_authlogic
node_routes -->|"dispatches care"| node_carelogic
node_routes -->|"dispatches appointments"| node_appointments
node_routes -->|"serves reports"| node_reports
node_routes -->|"dispatches chat"| node_chatlogic
node_routes -.->|"dispatches notifications"| node_notifications
node_routes -.->|"dispatches announcements"| node_announcements
node_routes -->|"dispatches admin"| node_adminlogic
node_routes -->|"serves settings"| node_settings
node_carelogic -->|"queries records"| node_prisma
node_appointments -->|"queries records"| node_prisma
node_adminlogic -->|"queries records"| node_prisma
node_adminlogic -->|"writes audit"| node_audit
node_chatlogic -->|"stores conversations"| node_prisma
node_chatlogic -.->|"consults AI"| node_claude
node_notifications -.->|"uses records"| node_prisma
node_prisma -->|"persists data"| node_database
node_reports -->|"reads care data"| node_prisma

click node_app "https://github.com/keancaballero/recoverease/blob/main/frontend/src/App.tsx"
click node_authstate "https://github.com/keancaballero/recoverease/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_carepages "https://github.com/keancaballero/recoverease/tree/main/frontend/src/pages/patient"
click node_doctorpages "https://github.com/keancaballero/recoverease/tree/main/frontend/src/pages/doctor"
click node_adminpages "https://github.com/keancaballero/recoverease/tree/main/frontend/src/pages/admin"
click node_chatpage "https://github.com/keancaballero/recoverease/blob/main/frontend/src/pages/patient/PatientChatPage.tsx"
click node_notifycontext "https://github.com/keancaballero/recoverease/blob/main/frontend/src/contexts/NotificationContext.tsx"
click node_api "https://github.com/keancaballero/recoverease/blob/main/frontend/src/lib/api.ts"
click node_express "https://github.com/keancaballero/recoverease/blob/main/backend/src/index.ts"
click node_routes "https://github.com/keancaballero/recoverease/tree/main/backend/src/routes"
click node_access "https://github.com/keancaballero/recoverease/blob/main/backend/src/middleware/auth.middleware.ts"
click node_authlogic "https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/auth.controller.ts"
click node_carelogic "https://github.com/keancaballero/recoverease/tree/main/backend/src/controllers"
click node_appointments "https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/appointment.controller.ts"
click node_reports "https://github.com/keancaballero/recoverease/blob/main/backend/src/routes/report.routes.ts"
click node_chatlogic "https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/chat.controller.ts"
click node_notifications "https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/notification.controller.ts"
click node_announcements "https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/announcement.controller.ts"
click node_adminlogic "https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/admin.controller.ts"
click node_audit "https://github.com/keancaballero/recoverease/blob/main/backend/src/utils/audit.ts"
click node_settings "https://github.com/keancaballero/recoverease/blob/main/backend/src/routes/setting.routes.ts"
click node_prisma "https://github.com/keancaballero/recoverease/blob/main/backend/src/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_app,node_authstate,node_carepages,node_doctorpages,node_adminpages,node_chatpage,node_notifycontext,node_api toneBlue
class node_express,node_routes,node_access,node_authlogic,node_prisma,node_database toneAmber
class node_carelogic,node_appointments,node_reports toneMint
class node_chatlogic,node_notifications,node_announcements toneRose
class node_adminlogic,node_audit,node_settings,node_patients,node_doctors,node_admins,node_claude toneIndigo
```

## Components

### User Application

- [Role Screens](https://github.com/keancaballero/recoverease/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth State](https://github.com/keancaballero/recoverease/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [Care Pages](https://github.com/keancaballero/recoverease/tree/main/frontend/src/pages/patient): `frontend/src/pages/patient`
- [Doctor Pages](https://github.com/keancaballero/recoverease/tree/main/frontend/src/pages/doctor): `frontend/src/pages/doctor`
- [Admin Pages](https://github.com/keancaballero/recoverease/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Patient Chat](https://github.com/keancaballero/recoverease/blob/main/frontend/src/pages/patient/PatientChatPage.tsx): `frontend/src/pages/patient/PatientChatPage.tsx`
- [Notification State](https://github.com/keancaballero/recoverease/blob/main/frontend/src/contexts/NotificationContext.tsx): `frontend/src/contexts/NotificationContext.tsx`
- [API Client](https://github.com/keancaballero/recoverease/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### API and Access

- [Express API](https://github.com/keancaballero/recoverease/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [API Routes](https://github.com/keancaballero/recoverease/tree/main/backend/src/routes): `backend/src/routes`
- [JWT Access Control](https://github.com/keancaballero/recoverease/blob/main/backend/src/middleware/auth.middleware.ts): `backend/src/middleware/auth.middleware.ts`
- [Authentication](https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Prisma Client](https://github.com/keancaballero/recoverease/blob/main/backend/src/lib/prisma.ts): `backend/src/lib/prisma.ts`

### Recovery Care

- [Care Workflows](https://github.com/keancaballero/recoverease/tree/main/backend/src/controllers): `backend/src/controllers`
- [Appointments](https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/appointment.controller.ts): `backend/src/controllers/appointment.controller.ts`
- [Reports](https://github.com/keancaballero/recoverease/blob/main/backend/src/routes/report.routes.ts): `backend/src/routes/report.routes.ts`

### Communication

- [AI Chat Support](https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/chat.controller.ts): `backend/src/controllers/chat.controller.ts`
- [Notifications](https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/notification.controller.ts): `backend/src/controllers/notification.controller.ts`
- [Announcements](https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/announcement.controller.ts): `backend/src/controllers/announcement.controller.ts`

### Clinic Administration

- [Administration](https://github.com/keancaballero/recoverease/blob/main/backend/src/controllers/admin.controller.ts): `backend/src/controllers/admin.controller.ts`
- [Audit Logs](https://github.com/keancaballero/recoverease/blob/main/backend/src/utils/audit.ts): `backend/src/utils/audit.ts`
- [System Settings](https://github.com/keancaballero/recoverease/blob/main/backend/src/routes/setting.routes.ts): `backend/src/routes/setting.routes.ts`

### Other components

- **Patients**
- **Doctors**
- **Administrators**
- **Supabase PostgreSQL**
- **Anthropic Claude**

## Connections

- Patients → Role Screens: use
- Doctors → Role Screens: use
- Administrators → Role Screens: use
- Role Screens → Auth State: provides auth (evidence: `frontend/src/App.tsx`)
- Role Screens → Care Pages: routes to (evidence: `frontend/src/App.tsx`)
- Role Screens → Doctor Pages: routes to (evidence: `frontend/src/App.tsx`)
- Role Screens → Admin Pages: routes to (evidence: `frontend/src/App.tsx`)
- Role Screens → Patient Chat: routes to (evidence: `frontend/src/App.tsx`)
- Care Pages → API Client: requests data (evidence: `frontend/src/pages/patient/PatientChatPage.tsx`)
- Doctor Pages → API Client: requests data (evidence: `frontend/src/pages/doctor/PatientDetailPage.tsx`)
- Admin Pages → API Client: requests data (evidence: `frontend/src/pages/admin/AdminDoctorsPage.tsx`)
- Patient Chat → API Client: sends chat (evidence: `frontend/src/pages/patient/PatientChatPage.tsx`)
- Notification State → API Client: polls notifications (evidence: `frontend/src/contexts/NotificationContext.tsx`)
- API Client → Express API: sends API requests
- Express API → API Routes: registers routes (evidence: `backend/src/index.ts`)
- API Routes → JWT Access Control: guards requests (evidence: `backend/src/routes/doctor.routes.ts`)
- API Routes → Authentication: dispatches auth
- API Routes → Care Workflows: dispatches care (evidence: `backend/src/routes/treatment.routes.ts`)
- API Routes → Appointments: dispatches appointments (evidence: `backend/src/routes/appointment.routes.ts`)
- API Routes → Reports: serves reports (evidence: `backend/src/index.ts`)
- API Routes → AI Chat Support: dispatches chat (evidence: `backend/src/routes/chat.routes.ts`)
- API Routes → Notifications: dispatches notifications
- API Routes → Announcements: dispatches announcements
- API Routes → Administration: dispatches admin (evidence: `backend/src/routes/admin.routes.ts`)
- API Routes → System Settings: serves settings (evidence: `backend/src/index.ts`)
- Care Workflows → Prisma Client: queries records (evidence: `backend/src/controllers/doctor.controller.ts`)
- Appointments → Prisma Client: queries records (evidence: `backend/src/controllers/appointment.controller.ts`)
- Administration → Prisma Client: queries records (evidence: `backend/src/controllers/admin.controller.ts`)
- Administration → Audit Logs: writes audit (evidence: `backend/src/controllers/admin.controller.ts`)
- AI Chat Support → Prisma Client: stores conversations (evidence: `backend/src/controllers/chat.controller.ts`)
- AI Chat Support → Anthropic Claude: consults AI
- Notifications → Prisma Client: uses records
- Prisma Client → Supabase PostgreSQL: persists data
- Reports → Prisma Client: reads care data (evidence: `backend/src/routes/report.routes.ts`)
