How chiru-5/patient-management works
This is a Java/Spring microservices backend for patient records, authentication, billing, and event analytics. The main workflow enters through the gateway, reaches patient CRUD, persists patient state, then initiates billing over gRPC and publishes an event for Kafka analytics. Login follows a separate credential-to-JWT flow. The README documents gateway routing and the cross-service capabilities; source excerpts show patient and authentication orchestration. Some unsampled service internals are represented only at their existing service paths.
Main entry points: PatientService.java Patient workflows · ApiGatewayApplication.java API gateway · AuthService.java Credential and token service · PatientController.java Patient API
Components 21
API entry
- API gateway
api-gateway/src/main/java/com/pm/apigateway/ApiGatewayApplication.java - JWT filter
api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java
Authentication
- Auth endpoints
auth-service/src/main/java/com/pm/authservice/controller/AuthController.java - Credential and token service
auth-service/src/main/java/com/pm/authservice/service/AuthService.java - User lookup
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 account
auth-service/src/main/java/com/pm/authservice/model/User.java - JWT utility
auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java
Patient records
- Patient API
patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java - Patient workflows
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient DTOs
patient-service/src/main/java/com/pm/patientservice/dto/PatientRequestDTO.java - Patient mapper
patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java - Patient record
patient-service/src/main/java/com/pm/patientservice/model/Patient.java - Patient repository
patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java - Error mapping
patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java
Billing and analytics
- Billing gRPC client
patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java - Billing service
billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java - Patient event producer
patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java - Kafka
- Analytics consumer
analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java
Other components
- Client
Connections 23
- Client → API gateway: sends HTTP
README.md - API gateway → JWT filter: applies filter
README.md - API gateway → Auth endpoints: routes login
README.md - API gateway → Patient API: routes requests
README.md - Client → Auth endpoints: requests login
README.md - Auth endpoints → Credential and token service: authenticates
auth-service/src/main/java/com/pm/authservice/controller/AuthController.java - Credential and token service → User lookup: looks up user
auth-service/src/main/java/com/pm/authservice/service/AuthService.java - User lookup → User repository: finds by email
auth-service/src/main/java/com/pm/authservice/service/UserService.java - User repository → User account: loads account
auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java - Credential and token service → JWT utility: generates token
auth-service/src/main/java/com/pm/authservice/service/AuthService.java - JWT filter → JWT utility: validates JWT
- Patient API → Patient workflows: dispatches CRUD
patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java - Patient API → Patient DTOs: accepts and returns
patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java - Patient workflows → Patient repository: reads and writes
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient workflows → Patient mapper: maps records
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient mapper → Patient record: maps to model
patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java - Patient repository → Patient record: persists
patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java - Patient workflows → Billing gRPC client: creates account
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Billing gRPC client → Billing service: calls gRPC
README.md - Patient workflows → Patient event producer: publishes patient
patient-service/src/main/java/com/pm/patientservice/service/PatientService.java - Patient event producer → Kafka: sends event
README.md - Kafka → Analytics consumer: delivers events
README.md - Patient workflows → Error mapping: raises handled errors