# jobayer-mahin/caresync architecture

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

- Interactive diagram: https://gitdiagram.com/jobayer-mahin/caresync
- Repository: https://github.com/jobayer-mahin/caresync

## Overview

CareSync is a hospital-management system spanning patient, doctor, and admin workflows. Users work through role-oriented web pages; backend capabilities include authentication, patient and doctor records, appointments, billing, emergency care, EHR documents, messaging, notifications, symptom assessment, and dashboards. Sampled code shows appointment, patient, and billing controllers delegating to services, plus service-level persistence and appointment notifications. The README is empty, and most frontend-to-backend wiring and several feature implementations were not sampled, so those relationships are left unasserted or marked unverified.

Main entry points: [`caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java`](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java) (Appointment workflow), [`caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java`](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java) (Billing and payments), [`caresync-backend/src/main/java/com/caresync/hms/repository/PatientRepository.java`](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/PatientRepository.java) (Patient repository), [`caresync-frontend/src/pages`](https://github.com/jobayer-mahin/caresync/tree/main/caresync-frontend/src/pages) (Role-based pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webpages["Role-based pages"]
  node_authguard["Session guard<br/>[useAuthGuard.js]"]
  node_toast["Toast feedback<br/>[Toast.jsx]"]
  node_appointmentui["Appointment pages"]
  node_patientui["Patient pages"]
  node_doctorui["Doctor pages"]
end

subgraph group_api["Backend API"]
  node_loginapi["Authentication API"]
  node_appointmentapi["Appointment API"]
  node_patientapi["Patient API"]
  node_billingapi["Billing API"]
end

subgraph group_care["Clinical workflows"]
  node_appointment["Appointment workflow"]
  node_patient["Patient records"]
  node_ehr["EHR documents"]
  node_symptoms["Symptom assessment"]
end

subgraph group_ops["Hospital operations"]
  node_emergency["Emergency cases"]
  node_billing["Billing and payments"]
  node_dashboard["Dashboard metrics"]
  node_communications["Messages and alerts"]
end

subgraph group_data["Persistence and security"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_patientrepo[("Patient repository")]
  node_appointmentrepo[("Appointment repository")]
  node_invoicerepo[("Invoice repository")]
  node_models["Clinical data entities"]
end

node_users(("Hospital users"))

node_users -->|"use"| node_webpages
node_users -.->|"authenticate"| node_loginapi
node_webpages -.->|"guard access"| node_authguard
node_webpages -.->|"show feedback"| node_toast
node_appointmentui -.->|"request appointments"| node_appointmentapi
node_patientui -.->|"request records"| node_patientapi
node_appointmentapi -->|"delegates to"| node_appointment
node_patientapi -->|"delegates to"| node_patient
node_billingapi -->|"delegates to"| node_billing
node_appointment -->|"reads and writes"| node_appointmentrepo
node_appointment -->|"loads patients"| node_patientrepo
node_appointment -->|"notifies"| node_communications
node_appointment -->|"maps entities"| node_models
node_patient -->|"reads and writes"| node_patientrepo
node_patient -->|"updates entities"| node_models
node_billing -->|"reads and writes"| node_invoicerepo
node_billing -->|"loads patients"| node_patientrepo
node_billing -->|"loads appointments"| node_appointmentrepo
node_authservice -->|"generates tokens"| node_jwt
node_authservice -->|"looks up patients"| node_patientrepo
node_loginapi -.->|"delegates to"| node_authservice

click node_webpages "https://github.com/jobayer-mahin/caresync/tree/main/caresync-frontend/src/pages"
click node_authguard "https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/lib/useAuthGuard.js"
click node_toast "https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/lib/Toast.jsx"
click node_appointmentui "https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/pages/patient-appointments/PatientAppointmentsPage.jsx"
click node_patientui "https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/pages/patient-management/PatientManagementPage.jsx"
click node_doctorui "https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/pages/doctor-dashboard/DoctorDashboardPage.jsx"
click node_loginapi "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/AuthController.java"
click node_appointmentapi "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/AppointmentController.java"
click node_patientapi "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/PatientController.java"
click node_billingapi "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/BillingController.java"
click node_appointment "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java"
click node_patient "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/PatientService.java"
click node_ehr "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/EhrDocumentService.java"
click node_symptoms "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/SymptomService.java"
click node_emergency "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/EmergencyService.java"
click node_billing "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java"
click node_dashboard "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/DashboardService.java"
click node_communications "https://github.com/jobayer-mahin/caresync/tree/main/caresync-backend/src/main/java/com/caresync/hms/service"
click node_authservice "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/AuthService.java"
click node_jwt "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/security/JwtUtil.java"
click node_patientrepo "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/PatientRepository.java"
click node_appointmentrepo "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/AppointmentRepository.java"
click node_invoicerepo "https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/InvoiceRepository.java"
click node_models "https://github.com/jobayer-mahin/caresync/tree/main/caresync-backend/src/main/java/com/caresync/hms/model"

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_webpages,node_authguard,node_toast,node_appointmentui,node_patientui,node_doctorui,node_users toneBlue
class node_loginapi,node_appointmentapi,node_patientapi,node_billingapi toneAmber
class node_appointment,node_patient,node_ehr,node_symptoms toneMint
class node_emergency,node_billing,node_dashboard,node_communications toneRose
class node_authservice,node_jwt,node_patientrepo,node_appointmentrepo,node_invoicerepo,node_models toneIndigo
```

## Components

### Web application

- [Role-based pages](https://github.com/jobayer-mahin/caresync/tree/main/caresync-frontend/src/pages): `caresync-frontend/src/pages`
- [Session guard](https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/lib/useAuthGuard.js): `caresync-frontend/src/lib/useAuthGuard.js`
- [Toast feedback](https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/lib/Toast.jsx): `caresync-frontend/src/lib/Toast.jsx`
- [Appointment pages](https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/pages/patient-appointments/PatientAppointmentsPage.jsx): `caresync-frontend/src/pages/patient-appointments/PatientAppointmentsPage.jsx`
- [Patient pages](https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/pages/patient-management/PatientManagementPage.jsx): `caresync-frontend/src/pages/patient-management/PatientManagementPage.jsx`
- [Doctor pages](https://github.com/jobayer-mahin/caresync/blob/main/caresync-frontend/src/pages/doctor-dashboard/DoctorDashboardPage.jsx): `caresync-frontend/src/pages/doctor-dashboard/DoctorDashboardPage.jsx`

### Backend API

- [Authentication API](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/AuthController.java): `caresync-backend/src/main/java/com/caresync/hms/controller/AuthController.java`
- [Appointment API](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/AppointmentController.java): `caresync-backend/src/main/java/com/caresync/hms/controller/AppointmentController.java`
- [Patient API](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/PatientController.java): `caresync-backend/src/main/java/com/caresync/hms/controller/PatientController.java`
- [Billing API](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/controller/BillingController.java): `caresync-backend/src/main/java/com/caresync/hms/controller/BillingController.java`

### Clinical workflows

- [Appointment workflow](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java): `caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java`
- [Patient records](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/PatientService.java): `caresync-backend/src/main/java/com/caresync/hms/service/PatientService.java`
- [EHR documents](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/EhrDocumentService.java): `caresync-backend/src/main/java/com/caresync/hms/service/EhrDocumentService.java`
- [Symptom assessment](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/SymptomService.java): `caresync-backend/src/main/java/com/caresync/hms/service/SymptomService.java`

### Hospital operations

- [Emergency cases](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/EmergencyService.java): `caresync-backend/src/main/java/com/caresync/hms/service/EmergencyService.java`
- [Billing and payments](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java): `caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java`
- [Dashboard metrics](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/DashboardService.java): `caresync-backend/src/main/java/com/caresync/hms/service/DashboardService.java`
- [Messages and alerts](https://github.com/jobayer-mahin/caresync/tree/main/caresync-backend/src/main/java/com/caresync/hms/service): `caresync-backend/src/main/java/com/caresync/hms/service`

### Persistence and security

- [Authentication service](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/service/AuthService.java): `caresync-backend/src/main/java/com/caresync/hms/service/AuthService.java`
- [JWT utilities](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/security/JwtUtil.java): `caresync-backend/src/main/java/com/caresync/hms/security/JwtUtil.java`
- [Patient repository](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/PatientRepository.java): `caresync-backend/src/main/java/com/caresync/hms/repository/PatientRepository.java`
- [Appointment repository](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/AppointmentRepository.java): `caresync-backend/src/main/java/com/caresync/hms/repository/AppointmentRepository.java`
- [Invoice repository](https://github.com/jobayer-mahin/caresync/blob/main/caresync-backend/src/main/java/com/caresync/hms/repository/InvoiceRepository.java): `caresync-backend/src/main/java/com/caresync/hms/repository/InvoiceRepository.java`
- [Clinical data entities](https://github.com/jobayer-mahin/caresync/tree/main/caresync-backend/src/main/java/com/caresync/hms/model): `caresync-backend/src/main/java/com/caresync/hms/model`

### Other components

- **Hospital users**

## Connections

- Hospital users → Role-based pages: use
- Hospital users → Authentication API: authenticate
- Role-based pages → Session guard: guard access
- Role-based pages → Toast feedback: show feedback (evidence: `caresync-frontend/src/pages/patient-appointments/main.jsx`)
- Appointment pages → Appointment API: request appointments
- Patient pages → Patient API: request records
- Appointment API → Appointment workflow: delegates to (evidence: `caresync-backend/src/main/java/com/caresync/hms/controller/AppointmentController.java`)
- Patient API → Patient records: delegates to (evidence: `caresync-backend/src/main/java/com/caresync/hms/controller/PatientController.java`)
- Billing API → Billing and payments: delegates to (evidence: `caresync-backend/src/main/java/com/caresync/hms/controller/BillingController.java`)
- Appointment workflow → Appointment repository: reads and writes (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java`)
- Appointment workflow → Patient repository: loads patients (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java`)
- Appointment workflow → Messages and alerts: notifies (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java`)
- Appointment workflow → Clinical data entities: maps entities (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/AppointmentService.java`)
- Patient records → Patient repository: reads and writes (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/PatientService.java`)
- Patient records → Clinical data entities: updates entities (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/PatientService.java`)
- Billing and payments → Invoice repository: reads and writes (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java`)
- Billing and payments → Patient repository: loads patients (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java`)
- Billing and payments → Appointment repository: loads appointments (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/BillingService.java`)
- Authentication service → JWT utilities: generates tokens (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/AuthService.java`)
- Authentication service → Patient repository: looks up patients (evidence: `caresync-backend/src/main/java/com/caresync/hms/service/AuthService.java`)
- Authentication API → Authentication service: delegates to
