# khinya-khinev/api-gateway architecture

> Architecture diagram of the GitHub repository khinya-khinev/api-gateway, 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/khinya-khinev/api-gateway
- Repository: https://github.com/khinya-khinev/api-gateway

## Overview

The API Gateway is the WMS frontend’s single entry point. Its documented request workflow accepts frontend traffic, applies authentication and CORS policy, routes requests to backend services, and relays access tokens; OAuth2 login and logout involve the identity provider, while Redis stores sessions. The sampled code also exposes an authenticated profile endpoint that maps OIDC claims into a response DTO. Routing, token relay, Redis, and route configuration are documented, but their implementation details were not sampled, so those relationships cite the README.

Main entry points: [`src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java`](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java) (Gateway application), [`src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java`](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java) (Security configuration), [`src/main/java/com/waregang/api_gateway/users/api/ProfileController.java`](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/users/api/ProfileController.java) (Profile endpoint), [`src/main/resources/application.yaml`](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/resources/application.yaml) (Routes and OAuth config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_security["Security and identity"]
  node_security_config["Security configuration"]
  node_auth_properties["Auth settings"]
  node_cors_properties["CORS settings"]
end

subgraph group_routing["Gateway routing"]
  node_application["Gateway application"]
  node_gateway_properties["Gateway settings"]
  node_route_config["Routes and OAuth config<br/>[application.yaml]"]
end

subgraph group_profile["User profile"]
  node_profile_controller["Profile endpoint"]
  node_profile_dto["Profile response"]
end

node_frontend(("WMS frontend"))
node_backend_services["Backend services"]
node_identity_provider["Identity provider"]
node_redis[("Redis sessions")]

node_frontend -->|"sends requests"| node_application
node_application -->|"configures security"| node_security_config
node_application -->|"enables properties"| node_auth_properties
node_application -->|"enables properties"| node_cors_properties
node_application -->|"enables properties"| node_gateway_properties
node_security_config -->|"reads settings"| node_auth_properties
node_security_config -->|"reads settings"| node_cors_properties
node_security_config -->|"reads settings"| node_gateway_properties
node_application -.->|"loads configuration"| node_route_config
node_route_config -->|"defines routes"| node_backend_services
node_application -->|"routes requests"| node_backend_services
node_application -->|"starts OAuth2 flow"| node_identity_provider
node_application -->|"relays access tokens"| node_backend_services
node_application -->|"stores sessions"| node_redis
node_frontend -->|"requests profile"| node_profile_controller
node_profile_controller -->|"creates response"| node_profile_dto
node_identity_provider -.->|"provides OIDC principal"| node_profile_controller

click node_application "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java"
click node_security_config "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java"
click node_auth_properties "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/properties/AuthProperties.java"
click node_cors_properties "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/properties/CorsProperties.java"
click node_gateway_properties "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/properties/GatewayProperties.java"
click node_route_config "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/resources/application.yaml"
click node_profile_controller "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/users/api/ProfileController.java"
click node_profile_dto "https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/users/api/UserProfileDto.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_security_config,node_auth_properties,node_cors_properties,node_frontend toneBlue
class node_application,node_gateway_properties,node_route_config,node_redis toneAmber
class node_profile_controller,node_profile_dto toneMint
class node_backend_services,node_identity_provider toneIndigo
```

## Components

### Security and identity

- [Security configuration](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java): `src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java`
- [Auth settings](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/properties/AuthProperties.java): `src/main/java/com/waregang/api_gateway/properties/AuthProperties.java`
- [CORS settings](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/properties/CorsProperties.java): `src/main/java/com/waregang/api_gateway/properties/CorsProperties.java`

### Gateway routing

- [Gateway application](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java): `src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java`
- [Gateway settings](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/properties/GatewayProperties.java): `src/main/java/com/waregang/api_gateway/properties/GatewayProperties.java`
- [Routes and OAuth config](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/resources/application.yaml): `src/main/resources/application.yaml`

### User profile

- [Profile endpoint](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/users/api/ProfileController.java): `src/main/java/com/waregang/api_gateway/users/api/ProfileController.java`
- [Profile response](https://github.com/khinya-khinev/api-gateway/blob/main/src/main/java/com/waregang/api_gateway/users/api/UserProfileDto.java): `src/main/java/com/waregang/api_gateway/users/api/UserProfileDto.java`

### Other components

- **WMS frontend**
- **Backend services**
- **Identity provider**
- **Redis sessions**

## Connections

- WMS frontend → Gateway application: sends requests (evidence: `README.md`)
- Gateway application → Security configuration: configures security (evidence: `src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java`)
- Gateway application → Auth settings: enables properties (evidence: `src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java`)
- Gateway application → CORS settings: enables properties (evidence: `src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java`)
- Gateway application → Gateway settings: enables properties (evidence: `src/main/java/com/waregang/api_gateway/ApiGatewayApplication.java`)
- Security configuration → Auth settings: reads settings (evidence: `src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java`)
- Security configuration → CORS settings: reads settings (evidence: `src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java`)
- Security configuration → Gateway settings: reads settings (evidence: `src/main/java/com/waregang/api_gateway/config/SecurityConfiguration.java`)
- Gateway application → Routes and OAuth config: loads configuration
- Routes and OAuth config → Backend services: defines routes (evidence: `README.md`)
- Gateway application → Backend services: routes requests (evidence: `README.md`)
- Gateway application → Identity provider: starts OAuth2 flow (evidence: `README.md`)
- Gateway application → Backend services: relays access tokens (evidence: `README.md`)
- Gateway application → Redis sessions: stores sessions (evidence: `README.md`)
- WMS frontend → Profile endpoint: requests profile (evidence: `src/main/java/com/waregang/api_gateway/users/api/ProfileController.java`)
- Profile endpoint → Profile response: creates response (evidence: `src/main/java/com/waregang/api_gateway/users/api/ProfileController.java`)
- Identity provider → Profile endpoint: provides OIDC principal
