Development Report
Microservice-Based Healthcare Platform
Prepared by: Vinayak
Date: 1/31/26
1. Project Architecture Overview
The backend system is designed using a microservice architecture. Each domain is isolated
into its own service with clear responsibility boundaries, independent routing, validation,
and Swagger-based API documentation. This approach ensures scalability, maintainability,
and ease of future expansion.
2. Backend Setup & Infrastructure
- [Link]-based microservices
- Centralized request validation using Joi
- Async error handling middleware
- UUID-based entity identification
- Swagger (OpenAPI) documentation for all services
- Modular folder structure per service
- Environment-based configuration
3. Doctor Service
Implemented full doctor lifecycle management including creation, listing, verification,
activation, and deactivation.
APIs Implemented:
- POST /api/doctors (Create Doctor)
- GET /api/doctors (List Doctors)
- GET /api/doctors/{id}
- PATCH /api/doctors/{id}
- DELETE /api/doctors/{id}
- GET /api/doctors/search/specialization
Additional Features:
- Status-based activation/deactivation
- Verification workflow
- Swagger schemas and validations
4. Profile & Family Member Service
Patient-linked profile and family member management has been integrated.
APIs Implemented:
- GET /api/family-members/patient/{patientId}
- GET /api/family-members/{id}
- PATCH /api/family-members/{id}
- DELETE /api/family-members/{id}
5. Hospital Admin & Super Admin Services
Admin management across hospitals and platform-level super admins implemented.
Hospital Admin APIs:
- GET /api/hospital-admins/hospital/{hospitalName}
- GET /api/hospital-admins/{id}
- PATCH /api/hospital-admins/{id}
- DELETE /api/hospital-admins/{id}
Super Admin APIs:
- GET /api/super-admins/{id}
- PATCH /api/super-admins/{id}
- DELETE /api/super-admins/{id}
6. Patient Service
Patient management with advanced filtering, pagination, and sorting.
APIs Implemented:
- GET /api/patients (search, filter, paginate)
- GET /api/patients/{id}
- PATCH /api/patients/{id}
- DELETE /api/patients/{id}
7. Health Services & Health Packages
Complete implementation of health services and bundled health packages.
Health Service APIs:
- POST /api/health-services
- GET /api/health-services
- GET /api/health-services/type/{type}
- GET /api/health-services/{id}
- PATCH /api/health-services/{id}
- DELETE /api/health-services/{id}
Health Package APIs:
- POST /api/health-packages
- GET /api/health-packages
- GET /api/health-packages/{id}
- PATCH /api/health-packages/{id}
- DELETE /api/health-packages/{id}
- POST /api/health-packages/services
- DELETE /api/health-packages/{packageId}/services/{serviceId}
- GET /api/health-packages/{packageId}/services
8. Frontend & Integration Progress
- Doctor listing and creation screens
- Doctor verification and activation/deactivation UI
- API integration using React Query
- Status-aware UI rendering
- Toast-based feedback
- Profile Component
-Health Services and Health Packages
- Reusable confirmation dialogs
9. Documentation & Demo
All APIs are documented using Swagger and ready for client review.
A demo video is being recorded to showcase:
- Microservice architecture
- Swagger API walkthrough
-Login and Doctor lifecycle management
- Health services and package flows
- Frontend integration
10. Next Steps
- API Gateway integration
- Audit logging
- Deployment & monitoring