How jesima-fathima/order-service works
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: OrderServiceImpl.java Order Service · OrderController.java Order API · OrderCreatedEventConsumer.java Event Consumer · KafkaOrderEventPublisher.java Kafka Publisher
Components 21
REST API
- Order API
src/main/java/com/eomp/orderservice/api/v1/OrderController.java - Health API
src/main/java/com/eomp/orderservice/api/v1/HealthController.java - API DTOs
src/main/java/com/eomp/orderservice/api/v1/dto - Error Handling
src/main/java/com/eomp/orderservice/exception/GlobalExceptionHandler.java - OpenAPI Setup
src/main/java/com/eomp/orderservice/config/OpenApiConfig.java
Order Domain
- Order Service
src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java - Service Contract
src/main/java/com/eomp/orderservice/service/OrderService.java - Order Model
src/main/java/com/eomp/orderservice/entity/Order.java
Event Messaging
- Order Event
src/main/java/com/eomp/orderservice/event/OrderCreatedEvent.java - Publisher Contract
src/main/java/com/eomp/orderservice/publisher/OrderEventPublisher.java - Kafka Publisher
src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java - Event Consumer
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java - Event Processor
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessor.java - Processor Logic
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessorImpl.java - Dead Letter Consumer
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventDltConsumer.java
Persistence
- Order Repository
src/main/java/com/eomp/orderservice/repository/OrderRepository.java - Processed Event
src/main/java/com/eomp/orderservice/entity/ProcessedEvent.java - Processed Repository
src/main/java/com/eomp/orderservice/repository/ProcessedEventRepository.java - Order Database
src/main/java/com/eomp/orderservice/config/DataSourceConfig.java
Other components
- API Client
- Kafka
Connections 18
- API Client → Order API: sends requests
src/main/java/com/eomp/orderservice/api/v1/OrderController.java - Order API → Service Contract: delegates operations
src/main/java/com/eomp/orderservice/api/v1/OrderController.java - Order API → API DTOs: accepts and returns
src/main/java/com/eomp/orderservice/api/v1/OrderController.java - Order Service → Service Contract: implements
src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java - Order Service → Order Repository: reads and writes
src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java - Order Service → Publisher Contract: publishes through
src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java - Order Service → Order Event: creates payload
src/main/java/com/eomp/orderservice/service/impl/OrderServiceImpl.java - Order Repository → Order Database: persists orders
README.md - Kafka Publisher → Publisher Contract: implements
src/main/java/com/eomp/orderservice/publisher/KafkaOrderEventPublisher.java - Kafka Publisher → Kafka: publishes events
README.md - Kafka → Event Consumer: delivers events
README.md - Event Consumer → Event Processor: dispatches event
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java - Event Consumer → Processed Repository: checks and records
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventConsumer.java - Processor Logic → Event Processor: implements
src/main/java/com/eomp/orderservice/consumer/OrderCreatedEventProcessorImpl.java - Dead Letter Consumer → Kafka: consumes dead letters
README.md - Processed Repository → Order Database: stores processed events
README.md - Health API → API DTOs: returns response
src/main/java/com/eomp/orderservice/api/v1/HealthController.java - OpenAPI Setup → Order API: documents API
README.md