# goldenberry274/load_balancer_reverse_proxy_cpp architecture

> Architecture diagram of the GitHub repository goldenberry274/load_balancer_reverse_proxy_cpp, 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/goldenberry274/load_balancer_reverse_proxy_cpp
- Repository: https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp

## Overview

This is a multithreaded C++ TCP reverse proxy and load balancer. The principal workflow is YAML configuration loading, client connection acceptance, worker-pool dispatch, HTTP request parsing, backend selection, and bidirectional proxying. Separate health checks update backend availability; the server also serves human-readable status and Prometheus metrics. The graph reflects README-documented capabilities and shown source references; unsampled implementation details and their internal wiring are not assumed.

Main entry points: [`src/core/Server.cpp`](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/core/Server.cpp) (TCP proxy server), [`src/main.cpp`](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/main.cpp) (Application entry), [`src/health/HealthChecker.cpp`](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/health/HealthChecker.cpp) (Health checker), [`include/balancer/Backend.hpp`](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/include/balancer/Backend.hpp) (Backend state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Proxy runtime"]
  node_main["Application entry<br/>[main.cpp]"]
  node_config["YAML configuration<br/>[config.cpp]"]
  node_server["TCP proxy server<br/>[Server.cpp]"]
  node_pool["Worker pool<br/>[ThreadPool.cpp]"]
  node_parser["HTTP parser<br/>[HttpParser.cpp]"]
  node_request["HTTP request model<br/>[HttpRequest.hpp]"]
end

subgraph group_routing["Backend routing"]
  node_balancer["Round-robin balancer"]
  node_weighted["Weighted balancer"]
  node_backend["Backend state<br/>[Backend.hpp]"]
end

subgraph group_operations["Operations"]
  node_health["Health checker<br/>[HealthChecker.cpp]"]
end

subgraph group_telemetry["Observability"]
  node_metrics["Runtime metrics<br/>[Metrics.cpp]"]
  node_logger["Structured logger<br/>[Logger.cpp]"]
end

node_operator(("Operator"))
node_client(("HTTP clients"))
node_backend_servers(("Backend servers"))
node_prometheus(("Prometheus"))

node_operator -->|"starts"| node_main
node_main -->|"loads settings"| node_config
node_main -->|"starts"| node_server
node_client -->|"sends requests"| node_server
node_server -->|"dispatches clients"| node_pool
node_pool -->|"runs handler"| node_server
node_server -->|"parses request"| node_parser
node_parser -->|"creates model"| node_request
node_server -->|"selects backend"| node_balancer
node_balancer -->|"selects from"| node_backend
node_server -->|"proxies traffic"| node_backend_servers
node_health -->|"checks availability"| node_backend_servers
node_health -->|"updates health"| node_backend
node_server -->|"starts checks"| node_health
node_server -->|"records requests"| node_metrics
node_server -->|"logs events"| node_logger
node_client -->|"requests status"| node_server
node_server -->|"returns status"| node_client
node_client -->|"scrapes metrics"| node_server
node_server -->|"exposes metrics"| node_prometheus
node_weighted -.->|"uses backend state"| node_backend

click node_main "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/main.cpp"
click node_config "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/config/config.cpp"
click node_server "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/core/Server.cpp"
click node_pool "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/core/ThreadPool.cpp"
click node_parser "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/proxy/HttpParser.cpp"
click node_request "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/include/proxy/HttpRequest.hpp"
click node_balancer "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/balancer/RoundRobinBalancer.cpp"
click node_weighted "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/balancer/WeightedBalancer.cpp"
click node_backend "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/include/balancer/Backend.hpp"
click node_health "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/health/HealthChecker.cpp"
click node_metrics "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/observability/Metrics.cpp"
click node_logger "https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/observability/Logger.cpp"

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_main,node_config,node_server,node_pool,node_parser,node_request,node_client toneBlue
class node_balancer,node_weighted,node_backend toneAmber
class node_health,node_backend_servers toneMint
class node_metrics,node_logger toneRose
class node_operator,node_prometheus toneIndigo
```

## Components

### Proxy runtime

- [Application entry](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/main.cpp): `src/main.cpp`
- [YAML configuration](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/config/config.cpp): `src/config/config.cpp`
- [TCP proxy server](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/core/Server.cpp): `src/core/Server.cpp`
- [Worker pool](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/core/ThreadPool.cpp): `src/core/ThreadPool.cpp`
- [HTTP parser](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/proxy/HttpParser.cpp): `src/proxy/HttpParser.cpp`
- [HTTP request model](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/include/proxy/HttpRequest.hpp): `include/proxy/HttpRequest.hpp`

### Backend routing

- [Round-robin balancer](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/balancer/RoundRobinBalancer.cpp): `src/balancer/RoundRobinBalancer.cpp`
- [Weighted balancer](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/balancer/WeightedBalancer.cpp): `src/balancer/WeightedBalancer.cpp`
- [Backend state](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/include/balancer/Backend.hpp): `include/balancer/Backend.hpp`

### Operations

- [Health checker](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/health/HealthChecker.cpp): `src/health/HealthChecker.cpp`

### Observability

- [Runtime metrics](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/observability/Metrics.cpp): `src/observability/Metrics.cpp`
- [Structured logger](https://github.com/goldenberry274/load_balancer_reverse_proxy_cpp/blob/main/src/observability/Logger.cpp): `src/observability/Logger.cpp`

### Other components

- **Operator**
- **HTTP clients**
- **Backend servers**
- **Prometheus**

## Connections

- Operator → Application entry: starts (evidence: `README.md`)
- Application entry → YAML configuration: loads settings (evidence: `src/main.cpp`)
- Application entry → TCP proxy server: starts (evidence: `src/main.cpp`)
- HTTP clients → TCP proxy server: sends requests (evidence: `README.md`)
- TCP proxy server → Worker pool: dispatches clients (evidence: `src/core/Server.cpp`)
- Worker pool → TCP proxy server: runs handler (evidence: `README.md`)
- TCP proxy server → HTTP parser: parses request (evidence: `src/core/Server.cpp`)
- HTTP parser → HTTP request model: creates model
- TCP proxy server → Round-robin balancer: selects backend (evidence: `README.md`)
- Round-robin balancer → Backend state: selects from
- TCP proxy server → Backend servers: proxies traffic (evidence: `src/core/Server.cpp`)
- Health checker → Backend servers: checks availability (evidence: `README.md`)
- Health checker → Backend state: updates health (evidence: `README.md`)
- TCP proxy server → Health checker: starts checks (evidence: `src/core/Server.cpp`)
- TCP proxy server → Runtime metrics: records requests (evidence: `src/core/Server.cpp`)
- TCP proxy server → Structured logger: logs events (evidence: `src/core/Server.cpp`)
- HTTP clients → TCP proxy server: requests status (evidence: `README.md`)
- TCP proxy server → HTTP clients: returns status (evidence: `README.md`)
- HTTP clients → TCP proxy server: scrapes metrics (evidence: `README.md`)
- TCP proxy server → Prometheus: exposes metrics (evidence: `README.md`)
- Weighted balancer → Backend state: uses backend state
