# nikookinn/cdi-eureka-service architecture

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

- Interactive diagram: https://gitdiagram.com/nikookinn/cdi-eureka-service
- Repository: https://github.com/nikookinn/cdi-eureka-service

## Overview

CDI Eureka Service exposes one REST query that validates a Eureka URL, fetches registered applications, groups instances by server or service, and returns a transaction-correlated response. The sampled flow shows the query orchestrator, strategy dispatch, service-grouping implementation, HTTP client, and instance mapper; the README documents server grouping and operational features whose implementation links are not fully sampled.

Main entry points: [`cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java`](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java) (Query Orchestrator), [`cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java`](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java) (Service Grouping), [`cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java`](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java) (Query Controller), [`cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategy.java`](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategy.java) (Grouping Strategy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and Responses"]
  node_controller["Query Controller"]
  node_request["Query Request"]
  node_groupresult["Grouped Results<br/>[GroupedResult.java]"]
  node_serverresult["Server Result<br/>[ServerResult.java]"]
  node_serviceresult["Service Result<br/>[ServiceResult.java]"]
  node_response["Query Response"]
  node_codes["Return Codes<br/>[ReturnCode.java]"]
end

subgraph group_flow["Query and Grouping"]
  node_query["Query Orchestrator"]
  node_eurekaservice["Grouping Dispatch<br/>[EurekaService.java]"]
  node_factory["Strategy Factory"]
  node_strategy["Grouping Strategy"]
  node_servicegroup["Service Grouping"]
  node_servergroup["Server Grouping"]
end

subgraph group_integration["Eureka Integration"]
  node_eureka[("Eureka Server")]
  node_httpclient["Eureka HTTP Client"]
  node_mapper["Instance Mapper"]
  node_instance["Instance Details"]
end

subgraph group_support["Cross-cutting Support"]
  node_errors["API Exceptions<br/>[ApiException.java]"]
  node_handler["Error Handler"]
  node_transaction["Transaction Tracking"]
  node_logger["Structured Logging<br/>[AppLogger.java]"]
end

node_client(("REST Client"))

node_client -->|"sends query"| node_controller
node_controller -->|"accepts"| node_request
node_controller -->|"delegates"| node_query
node_query -->|"requests grouping"| node_eurekaservice
node_eurekaservice -->|"resolves strategy"| node_factory
node_factory -.->|"selects strategy"| node_strategy
node_strategy -.->|"implemented by"| node_servicegroup
node_strategy -.->|"implemented by"| node_servergroup
node_servicegroup -->|"fetches apps"| node_httpclient
node_httpclient -->|"requests apps"| node_eureka
node_servicegroup -->|"maps instances"| node_mapper
node_mapper -->|"builds details"| node_instance
node_servicegroup -->|"builds result"| node_serviceresult
node_serviceresult -->|"implements"| node_groupresult
node_serverresult -->|"implements"| node_groupresult
node_query -->|"constructs response"| node_response
node_response -->|"wraps data"| node_groupresult
node_query -->|"raises errors"| node_errors
node_handler -->|"formats errors"| node_response
node_handler -->|"uses codes"| node_codes
node_transaction -.->|"sets request ID"| node_query
node_query -->|"logs timing"| node_logger

click node_controller "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java"
click node_request "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/request/EurekaQueryRequest.java"
click node_query "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java"
click node_eurekaservice "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaService.java"
click node_factory "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategyFactory.java"
click node_strategy "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategy.java"
click node_servicegroup "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java"
click node_servergroup "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServerGroupingStrategy.java"
click node_httpclient "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaClientHelper.java"
click node_mapper "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/mapper/InstanceMapper.java"
click node_instance "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/base/BaseInstanceDetail.java"
click node_groupresult "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/GroupedResult.java"
click node_serverresult "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServerResult.java"
click node_serviceresult "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServiceResult.java"
click node_response "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/EurekaQueryResponse.java"
click node_codes "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/ReturnCode.java"
click node_errors "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/ApiException.java"
click node_handler "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/GlobalHandlerException.java"
click node_transaction "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/interceptor/TransactionIdInterceptor.java"
click node_logger "https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/logger/AppLogger.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_controller,node_request,node_groupresult,node_serverresult,node_serviceresult,node_response,node_codes,node_client toneBlue
class node_query,node_eurekaservice,node_factory,node_strategy,node_servicegroup,node_servergroup toneAmber
class node_eureka,node_httpclient,node_mapper,node_instance toneMint
class node_errors,node_handler,node_transaction,node_logger toneRose
```

## Components

### API and Responses

- [Query Controller](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java`
- [Query Request](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/request/EurekaQueryRequest.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/request/EurekaQueryRequest.java`
- [Grouped Results](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/GroupedResult.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/GroupedResult.java`
- [Server Result](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServerResult.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServerResult.java`
- [Service Result](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServiceResult.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServiceResult.java`
- [Query Response](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/EurekaQueryResponse.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/EurekaQueryResponse.java`
- [Return Codes](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/ReturnCode.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/ReturnCode.java`

### Query and Grouping

- [Query Orchestrator](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java`
- [Grouping Dispatch](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaService.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaService.java`
- [Strategy Factory](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategyFactory.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategyFactory.java`
- [Grouping Strategy](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategy.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategy.java`
- [Service Grouping](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java`
- [Server Grouping](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServerGroupingStrategy.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServerGroupingStrategy.java`

### Eureka Integration

- **Eureka Server**
- [Eureka HTTP Client](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaClientHelper.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaClientHelper.java`
- [Instance Mapper](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/mapper/InstanceMapper.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/mapper/InstanceMapper.java`
- [Instance Details](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/base/BaseInstanceDetail.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/base/BaseInstanceDetail.java`

### Cross-cutting Support

- [API Exceptions](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/ApiException.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/ApiException.java`
- [Error Handler](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/GlobalHandlerException.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/GlobalHandlerException.java`
- [Transaction Tracking](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/interceptor/TransactionIdInterceptor.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/interceptor/TransactionIdInterceptor.java`
- [Structured Logging](https://github.com/nikookinn/cdi-eureka-service/blob/main/cdi-eureka-service/src/main/java/com/dafreurekadetails/logger/AppLogger.java): `cdi-eureka-service/src/main/java/com/dafreurekadetails/logger/AppLogger.java`

### Other components

- **REST Client**

## Connections

- REST Client → Query Controller: sends query
- Query Controller → Query Request: accepts (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java`)
- Query Controller → Query Orchestrator: delegates (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/controller/EurekaQueryController.java`)
- Query Orchestrator → Grouping Dispatch: requests grouping (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java`)
- Grouping Dispatch → Strategy Factory: resolves strategy (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaService.java`)
- Strategy Factory → Grouping Strategy: selects strategy (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/GroupingStrategyFactory.java`)
- Grouping Strategy → Service Grouping: implemented by (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java`)
- Grouping Strategy → Server Grouping: implemented by (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServerGroupingStrategy.java`)
- Service Grouping → Eureka HTTP Client: fetches apps (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java`)
- Eureka HTTP Client → Eureka Server: requests apps (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaClientHelper.java`)
- Service Grouping → Instance Mapper: maps instances (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java`)
- Instance Mapper → Instance Details: builds details (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/mapper/InstanceMapper.java`)
- Service Grouping → Service Result: builds result (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/strategy/ServiceGroupingStrategy.java`)
- Service Result → Grouped Results: implements (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServiceResult.java`)
- Server Result → Grouped Results: implements (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/ServerResult.java`)
- Query Orchestrator → Query Response: constructs response (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java`)
- Query Response → Grouped Results: wraps data (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/dto/response/EurekaQueryResponse.java`)
- Query Orchestrator → API Exceptions: raises errors (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java`)
- Error Handler → Query Response: formats errors (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/GlobalHandlerException.java`)
- Error Handler → Return Codes: uses codes (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/exception/GlobalHandlerException.java`)
- Transaction Tracking → Query Orchestrator: sets request ID
- Query Orchestrator → Structured Logging: logs timing (evidence: `cdi-eureka-service/src/main/java/com/dafreurekadetails/service/EurekaQueryService.java`)
