How keancaballero/recoverease works
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: routes API Routes · App.tsx Role Screens · prisma.ts Prisma Client · api.ts API Client
Components 27
User Application
- Role Screens
frontend/src/App.tsx - Auth State
frontend/src/contexts/AuthContext.tsx - Care Pages
frontend/src/pages/patient - Doctor Pages
frontend/src/pages/doctor - Admin Pages
frontend/src/pages/admin - Patient Chat
frontend/src/pages/patient/PatientChatPage.tsx - Notification State
frontend/src/contexts/NotificationContext.tsx - API Client
frontend/src/lib/api.ts
API and Access
- Express API
backend/src/index.ts - API Routes
backend/src/routes - JWT Access Control
backend/src/middleware/auth.middleware.ts - Authentication
backend/src/controllers/auth.controller.ts - Prisma Client
backend/src/lib/prisma.ts
Recovery Care
- Care Workflows
backend/src/controllers - Appointments
backend/src/controllers/appointment.controller.ts - Reports
backend/src/routes/report.routes.ts
Communication
- AI Chat Support
backend/src/controllers/chat.controller.ts - Notifications
backend/src/controllers/notification.controller.ts - Announcements
backend/src/controllers/announcement.controller.ts
Clinic Administration
- Administration
backend/src/controllers/admin.controller.ts - Audit Logs
backend/src/utils/audit.ts - System Settings
backend/src/routes/setting.routes.ts
Other components
- Patients
- Doctors
- Administrators
- Supabase PostgreSQL
- Anthropic Claude
Connections 34
- Patients → Role Screens: use
- Doctors → Role Screens: use
- Administrators → Role Screens: use
- Role Screens → Auth State: provides auth
frontend/src/App.tsx - Role Screens → Care Pages: routes to
frontend/src/App.tsx - Role Screens → Doctor Pages: routes to
frontend/src/App.tsx - Role Screens → Admin Pages: routes to
frontend/src/App.tsx - Role Screens → Patient Chat: routes to
frontend/src/App.tsx - Care Pages → API Client: requests data
frontend/src/pages/patient/PatientChatPage.tsx - Doctor Pages → API Client: requests data
frontend/src/pages/doctor/PatientDetailPage.tsx - Admin Pages → API Client: requests data
frontend/src/pages/admin/AdminDoctorsPage.tsx - Patient Chat → API Client: sends chat
frontend/src/pages/patient/PatientChatPage.tsx - Notification State → API Client: polls notifications
frontend/src/contexts/NotificationContext.tsx - API Client → Express API: sends API requests
- Express API → API Routes: registers routes
backend/src/index.ts - API Routes → JWT Access Control: guards requests
backend/src/routes/doctor.routes.ts - API Routes → Authentication: dispatches auth
- API Routes → Care Workflows: dispatches care
backend/src/routes/treatment.routes.ts - API Routes → Appointments: dispatches appointments
backend/src/routes/appointment.routes.ts - API Routes → Reports: serves reports
backend/src/index.ts - API Routes → AI Chat Support: dispatches chat
backend/src/routes/chat.routes.ts - API Routes → Notifications: dispatches notifications
- API Routes → Announcements: dispatches announcements
- API Routes → Administration: dispatches admin
backend/src/routes/admin.routes.ts - API Routes → System Settings: serves settings
backend/src/index.ts - Care Workflows → Prisma Client: queries records
backend/src/controllers/doctor.controller.ts - Appointments → Prisma Client: queries records
backend/src/controllers/appointment.controller.ts - Administration → Prisma Client: queries records
backend/src/controllers/admin.controller.ts - Administration → Audit Logs: writes audit
backend/src/controllers/admin.controller.ts - AI Chat Support → Prisma Client: stores conversations
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
backend/src/routes/report.routes.ts