# siddheshpohare/rajamon-http-extended architecture

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

- Interactive diagram: https://gitdiagram.com/siddheshpohare/rajamon-http-extended
- Repository: https://github.com/siddheshpohare/rajamon-http-extended

## Overview

Rajomon-HTTP places a Go sidecar before a microservice to inspect token headers, estimate local load price, admit and proxy affordable requests, or reject unaffordable requests with 503. The repository also includes the DeathStarBench Social Network benchmark; sampled C++ handlers show compose-post fan-out and data-store handling. README documentation describes fleet-wide metrics and Prometheus/Grafana monitoring, but those configuration files are not in the supplied tree. Some benchmark service links are omitted because their call sites were not sampled.

Main entry points: [`sidecar/main.go`](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/main.go) (Proxy Server), [`benchmark-app/src/ComposePostService/ComposePostHandler.h`](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ComposePostService/ComposePostHandler.h) (Post Composer), [`benchmark-app/src/ClientPool.h`](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ClientPool.h) (Thrift Client Pool), [`benchmark-app/src/WriteHomeTimelineService/WriteHomeTimelineService.cpp`](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/WriteHomeTimelineService/WriteHomeTimelineService.cpp) (Home Timeline Writer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admission["Admission Sidecar"]
  node_sidecar["Proxy Server<br/>[main.go]"]
  node_config["Sidecar Config<br/>[config.go]"]
  node_headers["Token Headers<br/>[headers.go]"]
  node_pricing["Load Pricing<br/>[pricing.go]"]
  node_decision["Admission Decision<br/>[admission.go]"]
  node_metrics["Proxy Metrics<br/>[metrics.go]"]
end

subgraph group_benchmark["Social Network"]
  node_compose["Post Composer"]
  node_user["User Service<br/>[UserHandler.h]"]
  node_media["Media Service<br/>[MediaHandler.h]"]
  node_text["Text Service<br/>[TextHandler.h]"]
  node_unique["ID Service<br/>[UniqueIdHandler.h]"]
  node_usertimeline["User Timeline"]
  node_homewrite["Home Timeline Writer"]
  node_poststorage["Post Storage"]
end

subgraph group_runtime["Shared Runtime"]
  node_datastores[("MongoDB and Cache")]
  node_clientpool["Thrift Client Pool<br/>[ClientPool.h]"]
  node_thrift["Thrift Transport<br/>[ThriftClient.h]"]
end

node_client(("HTTP Client"))
node_prometheus(("Prometheus"))
node_grafana(("Grafana"))

node_client -->|"sends request"| node_sidecar
node_sidecar -->|"loads settings"| node_config
node_sidecar -->|"reads tokens"| node_headers
node_sidecar -->|"gets price"| node_pricing
node_sidecar -->|"decides admission"| node_decision
node_sidecar -->|"proxies request"| node_compose
node_sidecar -->|"records metrics"| node_metrics
node_prometheus -.->|"scrapes metrics"| node_sidecar
node_grafana -.->|"visualizes metrics"| node_prometheus
node_compose -->|"calls"| node_user
node_compose -->|"calls"| node_media
node_compose -->|"calls"| node_unique
node_compose -->|"calls"| node_usertimeline
node_poststorage -->|"reads and writes"| node_datastores
node_compose -->|"uses clients"| node_clientpool
node_clientpool -->|"creates clients"| node_thrift
node_homewrite -->|"uses clients"| node_clientpool

click node_sidecar "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/main.go"
click node_config "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/config.go"
click node_headers "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/headers.go"
click node_pricing "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/pricing.go"
click node_decision "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/admission.go"
click node_metrics "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/metrics.go"
click node_compose "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ComposePostService/ComposePostHandler.h"
click node_user "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/UserService/UserHandler.h"
click node_media "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/MediaService/MediaHandler.h"
click node_text "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/TextService/TextHandler.h"
click node_unique "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/UniqueIdService/UniqueIdHandler.h"
click node_usertimeline "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/UserTimelineService/UserTimelineHandler.h"
click node_homewrite "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/WriteHomeTimelineService/WriteHomeTimelineService.cpp"
click node_poststorage "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/PostStorageService/PostStorageHandler.h"
click node_datastores "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/PostStorageService/PostStorageHandler.h"
click node_clientpool "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ClientPool.h"
click node_thrift "https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ThriftClient.h"

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_sidecar,node_config,node_headers,node_pricing,node_decision,node_metrics,node_client toneBlue
class node_compose,node_user,node_media,node_text,node_unique,node_usertimeline,node_homewrite,node_poststorage toneAmber
class node_datastores,node_clientpool,node_thrift toneMint
class node_prometheus,node_grafana toneIndigo
```

## Components

### Admission Sidecar

- [Proxy Server](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/main.go): `sidecar/main.go`
- [Sidecar Config](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/config.go): `sidecar/config.go`
- [Token Headers](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/headers.go): `sidecar/headers.go`
- [Load Pricing](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/pricing.go): `sidecar/pricing.go`
- [Admission Decision](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/admission.go): `sidecar/admission.go`
- [Proxy Metrics](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/sidecar/metrics.go): `sidecar/metrics.go`

### Social Network

- [Post Composer](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ComposePostService/ComposePostHandler.h): `benchmark-app/src/ComposePostService/ComposePostHandler.h`
- [User Service](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/UserService/UserHandler.h): `benchmark-app/src/UserService/UserHandler.h`
- [Media Service](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/MediaService/MediaHandler.h): `benchmark-app/src/MediaService/MediaHandler.h`
- [Text Service](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/TextService/TextHandler.h): `benchmark-app/src/TextService/TextHandler.h`
- [ID Service](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/UniqueIdService/UniqueIdHandler.h): `benchmark-app/src/UniqueIdService/UniqueIdHandler.h`
- [User Timeline](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/UserTimelineService/UserTimelineHandler.h): `benchmark-app/src/UserTimelineService/UserTimelineHandler.h`
- [Home Timeline Writer](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/WriteHomeTimelineService/WriteHomeTimelineService.cpp): `benchmark-app/src/WriteHomeTimelineService/WriteHomeTimelineService.cpp`
- [Post Storage](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/PostStorageService/PostStorageHandler.h): `benchmark-app/src/PostStorageService/PostStorageHandler.h`

### Shared Runtime

- [MongoDB and Cache](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/PostStorageService/PostStorageHandler.h): `benchmark-app/src/PostStorageService/PostStorageHandler.h`
- [Thrift Client Pool](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ClientPool.h): `benchmark-app/src/ClientPool.h`
- [Thrift Transport](https://github.com/siddheshpohare/rajamon-http-extended/blob/main/benchmark-app/src/ThriftClient.h): `benchmark-app/src/ThriftClient.h`

### Other components

- **HTTP Client**
- **Prometheus**
- **Grafana**

## Connections

- HTTP Client → Proxy Server: sends request (evidence: `README.md`)
- Proxy Server → Sidecar Config: loads settings (evidence: `README.md`)
- Proxy Server → Token Headers: reads tokens (evidence: `README.md`)
- Proxy Server → Load Pricing: gets price (evidence: `README.md`)
- Proxy Server → Admission Decision: decides admission (evidence: `README.md`)
- Proxy Server → Post Composer: proxies request (evidence: `README.md`)
- Proxy Server → Proxy Metrics: records metrics (evidence: `README.md`)
- Prometheus → Proxy Server: scrapes metrics (evidence: `README.md`)
- Grafana → Prometheus: visualizes metrics (evidence: `README.md`)
- Post Composer → User Service: calls (evidence: `benchmark-app/src/ComposePostService/ComposePostHandler.h`)
- Post Composer → Media Service: calls (evidence: `benchmark-app/src/ComposePostService/ComposePostHandler.h`)
- Post Composer → ID Service: calls (evidence: `benchmark-app/src/ComposePostService/ComposePostHandler.h`)
- Post Composer → User Timeline: calls (evidence: `benchmark-app/src/ComposePostService/ComposePostHandler.h`)
- Post Storage → MongoDB and Cache: reads and writes (evidence: `benchmark-app/src/PostStorageService/PostStorageHandler.h`)
- Post Composer → Thrift Client Pool: uses clients (evidence: `benchmark-app/src/ComposePostService/ComposePostHandler.h`)
- Thrift Client Pool → Thrift Transport: creates clients (evidence: `benchmark-app/src/ClientPool.h`)
- Home Timeline Writer → Thrift Client Pool: uses clients (evidence: `benchmark-app/src/WriteHomeTimelineService/WriteHomeTimelineService.cpp`)
