# jesima-fathima/order-service architecture

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

- Interactive diagram: https://gitdiagram.com/jesima-fathima/order-service
- Repository: https://github.com/jesima-fathima/order-service

## Overview

This repository currently implements a single Spring Boot Order Service, not the broader microservices platform described as its future target. Its main workflow accepts versioned REST order requests, validates and handles them through the service layer, persists order state, and publishes a creation event; it also consumes order events with processed-event tracking and a dead-letter consumer. The graph preserves documented health, pagination, API documentation, and Kafka capabilities. Relationships for sampled code are cited to source evidence; some integrations are documented only in the README.

Main entry points: [`src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java`](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java) (Order Service), [`src/main/java/com/eomp/orderservice/api/v1/OrderController.java`](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/api/v1/OrderController.java) (Order API), [`src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java`](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java) (Event Consumer), [`src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java`](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java) (Kafka Publisher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_order_api["Order API"]
  node_health["Health API"]
  node_api_dtos["API DTOs"]
  node_exception_handler["Error Handling"]
  node_openapi["OpenAPI Setup<br/>[OpenApiConfig.java]"]
end

subgraph group_orders["Order Domain"]
  node_order_service["Order Service"]
  node_order_contract["Service Contract<br/>[OrderService.java]"]
  node_order_model["Order Model<br/>[Order.java]"]
end

subgraph group_events["Event Messaging"]
  node_event_contract["Order Event"]
  node_publisher_contract["Publisher Contract"]
  node_kafka_publisher["Kafka Publisher"]
  node_kafka_consumer["Event Consumer"]
  node_processor_contract["Event Processor"]
  node_processor_impl["Processor Logic"]
  node_dlt_consumer["Dead Letter Consumer"]
end

subgraph group_persistence["Persistence"]
  node_order_repository["Order Repository"]
  node_processed_model["Processed Event"]
  node_processed_repository["Processed Repository"]
  node_database[("Order Database")]
end

node_client(("API Client"))
node_kafka["Kafka"]

node_client -->|"sends requests"| node_order_api
node_order_api -->|"delegates operations"| node_order_contract
node_order_api -->|"accepts and returns"| node_api_dtos
node_order_service -->|"implements"| node_order_contract
node_order_service -->|"reads and writes"| node_order_repository
node_order_service -->|"publishes through"| node_publisher_contract
node_order_service -->|"creates payload"| node_event_contract
node_order_repository -.->|"persists orders"| node_database
node_kafka_publisher -->|"implements"| node_publisher_contract
node_kafka_publisher -.->|"publishes events"| node_kafka
node_kafka -.->|"delivers events"| node_kafka_consumer
node_kafka_consumer -->|"dispatches event"| node_processor_contract
node_kafka_consumer -->|"checks and records"| node_processed_repository
node_processor_impl -->|"implements"| node_processor_contract
node_dlt_consumer -.->|"consumes dead letters"| node_kafka
node_processed_repository -.->|"stores processed events"| node_database
node_health -->|"returns response"| node_api_dtos
node_openapi -.->|"documents API"| node_order_api

click node_order_api "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/api/v1/OrderController.java"
click node_health "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/api/v1/HealthController.java"
click node_api_dtos "https://github.com/jesima-fathima/order-service/tree/main/src/main/java/com/eomp/orderservice/api/v1/dto"
click node_exception_handler "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/exception/GlobalExceptionHandler.java"
click node_order_service "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java"
click node_order_contract "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/service/OrderService.java"
click node_order_model "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/entity/Order.java"
click node_order_repository "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/repository/OrderRepository.java"
click node_processed_model "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/entity/ProcessedEvent.java"
click node_processed_repository "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/repository/ProcessedEventRepository.java"
click node_database "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/config/DataSourceConfig.java"
click node_event_contract "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/event/OrderCreatedEvent.java"
click node_publisher_contract "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/publisher/OrderEventPublisher.java"
click node_kafka_publisher "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java"
click node_kafka_consumer "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java"
click node_processor_contract "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessor.java"
click node_processor_impl "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessorImpl.java"
click node_dlt_consumer "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventDltConsumer.java"
click node_openapi "https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/config/OpenApiConfig.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_order_api,node_health,node_api_dtos,node_exception_handler,node_openapi,node_client toneBlue
class node_order_service,node_order_contract,node_order_model toneAmber
class node_event_contract,node_publisher_contract,node_kafka_publisher,node_kafka_consumer,node_processor_contract,node_processor_impl,node_dlt_consumer toneMint
class node_order_repository,node_processed_model,node_processed_repository,node_database toneRose
class node_kafka toneIndigo
```

## Components

### REST API

- [Order API](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/api/v1/OrderController.java): `src/main/java/com/eomp/orderservice/api/v1/OrderController.java`
- [Health API](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/api/v1/HealthController.java): `src/main/java/com/eomp/orderservice/api/v1/HealthController.java`
- [API DTOs](https://github.com/jesima-fathima/order-service/tree/main/src/main/java/com/eomp/orderservice/api/v1/dto): `src/main/java/com/eomp/orderservice/api/v1/dto`
- [Error Handling](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/exception/GlobalExceptionHandler.java): `src/main/java/com/eomp/orderservice/exception/GlobalExceptionHandler.java`
- [OpenAPI Setup](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/config/OpenApiConfig.java): `src/main/java/com/eomp/orderservice/config/OpenApiConfig.java`

### Order Domain

- [Order Service](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java): `src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java`
- [Service Contract](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/service/OrderService.java): `src/main/java/com/eomp/orderservice/service/OrderService.java`
- [Order Model](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/entity/Order.java): `src/main/java/com/eomp/orderservice/entity/Order.java`

### Event Messaging

- [Order Event](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/event/OrderCreatedEvent.java): `src/main/java/com/eomp/orderservice/event/OrderCreatedEvent.java`
- [Publisher Contract](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/publisher/OrderEventPublisher.java): `src/main/java/com/eomp/orderservice/publisher/OrderEventPublisher.java`
- [Kafka Publisher](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java): `src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java`
- [Event Consumer](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java): `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java`
- [Event Processor](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessor.java): `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessor.java`
- [Processor Logic](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessorImpl.java): `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessorImpl.java`
- [Dead Letter Consumer](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventDltConsumer.java): `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventDltConsumer.java`

### Persistence

- [Order Repository](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/repository/OrderRepository.java): `src/main/java/com/eomp/orderservice/repository/OrderRepository.java`
- [Processed Event](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/entity/ProcessedEvent.java): `src/main/java/com/eomp/orderservice/entity/ProcessedEvent.java`
- [Processed Repository](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/repository/ProcessedEventRepository.java): `src/main/java/com/eomp/orderservice/repository/ProcessedEventRepository.java`
- [Order Database](https://github.com/jesima-fathima/order-service/blob/main/src/main/java/com/eomp/orderservice/config/DataSourceConfig.java): `src/main/java/com/eomp/orderservice/config/DataSourceConfig.java`

### Other components

- **API Client**
- **Kafka**

## Connections

- API Client → Order API: sends requests (evidence: `src/main/java/com/eomp/orderservice/api/v1/OrderController.java`)
- Order API → Service Contract: delegates operations (evidence: `src/main/java/com/eomp/orderservice/api/v1/OrderController.java`)
- Order API → API DTOs: accepts and returns (evidence: `src/main/java/com/eomp/orderservice/api/v1/OrderController.java`)
- Order Service → Service Contract: implements (evidence: `src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java`)
- Order Service → Order Repository: reads and writes (evidence: `src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java`)
- Order Service → Publisher Contract: publishes through (evidence: `src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java`)
- Order Service → Order Event: creates payload (evidence: `src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java`)
- Order Repository → Order Database: persists orders (evidence: `README.md`)
- Kafka Publisher → Publisher Contract: implements (evidence: `src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java`)
- Kafka Publisher → Kafka: publishes events (evidence: `README.md`)
- Kafka → Event Consumer: delivers events (evidence: `README.md`)
- Event Consumer → Event Processor: dispatches event (evidence: `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java`)
- Event Consumer → Processed Repository: checks and records (evidence: `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java`)
- Processor Logic → Event Processor: implements (evidence: `src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessorImpl.java`)
- Dead Letter Consumer → Kafka: consumes dead letters (evidence: `README.md`)
- Processed Repository → Order Database: stores processed events (evidence: `README.md`)
- Health API → API DTOs: returns response (evidence: `src/main/java/com/eomp/orderservice/api/v1/HealthController.java`)
- OpenAPI Setup → Order API: documents API (evidence: `README.md`)
