How tenka04/patient-management-system-with-microservices works
This is a Spring Boot patient-management microservices system. Users call patient-management APIs through a JWT-secured gateway; patient creation persists a patient, requests a billing account over gRPC, and emits an event for analytics. A separate auth workflow issues and validates JWTs. The graph preserves the documented Kafka, billing, gateway, and AWS infrastructure capabilities; some cross-service wiring is not directly shown in the excerpts, so those links are marked unverified.
Main entry points: PatientService.java Patient service · PatientController.java Patient API · AuthService.java Auth service · JwtValidationGatewayFilterFactory.java API gateway
Components 21
Patient management
- Patient API
patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java - Patient service
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient mapper
patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java - Patient repository
patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java - Patient model
patient-service/src/main/java/com/pm/patientservice/model/Patient.java - Error handling
patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java
Authentication
- Auth API
auth-service/src/main/java/com/pm/authservice/controller/AuthController.java - Auth service
auth-service/src/main/java/com/pm/authservice/service/AuthService.java - User service
auth-service/src/main/java/com/pm/authservice/service/UserService.java - User repository
auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java - User model
auth-service/src/main/java/com/pm/authservice/model/User.java - JWT utilities
auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java
Billing
- Billing gRPC client
patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java - Billing gRPC service
billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java
Analytics
- Event producer
patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java - Kafka event stream
- Analytics consumer
analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java
Infrastructure
- AWS infrastructure
infrastructure/src/main/java/com/pm/stack/LocalStack.java
Other components
- API user
- API gateway
api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java - AWS services
Connections 20
- API user → API gateway: calls APIs
README.md - API gateway → Patient API: routes requests
- API gateway → Auth API: validates tokens
- API user → Auth API: logs in
README.md - Patient API → Patient service: delegates to
patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java - Patient service → Patient repository: reads and writes
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient service → Patient mapper: maps models
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient repository → Patient model: stores
patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java - Patient API → Error handling: handles errors
patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java - Patient service → Billing gRPC client: requests account
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Billing gRPC client → Billing gRPC service: calls gRPC
- Patient service → Event producer: sends event
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Event producer → Kafka event stream: publishes event
- Kafka event stream → Analytics consumer: delivers events
- Auth API → Auth service: delegates to
auth-service/src/main/java/com/pm/authservice/controller/AuthController.java - Auth service → User service: finds user
auth-service/src/main/java/com/pm/authservice/service/AuthService.java - Auth service → JWT utilities: issues and checks
auth-service/src/main/java/com/pm/authservice/service/AuthService.java - User service → User repository: queries email
auth-service/src/main/java/com/pm/authservice/service/UserService.java - User repository → User model: loads
auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java - AWS infrastructure → AWS services: provisions resources