# sumitverma77/infra-pilot-api architecture

> Architecture diagram of the GitHub repository sumitverma77/infra-pilot-api, 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/sumitverma77/infra-pilot-api
- Repository: https://github.com/sumitverma77/infra-pilot-api

## Overview

InfraPilot is a Spring Boot operational API rather than a substantive CI/CD platform runtime: its implemented workflow accepts HTTP requests, routes platform endpoints through a service, and returns health, version, info, or disabled cache/database test responses. The README documents delivery automation, but those workflows are intentionally excluded as deployment machinery. Source excerpts establish controller-to-service calls and service dependencies; the main class and configuration support application startup, while wiring beyond the shown code is not expanded.

Main entry points: [`src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java) (Platform service), [`src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java) (Platform endpoints), [`src/main/java/com/sumitverma/infrapilot/dto/HealthResponse.java`](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/HealthResponse.java) (Health status), [`src/main/java/com/sumitverma/infrapilot/dto/VersionResponse.java`](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/VersionResponse.java) (Version data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["Platform endpoints"]
  node_errors["Error responses"]
end

subgraph group_platform["Platform services"]
  node_service["Platform service"]
  node_contract["Service contract"]
  node_health["Health status"]
  node_version["Version data"]
  node_info["Runtime info<br/>[InfoResponse.java]"]
  node_cache["Cache test result"]
  node_dbtest["DB test result"]
end

subgraph group_runtime["Runtime support"]
  node_application["Spring application"]
  node_metadata["App metadata"]
  node_correlation["Correlation filter"]
end

node_client(("API client"))
node_actuator["Actuator health"]
node_availability["App availability"]
node_environment["Spring environment"]

node_client -->|"requests"| node_controller
node_controller -->|"invokes"| node_service
node_service -->|"implements"| node_contract
node_service -->|"returns"| node_health
node_service -->|"returns"| node_version
node_service -->|"returns"| node_info
node_service -->|"returns"| node_cache
node_service -->|"returns"| node_dbtest
node_service -->|"reads"| node_metadata
node_service -->|"queries"| node_actuator
node_service -->|"reads"| node_availability
node_service -->|"reads"| node_environment
node_controller -->|"responds"| node_health
node_controller -->|"responds"| node_version
node_controller -->|"responds"| node_info
node_controller -->|"responds"| node_cache
node_controller -->|"responds"| node_dbtest
node_application -.->|"serves"| node_controller
node_client -.->|"gets errors"| node_errors
node_correlation -->|"sets response ID"| node_client

click node_application "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/InfraPilotApplication.java"
click node_controller "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java"
click node_service "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java"
click node_contract "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/service/PlatformService.java"
click node_health "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/HealthResponse.java"
click node_version "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/VersionResponse.java"
click node_info "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/InfoResponse.java"
click node_cache "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/CacheTestResponse.java"
click node_dbtest "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/DbTestResponse.java"
click node_metadata "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/config/ApplicationMetadataProperties.java"
click node_correlation "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/config/CorrelationIdFilter.java"
click node_errors "https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/exception/GlobalExceptionHandler.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_errors,node_client toneBlue
class node_service,node_contract,node_health,node_version,node_info,node_cache,node_dbtest toneAmber
class node_application,node_metadata,node_correlation toneMint
class node_actuator,node_availability,node_environment toneIndigo
```

## Components

### HTTP API

- [Platform endpoints](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java): `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`
- [Error responses](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/exception/GlobalExceptionHandler.java): `src/main/java/com/sumitverma/infrapilot/exception/GlobalExceptionHandler.java`

### Platform services

- [Platform service](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java): `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`
- [Service contract](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/service/PlatformService.java): `src/main/java/com/sumitverma/infrapilot/service/PlatformService.java`
- [Health status](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/HealthResponse.java): `src/main/java/com/sumitverma/infrapilot/dto/HealthResponse.java`
- [Version data](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/VersionResponse.java): `src/main/java/com/sumitverma/infrapilot/dto/VersionResponse.java`
- [Runtime info](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/InfoResponse.java): `src/main/java/com/sumitverma/infrapilot/dto/InfoResponse.java`
- [Cache test result](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/CacheTestResponse.java): `src/main/java/com/sumitverma/infrapilot/dto/CacheTestResponse.java`
- [DB test result](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/dto/DbTestResponse.java): `src/main/java/com/sumitverma/infrapilot/dto/DbTestResponse.java`

### Runtime support

- [Spring application](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/InfraPilotApplication.java): `src/main/java/com/sumitverma/infrapilot/InfraPilotApplication.java`
- [App metadata](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/config/ApplicationMetadataProperties.java): `src/main/java/com/sumitverma/infrapilot/config/ApplicationMetadataProperties.java`
- [Correlation filter](https://github.com/sumitverma77/infra-pilot-api/blob/main/src/main/java/com/sumitverma/infrapilot/config/CorrelationIdFilter.java): `src/main/java/com/sumitverma/infrapilot/config/CorrelationIdFilter.java`

### Other components

- **API client**
- **Actuator health**
- **App availability**
- **Spring environment**

## Connections

- API client → Platform endpoints: requests (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Platform endpoints → Platform service: invokes (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Platform service → Service contract: implements (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → Health status: returns (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → Version data: returns (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → Runtime info: returns (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → Cache test result: returns (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → DB test result: returns (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → App metadata: reads (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → Actuator health: queries (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → App availability: reads (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform service → Spring environment: reads (evidence: `src/main/java/com/sumitverma/infrapilot/service/DefaultPlatformService.java`)
- Platform endpoints → Health status: responds (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Platform endpoints → Version data: responds (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Platform endpoints → Runtime info: responds (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Platform endpoints → Cache test result: responds (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Platform endpoints → DB test result: responds (evidence: `src/main/java/com/sumitverma/infrapilot/controller/PlatformController.java`)
- Spring application → Platform endpoints: serves
- API client → Error responses: gets errors
- Correlation filter → API client: sets response ID (evidence: `src/main/java/com/sumitverma/infrapilot/config/CorrelationIdFilter.java`)
