# adrgs/requestrepo architecture

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

- Interactive diagram: https://gitdiagram.com/adrgs/requestrepo
- Repository: https://github.com/adrgs/requestrepo

## Overview

RequestRepo captures HTTP, DNS, SMTP, and TCP activity for per-subdomain sessions, stores request data and user-defined DNS records or HTTP response files in an in-memory cache, and exposes it through a web UI and live updates. The graph preserves the documented protocol, sharing, geolocation, and Auto-TLS capabilities. Backend startup and several routing/storage relationships are supported by excerpts; frontend API wiring and some unsampled feature internals are not shown, so those links are omitted or marked unverified.

Main entry points: [`src/src/http/mod.rs`](https://github.com/adrgs/requestrepo/blob/main/src/src/http/mod.rs) (HTTP server and router), [`src/src/lib.rs`](https://github.com/adrgs/requestrepo/blob/main/src/src/lib.rs) (Service startup), [`src/src/cache/mod.rs`](https://github.com/adrgs/requestrepo/blob/main/src/src/cache/mod.rs) (In-memory LRU cache), [`frontend/src/App.tsx`](https://github.com/adrgs/requestrepo/blob/main/frontend/src/App.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_web_app["Web application<br/>[App.tsx]"]
  node_requests_ui["Request views<br/>[RequestsPage.tsx]"]
  node_dns_ui["DNS settings"]
  node_response_ui["Response editor"]
  node_file_tree["Response file tree<br/>[FileTree.tsx]"]
  node_frontend_api["API client<br/>[client.ts]"]
  node_live_updates["Live request stream<br/>[useWebSocket.ts]"]
  node_frontend_state["UI and session state"]
end

subgraph group_http["HTTP services"]
  node_http_server["HTTP server and router<br/>[mod.rs]"]
  node_request_routes["HTTP capture and files<br/>[routes.rs]"]
  node_api_routes["Session and REST API<br/>[routes_v2.rs]"]
  node_websocket["WebSocket service<br/>[websocket.rs]"]
  node_static_files["Static file serving<br/>[static_files.rs]"]
end

subgraph group_capture["Request capture"]
  node_dns_server["DNS service<br/>[mod.rs]"]
  node_smtp_server["SMTP service<br/>[mod.rs]"]
  node_tcp_server["TCP service<br/>[mod.rs]"]
end

subgraph group_state["Shared state"]
  node_cache[("In-memory LRU cache<br/>[mod.rs]")]
  node_models["Request and response models<br/>[mod.rs]"]
end

subgraph group_security["Security and enrichment"]
  node_cert_manager["ACME certificate manager<br/>[mod.rs]"]
  node_cert_storage["Certificate storage<br/>[storage.rs]"]
  node_tls_manager["TLS manager<br/>[tls.rs]"]
  node_geo_lookup["IP geolocation<br/>[mod.rs]"]
  node_auth["JWT and sharing auth"]
  node_config["Runtime configuration<br/>[config.rs]"]
end

node_browser(("Browser user"))
node_http_clients(("HTTP clients"))
node_dns_clients(("DNS clients"))
node_smtp_clients(("SMTP clients"))
node_tcp_clients(("TCP clients"))
node_runtime["Service startup<br/>[lib.rs]"]

node_browser -->|"uses"| node_web_app
node_browser -.->|"manages sessions"| node_frontend_api
node_browser -.->|"receives updates"| node_live_updates
node_http_clients -->|"sends requests"| node_request_routes
node_dns_clients -->|"queries DNS"| node_dns_server
node_smtp_clients -->|"sends mail"| node_smtp_server
node_tcp_clients -.->|"opens connections"| node_tcp_server
node_web_app -.->|"renders"| node_requests_ui
node_web_app -.->|"renders"| node_dns_ui
node_web_app -.->|"renders"| node_response_ui
node_response_ui -.->|"edits files"| node_file_tree
node_frontend_api -.->|"calls REST API"| node_api_routes
node_live_updates -.->|"streams requests"| node_websocket
node_runtime -->|"starts"| node_dns_server
node_runtime -->|"starts"| node_http_server
node_runtime -->|"starts"| node_smtp_server
node_runtime -->|"starts"| node_tcp_server
node_runtime -->|"initializes"| node_cert_manager
node_http_server -->|"routes to"| node_request_routes
node_http_server -->|"routes to"| node_api_routes
node_http_server -->|"routes to"| node_websocket
node_http_server -->|"serves"| node_static_files
node_request_routes -->|"reads and writes"| node_cache
node_api_routes -->|"reads and writes"| node_cache
node_dns_server -->|"reads records"| node_cache
node_smtp_server -.->|"stores requests"| node_cache
node_tcp_server -.->|"stores requests"| node_cache
node_request_routes -.->|"looks up country"| node_geo_lookup
node_dns_server -.->|"looks up country"| node_geo_lookup
node_smtp_server -.->|"looks up country"| node_geo_lookup
node_tcp_server -.->|"looks up country"| node_geo_lookup
node_cert_manager -->|"loads and saves"| node_cert_storage
node_cert_manager -->|"reloads certificates"| node_tls_manager
node_http_server -.->|"uses TLS"| node_tls_manager

click node_web_app "https://github.com/adrgs/requestrepo/blob/main/frontend/src/App.tsx"
click node_requests_ui "https://github.com/adrgs/requestrepo/blob/main/frontend/src/pages/RequestsPage.tsx"
click node_dns_ui "https://github.com/adrgs/requestrepo/blob/main/frontend/src/pages/DnsSettingsPage.tsx"
click node_response_ui "https://github.com/adrgs/requestrepo/blob/main/frontend/src/pages/ResponseEditorPage.tsx"
click node_file_tree "https://github.com/adrgs/requestrepo/blob/main/frontend/src/components/file-tree/FileTree.tsx"
click node_frontend_api "https://github.com/adrgs/requestrepo/blob/main/frontend/src/api/client.ts"
click node_live_updates "https://github.com/adrgs/requestrepo/blob/main/frontend/src/hooks/useWebSocket.ts"
click node_frontend_state "https://github.com/adrgs/requestrepo/tree/main/frontend/src/stores"
click node_http_server "https://github.com/adrgs/requestrepo/blob/main/src/src/http/mod.rs"
click node_request_routes "https://github.com/adrgs/requestrepo/blob/main/src/src/http/routes.rs"
click node_api_routes "https://github.com/adrgs/requestrepo/blob/main/src/src/http/routes_v2.rs"
click node_websocket "https://github.com/adrgs/requestrepo/blob/main/src/src/http/websocket.rs"
click node_static_files "https://github.com/adrgs/requestrepo/blob/main/src/src/http/static_files.rs"
click node_dns_server "https://github.com/adrgs/requestrepo/blob/main/src/src/dns/mod.rs"
click node_smtp_server "https://github.com/adrgs/requestrepo/blob/main/src/src/smtp/mod.rs"
click node_tcp_server "https://github.com/adrgs/requestrepo/blob/main/src/src/tcp/mod.rs"
click node_cache "https://github.com/adrgs/requestrepo/blob/main/src/src/cache/mod.rs"
click node_models "https://github.com/adrgs/requestrepo/blob/main/src/src/models/mod.rs"
click node_cert_manager "https://github.com/adrgs/requestrepo/blob/main/src/src/certs/mod.rs"
click node_cert_storage "https://github.com/adrgs/requestrepo/blob/main/src/src/certs/storage.rs"
click node_tls_manager "https://github.com/adrgs/requestrepo/blob/main/src/src/certs/tls.rs"
click node_geo_lookup "https://github.com/adrgs/requestrepo/blob/main/src/src/ip2country/mod.rs"
click node_auth "https://github.com/adrgs/requestrepo/tree/main/src/src/utils"
click node_config "https://github.com/adrgs/requestrepo/blob/main/src/src/utils/config.rs"
click node_runtime "https://github.com/adrgs/requestrepo/blob/main/src/src/lib.rs"

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_web_app,node_requests_ui,node_dns_ui,node_response_ui,node_file_tree,node_frontend_api,node_live_updates,node_frontend_state,node_browser,node_http_clients,node_dns_clients,node_smtp_clients,node_tcp_clients toneBlue
class node_http_server,node_request_routes,node_api_routes,node_websocket,node_static_files toneAmber
class node_dns_server,node_smtp_server,node_tcp_server toneMint
class node_cache,node_models toneRose
class node_cert_manager,node_cert_storage,node_tls_manager,node_geo_lookup,node_auth,node_config toneIndigo
class node_runtime toneTeal
```

## Components

### Web interface

- [Web application](https://github.com/adrgs/requestrepo/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Request views](https://github.com/adrgs/requestrepo/blob/main/frontend/src/pages/RequestsPage.tsx): `frontend/src/pages/RequestsPage.tsx`
- [DNS settings](https://github.com/adrgs/requestrepo/blob/main/frontend/src/pages/DnsSettingsPage.tsx): `frontend/src/pages/DnsSettingsPage.tsx`
- [Response editor](https://github.com/adrgs/requestrepo/blob/main/frontend/src/pages/ResponseEditorPage.tsx): `frontend/src/pages/ResponseEditorPage.tsx`
- [Response file tree](https://github.com/adrgs/requestrepo/blob/main/frontend/src/components/file-tree/FileTree.tsx): `frontend/src/components/file-tree/FileTree.tsx`
- [API client](https://github.com/adrgs/requestrepo/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Live request stream](https://github.com/adrgs/requestrepo/blob/main/frontend/src/hooks/useWebSocket.ts): `frontend/src/hooks/useWebSocket.ts`
- [UI and session state](https://github.com/adrgs/requestrepo/tree/main/frontend/src/stores): `frontend/src/stores`

### HTTP services

- [HTTP server and router](https://github.com/adrgs/requestrepo/blob/main/src/src/http/mod.rs): `src/src/http/mod.rs`
- [HTTP capture and files](https://github.com/adrgs/requestrepo/blob/main/src/src/http/routes.rs): `src/src/http/routes.rs`
- [Session and REST API](https://github.com/adrgs/requestrepo/blob/main/src/src/http/routes_v2.rs): `src/src/http/routes_v2.rs`
- [WebSocket service](https://github.com/adrgs/requestrepo/blob/main/src/src/http/websocket.rs): `src/src/http/websocket.rs`
- [Static file serving](https://github.com/adrgs/requestrepo/blob/main/src/src/http/static_files.rs): `src/src/http/static_files.rs`

### Request capture

- [DNS service](https://github.com/adrgs/requestrepo/blob/main/src/src/dns/mod.rs): `src/src/dns/mod.rs`
- [SMTP service](https://github.com/adrgs/requestrepo/blob/main/src/src/smtp/mod.rs): `src/src/smtp/mod.rs`
- [TCP service](https://github.com/adrgs/requestrepo/blob/main/src/src/tcp/mod.rs): `src/src/tcp/mod.rs`

### Shared state

- [In-memory LRU cache](https://github.com/adrgs/requestrepo/blob/main/src/src/cache/mod.rs): `src/src/cache/mod.rs`
- [Request and response models](https://github.com/adrgs/requestrepo/blob/main/src/src/models/mod.rs): `src/src/models/mod.rs`

### Security and enrichment

- [ACME certificate manager](https://github.com/adrgs/requestrepo/blob/main/src/src/certs/mod.rs): `src/src/certs/mod.rs`
- [Certificate storage](https://github.com/adrgs/requestrepo/blob/main/src/src/certs/storage.rs): `src/src/certs/storage.rs`
- [TLS manager](https://github.com/adrgs/requestrepo/blob/main/src/src/certs/tls.rs): `src/src/certs/tls.rs`
- [IP geolocation](https://github.com/adrgs/requestrepo/blob/main/src/src/ip2country/mod.rs): `src/src/ip2country/mod.rs`
- [JWT and sharing auth](https://github.com/adrgs/requestrepo/tree/main/src/src/utils): `src/src/utils`
- [Runtime configuration](https://github.com/adrgs/requestrepo/blob/main/src/src/utils/config.rs): `src/src/utils/config.rs`

### Other components

- **Browser user**
- **HTTP clients**
- **DNS clients**
- **SMTP clients**
- **TCP clients**
- [Service startup](https://github.com/adrgs/requestrepo/blob/main/src/src/lib.rs): `src/src/lib.rs`

## Connections

- Browser user → Web application: uses (evidence: `README.md`)
- Browser user → API client: manages sessions
- Browser user → Live request stream: receives updates
- HTTP clients → HTTP capture and files: sends requests (evidence: `src/src/http/routes.rs`)
- DNS clients → DNS service: queries DNS (evidence: `README.md`)
- SMTP clients → SMTP service: sends mail (evidence: `README.md`)
- TCP clients → TCP service: opens connections
- Web application → Request views: renders
- Web application → DNS settings: renders
- Web application → Response editor: renders
- Response editor → Response file tree: edits files
- API client → Session and REST API: calls REST API
- Live request stream → WebSocket service: streams requests
- Service startup → DNS service: starts (evidence: `src/src/lib.rs`)
- Service startup → HTTP server and router: starts (evidence: `src/src/lib.rs`)
- Service startup → SMTP service: starts (evidence: `src/src/lib.rs`)
- Service startup → TCP service: starts (evidence: `src/src/lib.rs`)
- Service startup → ACME certificate manager: initializes (evidence: `src/src/lib.rs`)
- HTTP server and router → HTTP capture and files: routes to (evidence: `src/src/http/mod.rs`)
- HTTP server and router → Session and REST API: routes to (evidence: `src/src/http/mod.rs`)
- HTTP server and router → WebSocket service: routes to (evidence: `src/src/http/mod.rs`)
- HTTP server and router → Static file serving: serves (evidence: `src/src/http/mod.rs`)
- HTTP capture and files → In-memory LRU cache: reads and writes (evidence: `src/src/http/routes.rs`)
- Session and REST API → In-memory LRU cache: reads and writes (evidence: `src/src/http/routes_v2.rs`)
- DNS service → In-memory LRU cache: reads records (evidence: `src/src/dns/mod.rs`)
- SMTP service → In-memory LRU cache: stores requests (evidence: `src/src/smtp/mod.rs`)
- TCP service → In-memory LRU cache: stores requests (evidence: `src/src/tcp/mod.rs`)
- HTTP capture and files → IP geolocation: looks up country (evidence: `src/src/http/routes.rs`)
- DNS service → IP geolocation: looks up country (evidence: `src/src/dns/mod.rs`)
- SMTP service → IP geolocation: looks up country (evidence: `src/src/smtp/mod.rs`)
- TCP service → IP geolocation: looks up country (evidence: `src/src/tcp/mod.rs`)
- ACME certificate manager → Certificate storage: loads and saves (evidence: `src/src/certs/mod.rs`)
- ACME certificate manager → TLS manager: reloads certificates (evidence: `src/src/certs/mod.rs`)
- HTTP server and router → TLS manager: uses TLS
