How chiragsharma111/appointment_booking_system works
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: AppointmentService.java Appointment Scheduling · DoctorRepository.java Doctor Queries · DoctorController.java Doctor Endpoints · AppointmentController.java Appointment Endpoints
Components 13
REST API
- Doctor Endpoints
src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java - Appointment Endpoints
src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java - Doctor Contracts
src/main/java/com/projects/appointment_booking_system/dto - Appointment Contracts
src/main/java/com/projects/appointment_booking_system/dto
Business Services
- Doctor Management
src/main/java/com/projects/appointment_booking_system/service/DoctorService.java - Appointment Scheduling
src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java
Domain Model
- Status Transitions
src/main/java/com/projects/appointment_booking_system/entity/enums/AppointmentStatus.java - Doctor Record
src/main/java/com/projects/appointment_booking_system/entity/Doctor.java - Appointment Record
src/main/java/com/projects/appointment_booking_system/entity/Appointment.java
Persistence
- Doctor Queries
src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java - Appointment Queries
src/main/java/com/projects/appointment_booking_system/repository/AppointmentRepository.java - H2 Database
Other components
- API Client
Connections 18
- API Client → Doctor Endpoints: manages doctors
README.md - API Client → Appointment Endpoints: books appointments
README.md - Doctor Endpoints → Doctor Management: dispatches
src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java - Appointment Endpoints → Appointment Scheduling: dispatches
src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java - Doctor Endpoints → Doctor Contracts: uses contracts
src/main/java/com/projects/appointment_booking_system/controller/DoctorController.java - Appointment Endpoints → Appointment Contracts: uses contracts
src/main/java/com/projects/appointment_booking_system/controller/AppointmentController.java - Doctor Management → Doctor Contracts: maps data
src/main/java/com/projects/appointment_booking_system/service/DoctorService.java - Appointment Scheduling → Appointment Contracts: maps data
src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java - Doctor Management → Doctor Queries: queries and saves
src/main/java/com/projects/appointment_booking_system/service/DoctorService.java - Appointment Scheduling → Doctor Queries: looks up doctor
src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java - Appointment Scheduling → Appointment Queries: queries and saves
src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java - Appointment Scheduling → Status Transitions: validates transitions
src/main/java/com/projects/appointment_booking_system/service/AppointmentService.java - Doctor Queries → Doctor Record: persists
src/main/java/com/projects/appointment_booking_system/repository/DoctorRepository.java - Appointment Queries → Appointment Record: persists
src/main/java/com/projects/appointment_booking_system/repository/AppointmentRepository.java - Appointment Record → Status Transitions: stores status
src/main/java/com/projects/appointment_booking_system/entity/Appointment.java - Appointment Record → Doctor Record: references doctor
src/main/java/com/projects/appointment_booking_system/entity/Appointment.java - Doctor Queries → H2 Database: reads and writes
README.md - Appointment Queries → H2 Database: reads and writes
README.md