# onecaresystems/onecare-backend architecture

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

## Overview

OneCare is a Spring REST backend for clinic operations and administration. Users authenticate and receive tokens, then authorized callers manage patients, appointments and the appointment queue, prescriptions, medicines, and user accounts. Controllers delegate to business services; the documented project structure places persistence behind repositories and JPA entities. The controller-to-service links below are supported by the source index; links into unsampled implementations and storage are marked dashed and unverified. The README also documents MySQL as the configured database.

Main entry points: [`src/main/java/com/onecare/backend/repository`](https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/repository) (JPA Repositories), [`src/main/java/com/onecare/backend/service/AuthService.java`](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/AuthService.java) (Authentication Service), [`src/main/java/com/onecare/backend/controller/AuthController.java`](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/AuthController.java) (Authentication API), [`src/main/java/com/onecare/backend/controller/PatientController.java`](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/PatientController.java) (Patient API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Authentication API"]
  node_patient_api["Patient API"]
  node_appointment_api["Appointment API"]
  node_queue_api["Queue API"]
  node_prescription_api["Prescription API"]
  node_medicine_api["Medicine API"]
  node_user_api["User API"]
end

subgraph group_clinical["Clinical Workflows"]
  node_patient_service["Patient Service"]
  node_appointment_service["Appointment Service"]
  node_queue_service["Queue Service<br/>[QueueService.java]"]
  node_prescription_service["Prescription Service"]
  node_medicine_service["Medicine Management"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth_service["Authentication Service<br/>[AuthService.java]"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_access_control["Access Control<br/>[Permission.java]"]
  node_user_details["User Details Lookup"]
  node_jwt["JWT Service<br/>[JwtService.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA Repositories"]
  node_entities["Domain Entities"]
  node_mysql[("MySQL")]
end

node_caller(("API Caller"))

node_caller -->|"calls REST"| node_auth_api
node_caller -.->|"calls REST"| node_patient_api
node_caller -.->|"calls REST"| node_appointment_api
node_caller -.->|"calls REST"| node_queue_api
node_caller -.->|"calls REST"| node_prescription_api
node_caller -.->|"calls REST"| node_medicine_api
node_caller -.->|"calls REST"| node_user_api
node_auth_api -->|"delegates"| node_auth_service
node_patient_api -->|"delegates"| node_patient_service
node_appointment_api -->|"delegates"| node_appointment_service
node_queue_api -.->|"delegates"| node_queue_service
node_prescription_api -->|"delegates"| node_prescription_service
node_medicine_api -.->|"delegates"| node_medicine_service
node_user_api -->|"delegates"| node_user_service
node_user_details -->|"loads user"| node_repositories
node_auth_service -.->|"uses tokens"| node_jwt
node_auth_service -.->|"authenticates user"| node_user_details
node_patient_service -.->|"persists records"| node_repositories
node_appointment_service -.->|"persists appointments"| node_repositories
node_queue_service -.->|"reads queue data"| node_repositories
node_prescription_service -.->|"persists prescriptions"| node_repositories
node_medicine_service -.->|"accesses medicines"| node_repositories
node_user_service -.->|"persists users"| node_repositories
node_repositories -.->|"maps records"| node_entities
node_entities -.->|"stored in"| node_mysql

click node_auth_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/AuthController.java"
click node_patient_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/PatientController.java"
click node_appointment_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/AppointmentController.java"
click node_queue_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/QueueController.java"
click node_prescription_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/PrescriptionController.java"
click node_medicine_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/MedicineController.java"
click node_user_api "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/UserController.java"
click node_auth_service "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/AuthService.java"
click node_user_service "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/UserService.java"
click node_access_control "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/security/Permission.java"
click node_user_details "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/security/AppUserDetailsService.java"
click node_jwt "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/security/JwtService.java"
click node_patient_service "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/PatientService.java"
click node_appointment_service "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/AppointmentService.java"
click node_queue_service "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/QueueService.java"
click node_prescription_service "https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/PrescriptionService.java"
click node_medicine_service "https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/service"
click node_repositories "https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/repository"
click node_entities "https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/entity"

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_auth_api,node_patient_api,node_appointment_api,node_queue_api,node_prescription_api,node_medicine_api,node_user_api toneBlue
class node_patient_service,node_appointment_service,node_queue_service,node_prescription_service,node_medicine_service toneAmber
class node_auth_service,node_user_service,node_access_control,node_user_details,node_jwt,node_caller toneMint
class node_repositories,node_entities,node_mysql toneRose
```

## Components

### REST API

- [Authentication API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/AuthController.java): `src/main/java/com/onecare/backend/controller/AuthController.java`
- [Patient API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/PatientController.java): `src/main/java/com/onecare/backend/controller/PatientController.java`
- [Appointment API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/AppointmentController.java): `src/main/java/com/onecare/backend/controller/AppointmentController.java`
- [Queue API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/QueueController.java): `src/main/java/com/onecare/backend/controller/QueueController.java`
- [Prescription API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/PrescriptionController.java): `src/main/java/com/onecare/backend/controller/PrescriptionController.java`
- [Medicine API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/MedicineController.java): `src/main/java/com/onecare/backend/controller/MedicineController.java`
- [User API](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/controller/UserController.java): `src/main/java/com/onecare/backend/controller/UserController.java`

### Clinical Workflows

- [Patient Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/PatientService.java): `src/main/java/com/onecare/backend/service/PatientService.java`
- [Appointment Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/AppointmentService.java): `src/main/java/com/onecare/backend/service/AppointmentService.java`
- [Queue Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/QueueService.java): `src/main/java/com/onecare/backend/service/QueueService.java`
- [Prescription Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/PrescriptionService.java): `src/main/java/com/onecare/backend/service/PrescriptionService.java`
- [Medicine Management](https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/service): `src/main/java/com/onecare/backend/service`

### Identity & Access

- [Authentication Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/AuthService.java): `src/main/java/com/onecare/backend/service/AuthService.java`
- [User Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/service/UserService.java): `src/main/java/com/onecare/backend/service/UserService.java`
- [Access Control](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/security/Permission.java): `src/main/java/com/onecare/backend/security/Permission.java`
- [User Details Lookup](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/security/AppUserDetailsService.java): `src/main/java/com/onecare/backend/security/AppUserDetailsService.java`
- [JWT Service](https://github.com/onecaresystems/onecare-backend/blob/develop/src/main/java/com/onecare/backend/security/JwtService.java): `src/main/java/com/onecare/backend/security/JwtService.java`

### Persistence

- [JPA Repositories](https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/repository): `src/main/java/com/onecare/backend/repository`
- [Domain Entities](https://github.com/onecaresystems/onecare-backend/tree/develop/src/main/java/com/onecare/backend/entity): `src/main/java/com/onecare/backend/entity`
- **MySQL**

### Other components

- **API Caller**

## Connections

- API Caller → Authentication API: calls REST (evidence: `src/main/java/com/onecare/backend/controller/AuthController.java`)
- API Caller → Patient API: calls REST
- API Caller → Appointment API: calls REST
- API Caller → Queue API: calls REST
- API Caller → Prescription API: calls REST
- API Caller → Medicine API: calls REST
- API Caller → User API: calls REST
- Authentication API → Authentication Service: delegates (evidence: `src/main/java/com/onecare/backend/controller/AuthController.java`)
- Patient API → Patient Service: delegates (evidence: `src/main/java/com/onecare/backend/controller/PatientController.java`)
- Appointment API → Appointment Service: delegates (evidence: `src/main/java/com/onecare/backend/controller/AppointmentController.java`)
- Queue API → Queue Service: delegates (evidence: `src/main/java/com/onecare/backend/controller/QueueController.java`)
- Prescription API → Prescription Service: delegates (evidence: `src/main/java/com/onecare/backend/controller/PrescriptionController.java`)
- Medicine API → Medicine Management: delegates
- User API → User Service: delegates (evidence: `src/main/java/com/onecare/backend/controller/UserController.java`)
- User Details Lookup → JPA Repositories: loads user (evidence: `src/main/java/com/onecare/backend/security/AppUserDetailsService.java`)
- Authentication Service → JWT Service: uses tokens
- Authentication Service → User Details Lookup: authenticates user
- Patient Service → JPA Repositories: persists records
- Appointment Service → JPA Repositories: persists appointments
- Queue Service → JPA Repositories: reads queue data
- Prescription Service → JPA Repositories: persists prescriptions
- Medicine Management → JPA Repositories: accesses medicines (evidence: `src/main/java/com/onecare/backend/service/AuthServiceImpl.java`)
- User Service → JPA Repositories: persists users
- JPA Repositories → Domain Entities: maps records (evidence: `src/main/java/com/onecare/backend/repository/PrescriptionRepository.java`)
- Domain Entities → MySQL: stored in
