# kgma74/webhook-tester architecture

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

## Overview

webhook-tester is a self-hosted HTTP webhook inspector. Users create an isolated endpoint, send requests to its hook URL, then inspect captures live or through the JSON API; they can also clear history, replay a capture, and configure the hook’s response. The graph separates HTTP entry points, endpoint lifecycle, capture/state, and dashboard delivery. README documents dashboard capabilities beyond the sampled templates; edges are limited to relationships explicit in the README or excerpts.

Main entry points: [`internal/server/webhooks.go`](https://github.com/kgma74/webhook-tester/blob/main/internal/server/webhooks.go) (HTTP handlers), [`internal/server/server.go`](https://github.com/kgma74/webhook-tester/blob/main/internal/server/server.go) (HTTP server), [`internal/server/endpoint.go`](https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go) (Endpoint state), [`internal/server/sse.go`](https://github.com/kgma74/webhook-tester/blob/main/internal/server/sse.go) (SSE broker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP interface"]
  node_main["Application startup<br/>[main.go]"]
  node_server["HTTP server<br/>[server.go]"]
  node_routes["Route registration<br/>[routes.go]"]
  node_handlers["HTTP handlers<br/>[webhooks.go]"]
  node_templates["Embedded templates<br/>[web.go]"]
end

subgraph group_endpoints["Endpoint lifecycle"]
  node_registry["Endpoint registry<br/>[endpoint.go]"]
  node_endpoint["Endpoint state<br/>[endpoint.go]"]
end

subgraph group_capture["Capture and response"]
  node_store[("Request history<br/>[webhooks.go]")]
  node_response["Response settings<br/>[endpoint.go]"]
end

subgraph group_live["Live dashboard"]
  node_broker["SSE broker<br/>[sse.go]"]
  node_dashboard["Dashboard views<br/>[index.html]"]
  node_home["Home view<br/>[home.html]"]
end

node_user(("Dashboard user"))
node_sender(("Webhook sender"))

node_user -.->|"opens UI"| node_server
node_sender -.->|"sends webhook"| node_handlers
node_main -->|"constructs"| node_server
node_main -->|"provides templates"| node_templates
node_server -->|"registers routes"| node_routes
node_server -->|"creates registry"| node_registry
node_server -->|"parses templates"| node_templates
node_routes -->|"routes requests"| node_handlers
node_handlers -->|"creates and looks up"| node_registry
node_registry -->|"creates endpoints"| node_endpoint
node_handlers -->|"captures and reads"| node_store
node_handlers -->|"publishes and subscribes"| node_broker
node_handlers -->|"gets and sets config"| node_response
node_endpoint -->|"owns"| node_store
node_endpoint -->|"owns"| node_broker
node_user -.->|"creates endpoints"| node_handlers
node_user -.->|"clears or replays"| node_handlers
node_handlers -->|"replays to hook"| node_handlers
node_handlers -.->|"serves dashboard"| node_dashboard
node_handlers -.->|"serves home"| node_home
node_user -.->|"receives live events"| node_broker

click node_main "https://github.com/kgma74/webhook-tester/blob/main/cmd/api/main.go"
click node_server "https://github.com/kgma74/webhook-tester/blob/main/internal/server/server.go"
click node_routes "https://github.com/kgma74/webhook-tester/blob/main/internal/server/routes.go"
click node_handlers "https://github.com/kgma74/webhook-tester/blob/main/internal/server/webhooks.go"
click node_templates "https://github.com/kgma74/webhook-tester/blob/main/cmd/web/web.go"
click node_registry "https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go"
click node_endpoint "https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go"
click node_store "https://github.com/kgma74/webhook-tester/blob/main/internal/server/webhooks.go"
click node_response "https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go"
click node_broker "https://github.com/kgma74/webhook-tester/blob/main/internal/server/sse.go"
click node_dashboard "https://github.com/kgma74/webhook-tester/blob/main/cmd/web/template/index.html"
click node_home "https://github.com/kgma74/webhook-tester/blob/main/cmd/web/template/home.html"

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_server,node_routes,node_handlers,node_templates,node_user toneBlue
class node_registry,node_endpoint toneAmber
class node_store,node_response,node_sender toneMint
class node_broker,node_dashboard,node_home toneRose
```

## Components

### HTTP interface

- [Application startup](https://github.com/kgma74/webhook-tester/blob/main/cmd/api/main.go): `cmd/api/main.go`
- [HTTP server](https://github.com/kgma74/webhook-tester/blob/main/internal/server/server.go): `internal/server/server.go`
- [Route registration](https://github.com/kgma74/webhook-tester/blob/main/internal/server/routes.go): `internal/server/routes.go`
- [HTTP handlers](https://github.com/kgma74/webhook-tester/blob/main/internal/server/webhooks.go): `internal/server/webhooks.go`
- [Embedded templates](https://github.com/kgma74/webhook-tester/blob/main/cmd/web/web.go): `cmd/web/web.go`

### Endpoint lifecycle

- [Endpoint registry](https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go): `internal/server/endpoint.go`
- [Endpoint state](https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go): `internal/server/endpoint.go`

### Capture and response

- [Request history](https://github.com/kgma74/webhook-tester/blob/main/internal/server/webhooks.go): `internal/server/webhooks.go`
- [Response settings](https://github.com/kgma74/webhook-tester/blob/main/internal/server/endpoint.go): `internal/server/endpoint.go`

### Live dashboard

- [SSE broker](https://github.com/kgma74/webhook-tester/blob/main/internal/server/sse.go): `internal/server/sse.go`
- [Dashboard views](https://github.com/kgma74/webhook-tester/blob/main/cmd/web/template/index.html): `cmd/web/template/index.html`
- [Home view](https://github.com/kgma74/webhook-tester/blob/main/cmd/web/template/home.html): `cmd/web/template/home.html`

### Other components

- **Dashboard user**
- **Webhook sender**

## Connections

- Dashboard user → HTTP server: opens UI (evidence: `README.md`)
- Webhook sender → HTTP handlers: sends webhook (evidence: `README.md`)
- Application startup → HTTP server: constructs (evidence: `cmd/api/main.go`)
- Application startup → Embedded templates: provides templates (evidence: `cmd/api/main.go`)
- HTTP server → Route registration: registers routes (evidence: `internal/server/server.go`)
- HTTP server → Endpoint registry: creates registry (evidence: `internal/server/server.go`)
- HTTP server → Embedded templates: parses templates (evidence: `internal/server/server.go`)
- Route registration → HTTP handlers: routes requests (evidence: `internal/server/routes.go`)
- HTTP handlers → Endpoint registry: creates and looks up (evidence: `internal/server/webhooks.go`)
- Endpoint registry → Endpoint state: creates endpoints (evidence: `internal/server/endpoint.go`)
- HTTP handlers → Request history: captures and reads (evidence: `internal/server/webhooks.go`)
- HTTP handlers → SSE broker: publishes and subscribes (evidence: `internal/server/webhooks.go`)
- HTTP handlers → Response settings: gets and sets config (evidence: `internal/server/webhooks.go`)
- Endpoint state → Request history: owns (evidence: `internal/server/endpoint.go`)
- Endpoint state → SSE broker: owns (evidence: `internal/server/endpoint.go`)
- Dashboard user → HTTP handlers: creates endpoints (evidence: `README.md`)
- Dashboard user → HTTP handlers: clears or replays (evidence: `README.md`)
- HTTP handlers → HTTP handlers: replays to hook (evidence: `internal/server/webhooks.go`)
- HTTP handlers → Dashboard views: serves dashboard (evidence: `README.md`)
- HTTP handlers → Home view: serves home (evidence: `README.md`)
- Dashboard user → SSE broker: receives live events (evidence: `README.md`)
