# chiragsharma111/appointment_booking_system architecture

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

- Interactive diagram: https://gitdiagram.com/chiragsharma111/appointment_booking_system
- Repository: https://github.com/chiragsharma111/appointment_booking_system

## Overview

This is a Spring Boot clinic scheduling API. Clients register and browse doctors, then book appointments; booking looks up the doctor, finds the latest active slot, assigns a time, and persists the appointment. Clients can also retrieve, cancel, or complete appointments, with status transitions constrained by an enum. The graph follows the documented controller–service–repository–H2 layers and includes the doctor and appointment domain stages. Source evidence is strongest for the appointment flow; some doctor-module links are supported by the source index rather than full excerpts.

Main entry points: [`src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java`](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java) (Appointment Scheduling), [`src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java`](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java) (Doctor Queries), [`src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java`](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java) (Doctor Endpoints), [`src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java`](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java) (Appointment Endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_doctor_api["Doctor Endpoints"]
  node_appointment_api["Appointment Endpoints"]
  node_doctor_dto["Doctor Contracts"]
  node_appointment_dto["Appointment Contracts"]
end

subgraph group_logic["Business Services"]
  node_doctor_service["Doctor Management<br/>[DoctorService.java]"]
  node_appointment_service["Appointment Scheduling"]
end

subgraph group_domain["Domain Model"]
  node_status_rules["Status Transitions"]
  node_doctor_entity["Doctor Record<br/>[Doctor.java]"]
  node_appointment_entity["Appointment Record<br/>[Appointment.java]"]
end

subgraph group_persistence["Persistence"]
  node_doctor_repository["Doctor Queries"]
  node_appointment_repository["Appointment Queries"]
  node_h2[("H2 Database")]
end

node_client(("API Client"))

node_client -->|"manages doctors"| node_doctor_api
node_client -->|"books appointments"| node_appointment_api
node_doctor_api -->|"dispatches"| node_doctor_service
node_appointment_api -->|"dispatches"| node_appointment_service
node_doctor_api -->|"uses contracts"| node_doctor_dto
node_appointment_api -->|"uses contracts"| node_appointment_dto
node_doctor_service -->|"maps data"| node_doctor_dto
node_appointment_service -->|"maps data"| node_appointment_dto
node_doctor_service -->|"queries and saves"| node_doctor_repository
node_appointment_service -->|"looks up doctor"| node_doctor_repository
node_appointment_service -->|"queries and saves"| node_appointment_repository
node_appointment_service -->|"validates transitions"| node_status_rules
node_doctor_repository -->|"persists"| node_doctor_entity
node_appointment_repository -->|"persists"| node_appointment_entity
node_appointment_entity -->|"stores status"| node_status_rules
node_appointment_entity -->|"references doctor"| node_doctor_entity
node_doctor_repository -->|"reads and writes"| node_h2
node_appointment_repository -->|"reads and writes"| node_h2

click node_doctor_api "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java"
click node_appointment_api "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java"
click node_doctor_dto "https://github.com/chiragsharma111/appointment_booking_system/tree/main/src/main/java/com/projects/appointment_booking_system/dto"
click node_appointment_dto "https://github.com/chiragsharma111/appointment_booking_system/tree/main/src/main/java/com/projects/appointment_booking_system/dto"
click node_doctor_service "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/service/DoctorService.java"
click node_appointment_service "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java"
click node_status_rules "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/entity/enums/AppointmentStatus.java"
click node_doctor_entity "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/entity/Doctor.java"
click node_appointment_entity "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/entity/Appointment.java"
click node_doctor_repository "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java"
click node_appointment_repository "https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/repository/AppointmentRepository.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_doctor_api,node_appointment_api,node_doctor_dto,node_appointment_dto,node_client toneBlue
class node_doctor_service,node_appointment_service toneAmber
class node_status_rules,node_doctor_entity,node_appointment_entity toneMint
class node_doctor_repository,node_appointment_repository,node_h2 toneRose
```

## Components

### REST API

- [Doctor Endpoints](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java): `src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java`
- [Appointment Endpoints](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java): `src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java`
- [Doctor Contracts](https://github.com/chiragsharma111/appointment_booking_system/tree/main/src/main/java/com/projects/appointment_booking_system/dto): `src/main/java/com/projects/appointment_booking_system/dto`
- [Appointment Contracts](https://github.com/chiragsharma111/appointment_booking_system/tree/main/src/main/java/com/projects/appointment_booking_system/dto): `src/main/java/com/projects/appointment_booking_system/dto`

### Business Services

- [Doctor Management](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/service/DoctorService.java): `src/main/java/com/projects/appointment_booking_system/service/DoctorService.java`
- [Appointment Scheduling](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java): `src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java`

### Domain Model

- [Status Transitions](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/entity/enums/AppointmentStatus.java): `src/main/java/com/projects/appointment_booking_system/entity/enums/AppointmentStatus.java`
- [Doctor Record](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/entity/Doctor.java): `src/main/java/com/projects/appointment_booking_system/entity/Doctor.java`
- [Appointment Record](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/entity/Appointment.java): `src/main/java/com/projects/appointment_booking_system/entity/Appointment.java`

### Persistence

- [Doctor Queries](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java): `src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java`
- [Appointment Queries](https://github.com/chiragsharma111/appointment_booking_system/blob/main/src/main/java/com/projects/appointment_booking_system/repository/AppointmentRepository.java): `src/main/java/com/projects/appointment_booking_system/repository/AppointmentRepository.java`
- **H2 Database**

### Other components

- **API Client**

## Connections

- API Client → Doctor Endpoints: manages doctors (evidence: `README.md`)
- API Client → Appointment Endpoints: books appointments (evidence: `README.md`)
- Doctor Endpoints → Doctor Management: dispatches (evidence: `src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java`)
- Appointment Endpoints → Appointment Scheduling: dispatches (evidence: `src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java`)
- Doctor Endpoints → Doctor Contracts: uses contracts (evidence: `src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java`)
- Appointment Endpoints → Appointment Contracts: uses contracts (evidence: `src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java`)
- Doctor Management → Doctor Contracts: maps data (evidence: `src/main/java/com/projects/appointment_booking_system/service/DoctorService.java`)
- Appointment Scheduling → Appointment Contracts: maps data (evidence: `src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java`)
- Doctor Management → Doctor Queries: queries and saves (evidence: `src/main/java/com/projects/appointment_booking_system/service/DoctorService.java`)
- Appointment Scheduling → Doctor Queries: looks up doctor (evidence: `src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java`)
- Appointment Scheduling → Appointment Queries: queries and saves (evidence: `src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java`)
- Appointment Scheduling → Status Transitions: validates transitions (evidence: `src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java`)
- Doctor Queries → Doctor Record: persists (evidence: `src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java`)
- Appointment Queries → Appointment Record: persists (evidence: `src/main/java/com/projects/appointment_booking_system/repository/AppointmentRepository.java`)
- Appointment Record → Status Transitions: stores status (evidence: `src/main/java/com/projects/appointment_booking_system/entity/Appointment.java`)
- Appointment Record → Doctor Record: references doctor (evidence: `src/main/java/com/projects/appointment_booking_system/entity/Appointment.java`)
- Doctor Queries → H2 Database: reads and writes (evidence: `README.md`)
- Appointment Queries → H2 Database: reads and writes (evidence: `README.md`)
