# tharunraj-u/care-and-cure architecture

> Architecture diagram of the GitHub repository tharunraj-u/care-and-cure, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tharunraj-u/care-and-cure
- Repository: https://github.com/tharunraj-u/care-and-cure

## Overview

Care and Cure is a hospital-management application split into a Spring MVC client and a hospital backend. Patients and staff use the client for account access, doctor discovery, appointment scheduling and management, bills, and payments; the backend provides the corresponding domain operations, persistence, and notifications. The excerpts show appointment scheduling calls from the client and backend service interactions with repositories and email. Other client-to-backend links are plausible but their endpoints are not visible in the supplied evidence, so they are not asserted here.

Main entry points: [`CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java`](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java) (Appointment operations), [`CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java`](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java) (Doctor administration), [`CareAndCureHospitalApp/src/main/java/com/cac/controller/AppointmentController.java`](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AppointmentController.java) (Appointment API), [`CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java`](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java) (Patient operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_client_appointments["Appointment pages"]
  node_client_patients["Patient pages"]
  node_client_doctors["Doctor pages"]
  node_client_admin["Admin pages"]
  node_client_bills["Bill pages"]
  node_client_payments["Payment pages"]
  node_client_users["Account pages"]
end

subgraph group_care["Care operations"]
  node_appointment_api["Appointment API"]
  node_availability_api["Availability API"]
  node_appointment_service["Appointment operations"]
  node_doctor_service["Doctor operations<br/>[DoctorService.java]"]
  node_patient_service["Patient operations"]
end

subgraph group_billing["Billing and payments"]
  node_billing_api["Bill API"]
  node_payment_api["Payment API"]
  node_bill_service["Bill operations<br/>[BillService.java]"]
  node_payment_service["Payment operations"]
  node_razorpay["Razorpay integration"]
end

subgraph group_identity["Identity and administration"]
  node_user_api["User API"]
  node_admin_doctor_api["Doctor administration"]
  node_admin_patient_api["Patient administration"]
  node_user_service["Account operations<br/>[UserService.java]"]
  node_admin_service["Admin operations<br/>[AdminService.java]"]
end

subgraph group_persistence["Persistence and notifications"]
  node_doctor_repository[("Doctor records")]
  node_patient_repository[("Patient records")]
  node_appointment_repository[("Appointment records")]
  node_bill_repository[("Bill records")]
  node_payment_repository[("Payment records")]
  node_email_service["Email notifications<br/>[EmailService.java]"]
  node_user_repository[("Account records")]
end

node_user(("Patient or staff"))

node_user -->|"uses"| node_client_appointments
node_client_appointments -.->|"requests availability"| node_appointment_api
node_appointment_api -.->|"delegates to"| node_appointment_service
node_appointment_service -->|"queries and saves"| node_appointment_repository
node_appointment_service -->|"uses"| node_doctor_repository
node_appointment_service -->|"uses"| node_patient_repository
node_appointment_service -->|"sends updates"| node_email_service
node_client_patients -.->|"requests data"| node_appointment_api
node_client_doctors -.->|"requests data"| node_appointment_api
node_client_admin -.->|"requests data"| node_admin_doctor_api
node_client_bills -.->|"requests bills"| node_billing_api
node_client_payments -.->|"submits payments"| node_payment_api
node_client_users -.->|"requests access"| node_user_api
node_billing_api -.->|"delegates to"| node_bill_service
node_payment_api -.->|"delegates to"| node_payment_service
node_payment_service -->|"uses"| node_bill_repository
node_payment_service -->|"uses"| node_payment_repository
node_user_api -.->|"delegates to"| node_user_service
node_user_service -.->|"reads and writes"| node_user_repository
node_patient_service -->|"reads and writes"| node_patient_repository
node_patient_service -->|"creates account"| node_user_service
node_patient_service -->|"sends welcome"| node_email_service
node_doctor_service -->|"uses"| node_doctor_repository
node_admin_doctor_api -->|"delegates to"| node_doctor_service
node_admin_doctor_api -->|"uses"| node_appointment_service
node_admin_doctor_api -->|"sends notices"| node_email_service

click node_client_appointments "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/AppointmentClientController.java"
click node_client_patients "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/PatientClientController.java"
click node_client_doctors "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/DoctorClientController.java"
click node_client_admin "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/AdminCleintController.java"
click node_client_bills "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/BillClientController.java"
click node_client_payments "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/PaymentClientController.java"
click node_client_users "https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/UserClientController.java"
click node_appointment_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AppointmentController.java"
click node_availability_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AvailabilityController.java"
click node_appointment_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java"
click node_doctor_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/DoctorService.java"
click node_patient_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java"
click node_doctor_repository "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/DoctorRepository.java"
click node_patient_repository "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/PatientRepository.java"
click node_appointment_repository "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/AppointmentRepository.java"
click node_billing_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/BillController.java"
click node_payment_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/PaymentController.java"
click node_bill_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/BillService.java"
click node_payment_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/PaymentService.java"
click node_razorpay "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/RazorpayService.java"
click node_bill_repository "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/BillRepository.java"
click node_payment_repository "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/PaymentRepository.java"
click node_email_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/EmailService.java"
click node_user_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/UserController.java"
click node_admin_doctor_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java"
click node_admin_patient_api "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminPatientController.java"
click node_user_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/UserService.java"
click node_admin_service "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/AdminService.java"
click node_user_repository "https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/UserRepository.java"

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_client_appointments,node_client_patients,node_client_doctors,node_client_admin,node_client_bills,node_client_payments,node_client_users toneBlue
class node_appointment_api,node_availability_api,node_appointment_service,node_doctor_service,node_patient_service toneAmber
class node_billing_api,node_payment_api,node_bill_service,node_payment_service,node_razorpay toneMint
class node_user_api,node_admin_doctor_api,node_admin_patient_api,node_user_service,node_admin_service toneRose
class node_doctor_repository,node_patient_repository,node_appointment_repository,node_bill_repository,node_payment_repository,node_email_service,node_user_repository,node_user toneIndigo
```

## Components

### Web client

- [Appointment pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/AppointmentClientController.java): `ClientService/src/main/java/com/cac/controller/AppointmentClientController.java`
- [Patient pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/PatientClientController.java): `ClientService/src/main/java/com/cac/controller/PatientClientController.java`
- [Doctor pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/DoctorClientController.java): `ClientService/src/main/java/com/cac/controller/DoctorClientController.java`
- [Admin pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/AdminCleintController.java): `ClientService/src/main/java/com/cac/controller/AdminCleintController.java`
- [Bill pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/BillClientController.java): `ClientService/src/main/java/com/cac/controller/BillClientController.java`
- [Payment pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/PaymentClientController.java): `ClientService/src/main/java/com/cac/controller/PaymentClientController.java`
- [Account pages](https://github.com/tharunraj-u/care-and-cure/blob/main/ClientService/src/main/java/com/cac/controller/UserClientController.java): `ClientService/src/main/java/com/cac/controller/UserClientController.java`

### Care operations

- [Appointment API](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AppointmentController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/AppointmentController.java`
- [Availability API](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AvailabilityController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/AvailabilityController.java`
- [Appointment operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java`
- [Doctor operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/DoctorService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/DoctorService.java`
- [Patient operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java`

### Billing and payments

- [Bill API](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/BillController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/BillController.java`
- [Payment API](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/PaymentController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/PaymentController.java`
- [Bill operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/BillService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/BillService.java`
- [Payment operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/PaymentService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/PaymentService.java`
- [Razorpay integration](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/RazorpayService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/RazorpayService.java`

### Identity and administration

- [User API](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/UserController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/UserController.java`
- [Doctor administration](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java`
- [Patient administration](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminPatientController.java): `CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminPatientController.java`
- [Account operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/UserService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/UserService.java`
- [Admin operations](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/AdminService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/AdminService.java`

### Persistence and notifications

- [Doctor records](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/DoctorRepository.java): `CareAndCureHospitalApp/src/main/java/com/cac/repository/DoctorRepository.java`
- [Patient records](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/PatientRepository.java): `CareAndCureHospitalApp/src/main/java/com/cac/repository/PatientRepository.java`
- [Appointment records](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/AppointmentRepository.java): `CareAndCureHospitalApp/src/main/java/com/cac/repository/AppointmentRepository.java`
- [Bill records](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/BillRepository.java): `CareAndCureHospitalApp/src/main/java/com/cac/repository/BillRepository.java`
- [Payment records](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/PaymentRepository.java): `CareAndCureHospitalApp/src/main/java/com/cac/repository/PaymentRepository.java`
- [Email notifications](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/service/EmailService.java): `CareAndCureHospitalApp/src/main/java/com/cac/service/EmailService.java`
- [Account records](https://github.com/tharunraj-u/care-and-cure/blob/main/CareAndCureHospitalApp/src/main/java/com/cac/repository/UserRepository.java): `CareAndCureHospitalApp/src/main/java/com/cac/repository/UserRepository.java`

### Other components

- **Patient or staff**

## Connections

- Patient or staff → Appointment pages: uses (evidence: `ClientService/src/main/java/com/cac/controller/AppointmentClientController.java`)
- Appointment pages → Appointment API: requests availability
- Appointment API → Appointment operations: delegates to (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/controller/AppointmentController.java`)
- Appointment operations → Appointment records: queries and saves (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java`)
- Appointment operations → Doctor records: uses (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java`)
- Appointment operations → Patient records: uses (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java`)
- Appointment operations → Email notifications: sends updates (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/AppointmentService.java`)
- Patient pages → Appointment API: requests data
- Doctor pages → Appointment API: requests data
- Admin pages → Doctor administration: requests data
- Bill pages → Bill API: requests bills
- Payment pages → Payment API: submits payments
- Account pages → User API: requests access
- Bill API → Bill operations: delegates to (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/controller/BillController.java`)
- Payment API → Payment operations: delegates to (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/controller/PaymentController.java`)
- Payment operations → Bill records: uses (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/PaymentService.java`)
- Payment operations → Payment records: uses (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/PaymentService.java`)
- User API → Account operations: delegates to
- Account operations → Account records: reads and writes (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/UserService.java`)
- Patient operations → Patient records: reads and writes (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java`)
- Patient operations → Account operations: creates account (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java`)
- Patient operations → Email notifications: sends welcome (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/PatientService.java`)
- Doctor operations → Doctor records: uses (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/service/DoctorService.java`)
- Doctor administration → Doctor operations: delegates to (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java`)
- Doctor administration → Appointment operations: uses (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java`)
- Doctor administration → Email notifications: sends notices (evidence: `CareAndCureHospitalApp/src/main/java/com/cac/controller/AdminDoctorController.java`)
