# kshadan04/vaccinations-booking-system architecture

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

- Interactive diagram: https://gitdiagram.com/kshadan04/vaccinations-booking-system
- Repository: https://github.com/kshadan04/vaccinations-booking-system

## Overview

This is a Spring-based vaccination booking system. A person is represented in the system, books an appointment at a vaccination center, and receives doses; the domain also includes doctors and vaccination certificates. The tree indicates controller, service, repository, and model layers, but no README or source excerpts were provided. Accordingly, workflow and persistence links are shown as unverified rather than asserted as inspected calls.

Main entry points: [`src/main/java/com/example/vaccinationbookingsystem/controller/PersonController.java`](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/PersonController.java) (Person API), [`src/main/java/com/example/vaccinationbookingsystem/controller/AppointmentController.java`](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/AppointmentController.java) (Appointment API), [`src/main/java/com/example/vaccinationbookingsystem/controller/DoseController.java`](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/DoseController.java) (Dose API), [`src/main/java/com/example/vaccinationbookingsystem/service/PersonService.java`](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/PersonService.java) (Person Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_person_api["Person API"]
  node_appointment_api["Appointment API"]
  node_dose_api["Dose API"]
  node_doctor_api["Doctor API"]
  node_center_api["Center API"]
end

subgraph group_workflows["Booking Workflows"]
  node_person_service["Person Service<br/>[PersonService.java]"]
  node_appointment_service["Appointment Service"]
  node_dose_service["Dose Service<br/>[DoseService.java]"]
  node_doctor_service["Doctor Service<br/>[DoctorService.java]"]
  node_center_service["Center Service"]
end

subgraph group_persistence["Persistence"]
  node_person_repo["Person Repository"]
  node_appointment_repo["Appointment Repository"]
  node_dose_repo["Dose Repository"]
  node_doctor_repo["Doctor Repository"]
  node_center_repo["Center Repository"]
end

subgraph group_domain["Vaccination Domain"]
  node_person["Person Record<br/>[Person.java]"]
  node_appointment["Appointment Record<br/>[Appointment.java]"]
  node_dose["Dose Record<br/>[Dose.java]"]
  node_certificate["Vaccination Certificate<br/>[Certificate.java]"]
  node_doctor["Doctor Record<br/>[Doctor.java]"]
  node_center["Vaccination Center"]
end

node_user(("Person"))
node_database[("Application Database")]

node_user -.->|"registers"| node_person_api
node_user -.->|"books appointment"| node_appointment_api
node_user -.->|"books doses"| node_dose_api
node_person_api -.->|"delegates to"| node_person_service
node_appointment_api -.->|"delegates to"| node_appointment_service
node_dose_api -.->|"delegates to"| node_dose_service
node_doctor_api -.->|"delegates to"| node_doctor_service
node_center_api -.->|"delegates to"| node_center_service
node_person_service -.->|"uses"| node_person_repo
node_appointment_service -.->|"uses"| node_appointment_repo
node_dose_service -.->|"uses"| node_dose_repo
node_doctor_service -.->|"uses"| node_doctor_repo
node_center_service -.->|"uses"| node_center_repo
node_person_repo -.->|"persists records"| node_database
node_appointment_repo -.->|"persists records"| node_database
node_dose_repo -.->|"persists records"| node_database
node_doctor_repo -.->|"persists records"| node_database
node_center_repo -.->|"persists records"| node_database

click node_person_api "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/PersonController.java"
click node_appointment_api "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/AppointmentController.java"
click node_dose_api "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/DoseController.java"
click node_doctor_api "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/DoctorController.java"
click node_center_api "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/VaccinationCenterController.java"
click node_person_service "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/PersonService.java"
click node_appointment_service "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/AppointmentService.java"
click node_dose_service "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/DoseService.java"
click node_doctor_service "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/DoctorService.java"
click node_center_service "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/VaccinationCenterService.java"
click node_person_repo "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/PersonRepository.java"
click node_appointment_repo "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/AppointmentRepository.java"
click node_dose_repo "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/DoseRepository.java"
click node_doctor_repo "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/DoctorRepository.java"
click node_center_repo "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/VaccinationsCenterRepository.java"
click node_person "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Person.java"
click node_appointment "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Appointment.java"
click node_dose "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Dose.java"
click node_certificate "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Certificate.java"
click node_doctor "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Doctor.java"
click node_center "https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/VaccinationCenter.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_person_api,node_appointment_api,node_dose_api,node_doctor_api,node_center_api toneBlue
class node_person_service,node_appointment_service,node_dose_service,node_doctor_service,node_center_service,node_database toneAmber
class node_person_repo,node_appointment_repo,node_dose_repo,node_doctor_repo,node_center_repo toneMint
class node_person,node_appointment,node_dose,node_certificate,node_doctor,node_center toneRose
class node_user toneIndigo
```

## Components

### HTTP API

- [Person API](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/PersonController.java): `src/main/java/com/example/vaccinationbookingsystem/controller/PersonController.java`
- [Appointment API](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/AppointmentController.java): `src/main/java/com/example/vaccinationbookingsystem/controller/AppointmentController.java`
- [Dose API](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/DoseController.java): `src/main/java/com/example/vaccinationbookingsystem/controller/DoseController.java`
- [Doctor API](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/DoctorController.java): `src/main/java/com/example/vaccinationbookingsystem/controller/DoctorController.java`
- [Center API](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/controller/VaccinationCenterController.java): `src/main/java/com/example/vaccinationbookingsystem/controller/VaccinationCenterController.java`

### Booking Workflows

- [Person Service](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/PersonService.java): `src/main/java/com/example/vaccinationbookingsystem/service/PersonService.java`
- [Appointment Service](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/AppointmentService.java): `src/main/java/com/example/vaccinationbookingsystem/service/AppointmentService.java`
- [Dose Service](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/DoseService.java): `src/main/java/com/example/vaccinationbookingsystem/service/DoseService.java`
- [Doctor Service](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/DoctorService.java): `src/main/java/com/example/vaccinationbookingsystem/service/DoctorService.java`
- [Center Service](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/service/VaccinationCenterService.java): `src/main/java/com/example/vaccinationbookingsystem/service/VaccinationCenterService.java`

### Persistence

- [Person Repository](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/PersonRepository.java): `src/main/java/com/example/vaccinationbookingsystem/repository/PersonRepository.java`
- [Appointment Repository](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/AppointmentRepository.java): `src/main/java/com/example/vaccinationbookingsystem/repository/AppointmentRepository.java`
- [Dose Repository](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/DoseRepository.java): `src/main/java/com/example/vaccinationbookingsystem/repository/DoseRepository.java`
- [Doctor Repository](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/DoctorRepository.java): `src/main/java/com/example/vaccinationbookingsystem/repository/DoctorRepository.java`
- [Center Repository](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/repository/VaccinationsCenterRepository.java): `src/main/java/com/example/vaccinationbookingsystem/repository/VaccinationsCenterRepository.java`

### Vaccination Domain

- [Person Record](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Person.java): `src/main/java/com/example/vaccinationbookingsystem/model/Person.java`
- [Appointment Record](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Appointment.java): `src/main/java/com/example/vaccinationbookingsystem/model/Appointment.java`
- [Dose Record](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Dose.java): `src/main/java/com/example/vaccinationbookingsystem/model/Dose.java`
- [Vaccination Certificate](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Certificate.java): `src/main/java/com/example/vaccinationbookingsystem/model/Certificate.java`
- [Doctor Record](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/Doctor.java): `src/main/java/com/example/vaccinationbookingsystem/model/Doctor.java`
- [Vaccination Center](https://github.com/kshadan04/vaccinations-booking-system/blob/master/src/main/java/com/example/vaccinationbookingsystem/model/VaccinationCenter.java): `src/main/java/com/example/vaccinationbookingsystem/model/VaccinationCenter.java`

### Other components

- **Person**
- **Application Database**

## Connections

- Person → Person API: registers
- Person → Appointment API: books appointment
- Person → Dose API: books doses
- Person API → Person Service: delegates to
- Appointment API → Appointment Service: delegates to
- Dose API → Dose Service: delegates to
- Doctor API → Doctor Service: delegates to
- Center API → Center Service: delegates to
- Person Service → Person Repository: uses
- Appointment Service → Appointment Repository: uses
- Dose Service → Dose Repository: uses
- Doctor Service → Doctor Repository: uses
- Center Service → Center Repository: uses
- Person Repository → Application Database: persists records
- Appointment Repository → Application Database: persists records
- Dose Repository → Application Database: persists records
- Doctor Repository → Application Database: persists records
- Center Repository → Application Database: persists records
