# chiru-5/patient-management architecture

> Architecture diagram of the GitHub repository chiru-5/patient-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chiru-5/patient-management
- Repository: https://github.com/chiru-5/patient-management

## Overview

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: [`patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/service/PatientService.java) (Patient workflows), [`api-gateway/src/main/java/com/pm/apigateway/ApiGatewayApplication.java`](https://github.com/chiru-5/patient-management/blob/master/api-gateway/src/main/java/com/pm/apigateway/ApiGatewayApplication.java) (API gateway), [`auth-service/src/main/java/com/pm/authservice/service/AuthService.java`](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/service/AuthService.java) (Credential and token service), [`patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java) (Patient API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_gateway["API gateway"]
  node_jwtfilter["JWT filter"]
end

subgraph group_auth["Authentication"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Credential and token service<br/>[AuthService.java]"]
  node_userservice["User lookup<br/>[UserService.java]"]
  node_userrepo[("User repository")]
  node_usermodel["User account<br/>[User.java]"]
  node_jwtutil["JWT utility<br/>[JwtUtil.java]"]
end

subgraph group_patients["Patient records"]
  node_patientcontroller["Patient API"]
  node_patientservice["Patient workflows"]
  node_patientdto["Patient DTOs"]
  node_patientmapper["Patient mapper<br/>[PatientMapper.java]"]
  node_patientmodel["Patient record<br/>[Patient.java]"]
  node_patientrepo[("Patient repository")]
  node_exceptionhandler["Error mapping"]
end

subgraph group_integrations["Billing and analytics"]
  node_billingclient["Billing gRPC client"]
  node_billingservice["Billing service"]
  node_kafkaproducer["Patient event producer<br/>[KafkaProducer.java]"]
  node_kafka["Kafka"]
  node_analytics["Analytics consumer<br/>[KafkaConsumer.java]"]
end

node_client(("Client"))

node_client -->|"sends HTTP"| node_gateway
node_gateway -->|"applies filter"| node_jwtfilter
node_gateway -->|"routes login"| node_authcontroller
node_gateway -->|"routes requests"| node_patientcontroller
node_client -->|"requests login"| node_authcontroller
node_authcontroller -->|"authenticates"| node_authservice
node_authservice -->|"looks up user"| node_userservice
node_userservice -->|"finds by email"| node_userrepo
node_userrepo -->|"loads account"| node_usermodel
node_authservice -->|"generates token"| node_jwtutil
node_jwtfilter -.->|"validates JWT"| node_jwtutil
node_patientcontroller -->|"dispatches CRUD"| node_patientservice
node_patientcontroller -->|"accepts and returns"| node_patientdto
node_patientservice -->|"reads and writes"| node_patientrepo
node_patientservice -->|"maps records"| node_patientmapper
node_patientmapper -->|"maps to model"| node_patientmodel
node_patientrepo -->|"persists"| node_patientmodel
node_patientservice -->|"creates account"| node_billingclient
node_billingclient -->|"calls gRPC"| node_billingservice
node_patientservice -->|"publishes patient"| node_kafkaproducer
node_kafkaproducer -->|"sends event"| node_kafka
node_kafka -->|"delivers events"| node_analytics
node_patientservice -.->|"raises handled errors"| node_exceptionhandler

click node_gateway "https://github.com/chiru-5/patient-management/blob/master/api-gateway/src/main/java/com/pm/apigateway/ApiGatewayApplication.java"
click node_jwtfilter "https://github.com/chiru-5/patient-management/blob/master/api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java"
click node_authcontroller "https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/controller/AuthController.java"
click node_authservice "https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/service/AuthService.java"
click node_userservice "https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/service/UserService.java"
click node_userrepo "https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java"
click node_usermodel "https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/model/User.java"
click node_jwtutil "https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java"
click node_patientcontroller "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java"
click node_patientservice "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/service/PatientService.java"
click node_patientdto "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/dto/PatientRequestDTO.java"
click node_patientmapper "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java"
click node_patientmodel "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/model/Patient.java"
click node_patientrepo "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java"
click node_exceptionhandler "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java"
click node_billingclient "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java"
click node_billingservice "https://github.com/chiru-5/patient-management/blob/master/billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java"
click node_kafkaproducer "https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java"
click node_analytics "https://github.com/chiru-5/patient-management/blob/master/analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_jwtfilter,node_client toneBlue
class node_authcontroller,node_authservice,node_userservice,node_userrepo,node_usermodel,node_jwtutil toneAmber
class node_patientcontroller,node_patientservice,node_patientdto,node_patientmapper,node_patientmodel,node_patientrepo,node_exceptionhandler toneMint
class node_billingclient,node_billingservice,node_kafkaproducer,node_kafka,node_analytics toneRose
```

## Components

### API entry

- [API gateway](https://github.com/chiru-5/patient-management/blob/master/api-gateway/src/main/java/com/pm/apigateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/pm/apigateway/ApiGatewayApplication.java`
- [JWT filter](https://github.com/chiru-5/patient-management/blob/master/api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java): `api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java`

### Authentication

- [Auth endpoints](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/controller/AuthController.java): `auth-service/src/main/java/com/pm/authservice/controller/AuthController.java`
- [Credential and token service](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/service/AuthService.java): `auth-service/src/main/java/com/pm/authservice/service/AuthService.java`
- [User lookup](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/service/UserService.java): `auth-service/src/main/java/com/pm/authservice/service/UserService.java`
- [User repository](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java): `auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java`
- [User account](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/model/User.java): `auth-service/src/main/java/com/pm/authservice/model/User.java`
- [JWT utility](https://github.com/chiru-5/patient-management/blob/master/auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java): `auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java`

### Patient records

- [Patient API](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java): `patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`
- [Patient workflows](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/service/PatientService.java): `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`
- [Patient DTOs](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/dto/PatientRequestDTO.java): `patient-service/src/main/java/com/pm/patientservice/dto/PatientRequestDTO.java`
- [Patient mapper](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java): `patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java`
- [Patient record](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/model/Patient.java): `patient-service/src/main/java/com/pm/patientservice/model/Patient.java`
- [Patient repository](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java): `patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java`
- [Error mapping](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java): `patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java`

### Billing and analytics

- [Billing gRPC client](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java): `patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java`
- [Billing service](https://github.com/chiru-5/patient-management/blob/master/billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java): `billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java`
- [Patient event producer](https://github.com/chiru-5/patient-management/blob/master/patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java): `patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java`
- **Kafka**
- [Analytics consumer](https://github.com/chiru-5/patient-management/blob/master/analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java): `analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java`

### Other components

- **Client**

## Connections

- Client → API gateway: sends HTTP (evidence: `README.md`)
- API gateway → JWT filter: applies filter (evidence: `README.md`)
- API gateway → Auth endpoints: routes login (evidence: `README.md`)
- API gateway → Patient API: routes requests (evidence: `README.md`)
- Client → Auth endpoints: requests login (evidence: `README.md`)
- Auth endpoints → Credential and token service: authenticates (evidence: `auth-service/src/main/java/com/pm/authservice/controller/AuthController.java`)
- Credential and token service → User lookup: looks up user (evidence: `auth-service/src/main/java/com/pm/authservice/service/AuthService.java`)
- User lookup → User repository: finds by email (evidence: `auth-service/src/main/java/com/pm/authservice/service/UserService.java`)
- User repository → User account: loads account (evidence: `auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java`)
- Credential and token service → JWT utility: generates token (evidence: `auth-service/src/main/java/com/pm/authservice/service/AuthService.java`)
- JWT filter → JWT utility: validates JWT
- Patient API → Patient workflows: dispatches CRUD (evidence: `patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`)
- Patient API → Patient DTOs: accepts and returns (evidence: `patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`)
- Patient workflows → Patient repository: reads and writes (evidence: `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`)
- Patient workflows → Patient mapper: maps records (evidence: `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`)
- Patient mapper → Patient record: maps to model (evidence: `patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java`)
- Patient repository → Patient record: persists (evidence: `patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java`)
- Patient workflows → Billing gRPC client: creates account (evidence: `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`)
- Billing gRPC client → Billing service: calls gRPC (evidence: `README.md`)
- Patient workflows → Patient event producer: publishes patient (evidence: `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`)
- Patient event producer → Kafka: sends event (evidence: `README.md`)
- Kafka → Analytics consumer: delivers events (evidence: `README.md`)
- Patient workflows → Error mapping: raises handled errors
