# tenka04/patient-management-system-with-microservices architecture

> Architecture diagram of the GitHub repository tenka04/patient-management-system-with-microservices, 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/tenka04/patient-management-system-with-microservices
- Repository: https://github.com/tenka04/patient-management-system-with-microservices

## Overview

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: [`patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/service/PatientService.java) (Patient service), [`patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java) (Patient API), [`auth-service/src/main/java/com/pm/authservice/service/AuthService.java`](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/service/AuthService.java) (Auth service), [`api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java`](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java) (API gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patient["Patient management"]
  node_patient_api["Patient API"]
  node_patient_service["Patient service"]
  node_patient_mapper["Patient mapper<br/>[PatientMapper.java]"]
  node_patient_store[("Patient repository")]
  node_patient_model["Patient model<br/>[Patient.java]"]
  node_patient_errors["Error handling"]
end

subgraph group_auth["Authentication"]
  node_auth_api["Auth API"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_user_service["User service<br/>[UserService.java]"]
  node_user_repository[("User repository")]
  node_user_model["User model<br/>[User.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
end

subgraph group_billing["Billing"]
  node_billing_client["Billing gRPC client"]
  node_billing_service["Billing gRPC service"]
end

subgraph group_analytics["Analytics"]
  node_event_producer["Event producer<br/>[KafkaProducer.java]"]
  node_event_bus["Kafka event stream"]
  node_analytics_consumer["Analytics consumer<br/>[KafkaConsumer.java]"]
end

subgraph group_infra["Infrastructure"]
  node_cloud_stack["AWS infrastructure<br/>[LocalStack.java]"]
end

node_user(("API user"))
node_gateway["API gateway"]
node_aws["AWS services"]

node_user -->|"calls APIs"| node_gateway
node_gateway -.->|"routes requests"| node_patient_api
node_gateway -.->|"validates tokens"| node_auth_api
node_user -->|"logs in"| node_auth_api
node_patient_api -->|"delegates to"| node_patient_service
node_patient_service -->|"reads and writes"| node_patient_store
node_patient_service -->|"maps models"| node_patient_mapper
node_patient_store -->|"stores"| node_patient_model
node_patient_api -->|"handles errors"| node_patient_errors
node_patient_service -->|"requests account"| node_billing_client
node_billing_client -.->|"calls gRPC"| node_billing_service
node_patient_service -->|"sends event"| node_event_producer
node_event_producer -.->|"publishes event"| node_event_bus
node_event_bus -.->|"delivers events"| node_analytics_consumer
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"finds user"| node_user_service
node_auth_service -->|"issues and checks"| node_jwt
node_user_service -->|"queries email"| node_user_repository
node_user_repository -->|"loads"| node_user_model
node_cloud_stack -.->|"provisions resources"| node_aws

click node_gateway "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java"
click node_patient_api "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java"
click node_patient_service "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/service/PatientService.java"
click node_patient_mapper "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java"
click node_patient_store "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java"
click node_patient_model "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/model/Patient.java"
click node_patient_errors "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java"
click node_billing_client "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java"
click node_billing_service "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java"
click node_event_producer "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java"
click node_analytics_consumer "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java"
click node_auth_api "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/controller/AuthController.java"
click node_auth_service "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/service/AuthService.java"
click node_user_service "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/service/UserService.java"
click node_user_repository "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java"
click node_user_model "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/model/User.java"
click node_jwt "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java"
click node_cloud_stack "https://github.com/tenka04/patient-management-system-with-microservices/blob/main/infrastructure/src/main/java/com/pm/stack/LocalStack.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_patient_api,node_patient_service,node_patient_mapper,node_patient_store,node_patient_model,node_patient_errors,node_user toneBlue
class node_auth_api,node_auth_service,node_user_service,node_user_repository,node_user_model,node_jwt toneAmber
class node_billing_client,node_billing_service,node_gateway toneMint
class node_event_producer,node_event_bus,node_analytics_consumer toneRose
class node_cloud_stack,node_aws toneIndigo
```

## Components

### Patient management

- [Patient API](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java): `patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`
- [Patient service](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/service/PatientService.java): `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`
- [Patient mapper](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java): `patient-service/src/main/java/com/pm/patientservice/mapper/PatientMapper.java`
- [Patient repository](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java): `patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java`
- [Patient model](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/model/Patient.java): `patient-service/src/main/java/com/pm/patientservice/model/Patient.java`
- [Error handling](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java): `patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java`

### Authentication

- [Auth API](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/controller/AuthController.java): `auth-service/src/main/java/com/pm/authservice/controller/AuthController.java`
- [Auth service](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/service/AuthService.java): `auth-service/src/main/java/com/pm/authservice/service/AuthService.java`
- [User service](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/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/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java): `auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java`
- [User model](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/model/User.java): `auth-service/src/main/java/com/pm/authservice/model/User.java`
- [JWT utilities](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java): `auth-service/src/main/java/com/pm/authservice/util/JwtUtil.java`

### Billing

- [Billing gRPC client](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java): `patient-service/src/main/java/com/pm/patientservice/grpc/BillingServiceGrpcClient.java`
- [Billing gRPC service](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java): `billing-service/src/main/java/com/pm/billingservice/grpc/BillingGrpcService.java`

### Analytics

- [Event producer](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java): `patient-service/src/main/java/com/pm/patientservice/kafka/KafkaProducer.java`
- **Kafka event stream**
- [Analytics consumer](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java): `analytics-service/src/main/java/com/pm/analyticsservice/kafka/KafkaConsumer.java`

### Infrastructure

- [AWS infrastructure](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/infrastructure/src/main/java/com/pm/stack/LocalStack.java): `infrastructure/src/main/java/com/pm/stack/LocalStack.java`

### Other components

- **API user**
- [API gateway](https://github.com/tenka04/patient-management-system-with-microservices/blob/main/api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java): `api-gateway/src/main/java/com/pm/apigateway/filter/JwtValidationGatewayFilterFactory.java`
- **AWS services**

## Connections

- API user → API gateway: calls APIs (evidence: `README.md`)
- API gateway → Patient API: routes requests
- API gateway → Auth API: validates tokens
- API user → Auth API: logs in (evidence: `README.md`)
- Patient API → Patient service: delegates to (evidence: `patient-service/src/main/java/com/pm/patientservice/controller/PatientController.java`)
- Patient service → Patient repository: reads and writes (evidence: `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`)
- Patient service → Patient mapper: maps models (evidence: `patient-service/src/main/java/com/pm/patientservice/service/PatientService.java`)
- Patient repository → Patient model: stores (evidence: `patient-service/src/main/java/com/pm/patientservice/repository/PatientRepository.java`)
- Patient API → Error handling: handles errors (evidence: `patient-service/src/main/java/com/pm/patientservice/exception/GlobalExceptionHandler.java`)
- Patient service → Billing gRPC client: requests account (evidence: `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 (evidence: `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 (evidence: `auth-service/src/main/java/com/pm/authservice/controller/AuthController.java`)
- Auth service → User service: finds user (evidence: `auth-service/src/main/java/com/pm/authservice/service/AuthService.java`)
- Auth service → JWT utilities: issues and checks (evidence: `auth-service/src/main/java/com/pm/authservice/service/AuthService.java`)
- User service → User repository: queries email (evidence: `auth-service/src/main/java/com/pm/authservice/service/UserService.java`)
- User repository → User model: loads (evidence: `auth-service/src/main/java/com/pm/authservice/repository/UserRepository.java`)
- AWS infrastructure → AWS services: provisions resources
