# bigboss288/patient-service architecture

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

- Interactive diagram: https://gitdiagram.com/bigboss288/patient-service
- Repository: https://github.com/bigboss288/patient-service

## Overview

This is a Spring patient-management service with patient CRUD and a billing workflow. Patient requests enter through REST controllers, are handled by services using repositories and mapping, and return DTOs. Billing assembles patient stay and purchased-item details, then publishes the resulting bill to Kafka. The source excerpts support the main service calls; repository/database wiring and exception handling details are less fully shown, so those links are omitted rather than inferred.

Main entry points: [`src/main/java/com/pm/patient_service/service/BillingService.java`](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/service/BillingService.java) (Billing service), [`src/main/java/com/pm/patient_service/service/PatientService.java`](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/service/PatientService.java) (Patient service), [`src/main/java/com/pm/patient_service/controller/PatientController.java`](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/controller/PatientController.java) (Patient endpoints), [`src/main/java/com/pm/patient_service/controller/BillingController.java`](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/controller/BillingController.java) (Billing endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_patient_api["Patient endpoints"]
  node_billing_api["Billing endpoints"]
  node_patient_dtos["Patient DTOs"]
  node_billing_dtos["Billing DTOs"]
  node_validation["Create validation"]
end

subgraph group_patient["Patient Management"]
  node_patient_service["Patient service"]
  node_patient_mapper["Patient mapper<br/>[PatientMapper.java]"]
  node_patient_errors["Patient exceptions"]
  node_exception_handler["Exception handler"]
end

subgraph group_billing["Billing"]
  node_billing_service["Billing service"]
end

subgraph group_data["Persistence Models"]
  node_patient_repo["Patient repository"]
  node_billing_repo["Billing repository"]
  node_item_repo["Item repository"]
  node_patient_model["Patient model<br/>[Patient.java]"]
  node_billing_model["Billing model<br/>[Billing.java]"]
  node_item_model["Item model<br/>[Item.java]"]
end

subgraph group_messaging["Messaging"]
  node_kafka_producer["Kafka producer<br/>[KafkaProducer.java]"]
  node_kafka["Kafka"]
end

node_caller(("API caller"))

node_caller -.->|"sends requests"| node_patient_api
node_caller -.->|"sends requests"| node_billing_api
node_patient_api -->|"delegates to"| node_patient_service
node_patient_api -->|"accepts and returns"| node_patient_dtos
node_patient_api -->|"validates with"| node_validation
node_billing_api -->|"delegates to"| node_billing_service
node_billing_api -->|"accepts and returns"| node_billing_dtos
node_patient_service -->|"reads and writes"| node_patient_repo
node_patient_service -->|"maps through"| node_patient_mapper
node_patient_service -->|"uses"| node_patient_dtos
node_patient_service -->|"throws"| node_patient_errors
node_patient_mapper -->|"maps to and from"| node_patient_model
node_patient_mapper -->|"maps to and from"| node_patient_dtos
node_billing_service -->|"gets patient details"| node_patient_service
node_billing_service -->|"reads and writes"| node_billing_repo
node_billing_service -->|"looks up items"| node_item_repo
node_billing_service -->|"creates records"| node_billing_model
node_billing_service -->|"uses item data"| node_item_model
node_billing_service -->|"builds bill"| node_billing_dtos
node_billing_service -->|"publishes bill"| node_kafka_producer
node_kafka_producer -->|"sends message"| node_kafka

click node_patient_api "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/controller/PatientController.java"
click node_billing_api "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/controller/BillingController.java"
click node_patient_dtos "https://github.com/bigboss288/patient-service/tree/main/src/main/java/com/pm/patient_service/dto"
click node_billing_dtos "https://github.com/bigboss288/patient-service/tree/main/src/main/java/com/pm/patient_service/dto"
click node_validation "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/dto/validators/CreatePatientValidationGroup.java"
click node_patient_service "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/service/PatientService.java"
click node_patient_mapper "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/mapper/PatientMapper.java"
click node_patient_errors "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/exceptions/EmailAlreadyExistsException.java"
click node_exception_handler "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/exceptions/GlobalExceptionHandler.java"
click node_billing_service "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/service/BillingService.java"
click node_patient_repo "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/repository/PatientRepository.java"
click node_billing_repo "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/repository/BillingRepository.java"
click node_item_repo "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/repository/ItemRepository.java"
click node_patient_model "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/model/Patient.java"
click node_billing_model "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/model/Billing.java"
click node_item_model "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/model/Item.java"
click node_kafka_producer "https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/kafka/KafkaProducer.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_billing_api,node_patient_dtos,node_billing_dtos,node_validation toneBlue
class node_patient_service,node_patient_mapper,node_patient_errors,node_exception_handler toneAmber
class node_billing_service,node_caller toneMint
class node_patient_repo,node_billing_repo,node_item_repo,node_patient_model,node_billing_model,node_item_model toneRose
class node_kafka_producer,node_kafka toneIndigo
```

## Components

### REST API

- [Patient endpoints](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/controller/PatientController.java): `src/main/java/com/pm/patient_service/controller/PatientController.java`
- [Billing endpoints](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/controller/BillingController.java): `src/main/java/com/pm/patient_service/controller/BillingController.java`
- [Patient DTOs](https://github.com/bigboss288/patient-service/tree/main/src/main/java/com/pm/patient_service/dto): `src/main/java/com/pm/patient_service/dto`
- [Billing DTOs](https://github.com/bigboss288/patient-service/tree/main/src/main/java/com/pm/patient_service/dto): `src/main/java/com/pm/patient_service/dto`
- [Create validation](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/dto/validators/CreatePatientValidationGroup.java): `src/main/java/com/pm/patient_service/dto/validators/CreatePatientValidationGroup.java`

### Patient Management

- [Patient service](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/service/PatientService.java): `src/main/java/com/pm/patient_service/service/PatientService.java`
- [Patient mapper](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/mapper/PatientMapper.java): `src/main/java/com/pm/patient_service/mapper/PatientMapper.java`
- [Patient exceptions](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/exceptions/EmailAlreadyExistsException.java): `src/main/java/com/pm/patient_service/exceptions/EmailAlreadyExistsException.java`
- [Exception handler](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/exceptions/GlobalExceptionHandler.java): `src/main/java/com/pm/patient_service/exceptions/GlobalExceptionHandler.java`

### Billing

- [Billing service](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/service/BillingService.java): `src/main/java/com/pm/patient_service/service/BillingService.java`

### Persistence Models

- [Patient repository](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/repository/PatientRepository.java): `src/main/java/com/pm/patient_service/repository/PatientRepository.java`
- [Billing repository](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/repository/BillingRepository.java): `src/main/java/com/pm/patient_service/repository/BillingRepository.java`
- [Item repository](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/repository/ItemRepository.java): `src/main/java/com/pm/patient_service/repository/ItemRepository.java`
- [Patient model](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/model/Patient.java): `src/main/java/com/pm/patient_service/model/Patient.java`
- [Billing model](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/model/Billing.java): `src/main/java/com/pm/patient_service/model/Billing.java`
- [Item model](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/model/Item.java): `src/main/java/com/pm/patient_service/model/Item.java`

### Messaging

- [Kafka producer](https://github.com/bigboss288/patient-service/blob/main/src/main/java/com/pm/patient_service/kafka/KafkaProducer.java): `src/main/java/com/pm/patient_service/kafka/KafkaProducer.java`
- **Kafka**

### Other components

- **API caller**

## Connections

- API caller → Patient endpoints: sends requests
- API caller → Billing endpoints: sends requests
- Patient endpoints → Patient service: delegates to (evidence: `src/main/java/com/pm/patient_service/controller/PatientController.java`)
- Patient endpoints → Patient DTOs: accepts and returns (evidence: `src/main/java/com/pm/patient_service/controller/PatientController.java`)
- Patient endpoints → Create validation: validates with (evidence: `src/main/java/com/pm/patient_service/controller/PatientController.java`)
- Billing endpoints → Billing service: delegates to (evidence: `src/main/java/com/pm/patient_service/controller/BillingController.java`)
- Billing endpoints → Billing DTOs: accepts and returns (evidence: `src/main/java/com/pm/patient_service/controller/BillingController.java`)
- Patient service → Patient repository: reads and writes (evidence: `src/main/java/com/pm/patient_service/service/PatientService.java`)
- Patient service → Patient mapper: maps through (evidence: `src/main/java/com/pm/patient_service/service/PatientService.java`)
- Patient service → Patient DTOs: uses (evidence: `src/main/java/com/pm/patient_service/service/PatientService.java`)
- Patient service → Patient exceptions: throws (evidence: `src/main/java/com/pm/patient_service/service/PatientService.java`)
- Patient mapper → Patient model: maps to and from (evidence: `src/main/java/com/pm/patient_service/mapper/PatientMapper.java`)
- Patient mapper → Patient DTOs: maps to and from (evidence: `src/main/java/com/pm/patient_service/mapper/PatientMapper.java`)
- Billing service → Patient service: gets patient details (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Billing service → Billing repository: reads and writes (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Billing service → Item repository: looks up items (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Billing service → Billing model: creates records (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Billing service → Item model: uses item data (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Billing service → Billing DTOs: builds bill (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Billing service → Kafka producer: publishes bill (evidence: `src/main/java/com/pm/patient_service/service/BillingService.java`)
- Kafka producer → Kafka: sends message (evidence: `src/main/java/com/pm/patient_service/kafka/KafkaProducer.java`)
