How harshad-yewale/hospital-management-system works
This Spring Boot backend exposes REST APIs for hospital operations, with appointments as a prominent lifecycle workflow: a client submits appointment requests, the controller delegates to the appointment service, and the repository persists or retrieves appointment data. Patient, doctor, department, and insurance operations form parallel domain capabilities. The README documents a controller–service–repository–entity architecture and MySQL storage. Service implementations were not sampled, so detailed business-rule calls and some cross-domain wiring are not asserted.
Main entry points: MyGlobalExceptionHandler.java Global Exception Handler · DoctorController.java Doctors API · DepartmentController.java Departments API · AppointmentController.java Appointments API
Components 19
REST API
- Appointments API
src/main/java/com/harshadcodes/Hospital_Management_System/controllers/AppointmentController.java - Patients API
src/main/java/com/harshadcodes/Hospital_Management_System/controllers/PatientController.java - Doctors API
src/main/java/com/harshadcodes/Hospital_Management_System/controllers/DoctorController.java - Departments API
src/main/java/com/harshadcodes/Hospital_Management_System/controllers/DepartmentController.java - Insurance API
src/main/java/com/harshadcodes/Hospital_Management_System/controllers/InsuranceController.java
Domain Services
- Appointment Lifecycle
src/main/java/com/harshadcodes/Hospital_Management_System/services/AppointmentServiceImpl.java - Patient Management
src/main/java/com/harshadcodes/Hospital_Management_System/services/PatientServiceImpl.java - Doctor Management
src/main/java/com/harshadcodes/Hospital_Management_System/services/DoctorServiceImpl.java - Department Management
src/main/java/com/harshadcodes/Hospital_Management_System/services/DepartmentServiceImpl.java - Insurance Management
src/main/java/com/harshadcodes/Hospital_Management_System/services/InsuranceServiceImpl.java
Persistence
- Domain Entities
src/main/java/com/harshadcodes/Hospital_Management_System/entities - Appointment Repository
src/main/java/com/harshadcodes/Hospital_Management_System/repositories/AppointmentRepository.java - Patient Repository
src/main/java/com/harshadcodes/Hospital_Management_System/repositories/PatientRepository.java - Doctor Repository
src/main/java/com/harshadcodes/Hospital_Management_System/repositories/DoctorRepository.java - Department Repository
src/main/java/com/harshadcodes/Hospital_Management_System/repositories/DepartmentRepository.java - Insurance Repository
src/main/java/com/harshadcodes/Hospital_Management_System/repositories/InsuranceRepository.java
Error Handling
- Global Exception Handler
src/main/java/com/harshadcodes/Hospital_Management_System/Exceptions/MyGlobalExceptionHandler.java
Other components
- API Client
- MySQL Database
Connections 27
- API Client → Appointments API: sends requests
- API Client → Patients API: sends requests
- API Client → Doctors API: sends requests
- API Client → Departments API: sends requests
- API Client → Insurance API: sends requests
- Appointments API → Appointment Lifecycle: delegates
- Patients API → Patient Management: delegates
- Doctors API → Doctor Management: delegates
- Doctors API → Department Management: delegates
- Departments API → Department Management: delegates
- Departments API → Doctor Management: delegates
- Insurance API → Insurance Management: delegates
- Appointment Lifecycle → Appointment Repository: uses
- Patient Management → Patient Repository: uses
- Doctor Management → Doctor Repository: uses
- Department Management → Department Repository: uses
- Insurance Management → Insurance Repository: uses
- Appointment Repository → MySQL Database: reads and writes
- Patient Repository → MySQL Database: reads and writes
- Doctor Repository → MySQL Database: reads and writes
- Department Repository → MySQL Database: reads and writes
- Insurance Repository → MySQL Database: reads and writes
- Appointments API → Global Exception Handler: errors handled by
- Patients API → Global Exception Handler: errors handled by
- Doctors API → Global Exception Handler: errors handled by
- Departments API → Global Exception Handler: errors handled by
- Insurance API → Global Exception Handler: errors handled by