# deepti1917/webhook-platform architecture

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

- Interactive diagram: https://gitdiagram.com/deepti1917/webhook-platform
- Repository: https://github.com/deepti1917/webhook-platform

## Overview

Webhook Platform is a multi-tenant event ingestion and reliable webhook delivery service. Admins provision tenants; tenants register protected endpoints, submit idempotent events, and inspect or replay delivery outcomes. The README documents atomic event-and-delivery writes, worker retries, signed HTTP requests, endpoint security, tenant isolation, and delivery history. Relationships below are limited to the shown service calls and README workflow; worker and delivery internals are represented by their exact tree paths where not sampled.

Main entry points: [`src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryWorker.java) (Delivery Worker), [`src/main/java/com/webhookplatform/endpoint/EndpointService.java`](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/EndpointService.java) (Endpoint Service), [`src/main/java/com/webhookplatform/event/EventService.java`](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventService.java) (Event Ingestion), [`src/main/java/com/webhookplatform/delivery/DeliveryService.java`](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryService.java) (Delivery History)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Tenant Administration"]
  node_tenant_api["Tenant API"]
  node_tenant_service["Tenant Service<br/>[TenantService.java]"]
  node_tenant_store[("Tenant Store")]
  node_tenant_entity["Tenant Records<br/>[Tenant.java]"]
end

subgraph group_setup["Endpoint Management"]
  node_endpoint_api["Endpoint API"]
  node_endpoint_service["Endpoint Service"]
  node_endpoint_store[("Endpoint Store")]
  node_endpoint_entity["Endpoint Records"]
end

subgraph group_ingest["Event Ingestion"]
  node_event_api["Event API"]
  node_event_service["Event Ingestion<br/>[EventService.java]"]
  node_event_store[("Event Store")]
  node_event_entity["Event Records<br/>[Event.java]"]
end

subgraph group_delivery["Delivery Lifecycle"]
  node_delivery_store[("Delivery Queue")]
  node_worker["Delivery Worker"]
  node_delivery_api["Delivery API"]
  node_delivery_service["Delivery History"]
  node_attempt_store[("Attempt Store")]
  node_delivery_entity["Delivery Records<br/>[Delivery.java]"]
end

subgraph group_security["Security"]
  node_url_guard["URL Guard<br/>[UrlGuard.java]"]
  node_auth_filter["API Key Auth"]
  node_api_keys["Key Utilities<br/>[ApiKeys.java]"]
  node_signer["HMAC Signer<br/>[HmacSigner.java]"]
  node_cipher["Secret Cipher<br/>[SecretCipher.java]"]
end

node_admin_actor(("Admin"))
node_tenant_actor(("Tenant"))
node_receiver(("Customer Endpoint"))

node_admin_actor -->|"provisions"| node_tenant_api
node_tenant_api -->|"delegates to"| node_tenant_service
node_tenant_service -->|"reads/writes"| node_tenant_store
node_tenant_service -->|"generates keys"| node_api_keys
node_tenant_store -->|"persists"| node_tenant_entity
node_tenant_actor -->|"manages endpoints"| node_endpoint_api
node_endpoint_api -->|"delegates to"| node_endpoint_service
node_endpoint_service -->|"validates URL"| node_url_guard
node_endpoint_service -->|"encrypts secret"| node_cipher
node_endpoint_service -->|"generates secret"| node_api_keys
node_endpoint_service -->|"reads/writes"| node_endpoint_store
node_endpoint_store -->|"persists"| node_endpoint_entity
node_tenant_actor -->|"submits event"| node_event_api
node_event_api -->|"delegates to"| node_event_service
node_event_service -->|"checks/writes"| node_event_store
node_event_service -->|"loads active endpoints"| node_endpoint_store
node_event_service -->|"enqueues deliveries"| node_delivery_store
node_event_store -->|"persists"| node_event_entity
node_delivery_store -->|"persists"| node_delivery_entity
node_worker -->|"claims due work"| node_delivery_store
node_worker -->|"loads endpoint"| node_endpoint_store
node_worker -->|"loads event"| node_event_store
node_worker -->|"signs payload"| node_signer
node_worker -->|"decrypts secret"| node_cipher
node_worker -->|"sends signed POST"| node_receiver
node_worker -->|"records attempts"| node_attempt_store
node_tenant_actor -->|"inspects/replays"| node_delivery_api
node_delivery_api -->|"delegates to"| node_delivery_service
node_delivery_service -->|"reads/requeues"| node_delivery_store
node_delivery_service -->|"loads history"| node_attempt_store
node_delivery_service -->|"checks tenant event"| node_event_store
node_auth_filter -->|"resolves tenant key"| node_tenant_store
node_auth_filter -->|"hashes/checks key"| node_api_keys
node_tenant_api -.->|"manages"| node_tenant_entity

click node_tenant_api "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/AdminTenantController.java"
click node_tenant_service "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/TenantService.java"
click node_tenant_store "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/TenantRepository.java"
click node_endpoint_api "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/EndpointController.java"
click node_endpoint_service "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/EndpointService.java"
click node_endpoint_store "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/WebhookEndpointRepository.java"
click node_url_guard "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/UrlGuard.java"
click node_event_api "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventController.java"
click node_event_service "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventService.java"
click node_event_store "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventRepository.java"
click node_delivery_store "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryRepository.java"
click node_worker "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryWorker.java"
click node_delivery_api "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryController.java"
click node_delivery_service "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryService.java"
click node_attempt_store "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryAttemptRepository.java"
click node_auth_filter "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java"
click node_api_keys "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/ApiKeys.java"
click node_signer "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/HmacSigner.java"
click node_cipher "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/SecretCipher.java"
click node_tenant_entity "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/Tenant.java"
click node_endpoint_entity "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/WebhookEndpoint.java"
click node_event_entity "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/Event.java"
click node_delivery_entity "https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/Delivery.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_tenant_api,node_tenant_service,node_tenant_store,node_tenant_entity toneBlue
class node_endpoint_api,node_endpoint_service,node_endpoint_store,node_endpoint_entity toneAmber
class node_event_api,node_event_service,node_event_store,node_event_entity toneMint
class node_delivery_store,node_worker,node_delivery_api,node_delivery_service,node_attempt_store,node_delivery_entity toneRose
class node_url_guard,node_auth_filter,node_api_keys,node_signer,node_cipher,node_admin_actor,node_tenant_actor,node_receiver toneIndigo
```

## Components

### Tenant Administration

- [Tenant API](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/AdminTenantController.java): `src/main/java/com/webhookplatform/tenant/AdminTenantController.java`
- [Tenant Service](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/TenantService.java): `src/main/java/com/webhookplatform/tenant/TenantService.java`
- [Tenant Store](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/TenantRepository.java): `src/main/java/com/webhookplatform/tenant/TenantRepository.java`
- [Tenant Records](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/tenant/Tenant.java): `src/main/java/com/webhookplatform/tenant/Tenant.java`

### Endpoint Management

- [Endpoint API](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/EndpointController.java): `src/main/java/com/webhookplatform/endpoint/EndpointController.java`
- [Endpoint Service](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/EndpointService.java): `src/main/java/com/webhookplatform/endpoint/EndpointService.java`
- [Endpoint Store](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/WebhookEndpointRepository.java): `src/main/java/com/webhookplatform/endpoint/WebhookEndpointRepository.java`
- [Endpoint Records](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/endpoint/WebhookEndpoint.java): `src/main/java/com/webhookplatform/endpoint/WebhookEndpoint.java`

### Event Ingestion

- [Event API](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventController.java): `src/main/java/com/webhookplatform/event/EventController.java`
- [Event Ingestion](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventService.java): `src/main/java/com/webhookplatform/event/EventService.java`
- [Event Store](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/EventRepository.java): `src/main/java/com/webhookplatform/event/EventRepository.java`
- [Event Records](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/event/Event.java): `src/main/java/com/webhookplatform/event/Event.java`

### Delivery Lifecycle

- [Delivery Queue](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryRepository.java): `src/main/java/com/webhookplatform/delivery/DeliveryRepository.java`
- [Delivery Worker](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryWorker.java): `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`
- [Delivery API](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryController.java): `src/main/java/com/webhookplatform/delivery/DeliveryController.java`
- [Delivery History](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryService.java): `src/main/java/com/webhookplatform/delivery/DeliveryService.java`
- [Attempt Store](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/DeliveryAttemptRepository.java): `src/main/java/com/webhookplatform/delivery/DeliveryAttemptRepository.java`
- [Delivery Records](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/delivery/Delivery.java): `src/main/java/com/webhookplatform/delivery/Delivery.java`

### Security

- [URL Guard](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/UrlGuard.java): `src/main/java/com/webhookplatform/security/UrlGuard.java`
- [API Key Auth](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java): `src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java`
- [Key Utilities](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/ApiKeys.java): `src/main/java/com/webhookplatform/security/ApiKeys.java`
- [HMAC Signer](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/HmacSigner.java): `src/main/java/com/webhookplatform/security/HmacSigner.java`
- [Secret Cipher](https://github.com/deepti1917/webhook-platform/blob/main/src/main/java/com/webhookplatform/security/SecretCipher.java): `src/main/java/com/webhookplatform/security/SecretCipher.java`

### Other components

- **Admin**
- **Tenant**
- **Customer Endpoint**

## Connections

- Admin → Tenant API: provisions
- Tenant API → Tenant Service: delegates to (evidence: `src/main/java/com/webhookplatform/tenant/AdminTenantController.java`)
- Tenant Service → Tenant Store: reads/writes (evidence: `src/main/java/com/webhookplatform/tenant/TenantService.java`)
- Tenant Service → Key Utilities: generates keys (evidence: `src/main/java/com/webhookplatform/tenant/TenantService.java`)
- Tenant Store → Tenant Records: persists (evidence: `src/main/java/com/webhookplatform/tenant/TenantRepository.java`)
- Tenant → Endpoint API: manages endpoints
- Endpoint API → Endpoint Service: delegates to (evidence: `src/main/java/com/webhookplatform/endpoint/EndpointController.java`)
- Endpoint Service → URL Guard: validates URL (evidence: `src/main/java/com/webhookplatform/endpoint/EndpointService.java`)
- Endpoint Service → Secret Cipher: encrypts secret (evidence: `src/main/java/com/webhookplatform/endpoint/EndpointService.java`)
- Endpoint Service → Key Utilities: generates secret (evidence: `src/main/java/com/webhookplatform/endpoint/EndpointService.java`)
- Endpoint Service → Endpoint Store: reads/writes (evidence: `src/main/java/com/webhookplatform/endpoint/EndpointService.java`)
- Endpoint Store → Endpoint Records: persists (evidence: `src/main/java/com/webhookplatform/endpoint/WebhookEndpointRepository.java`)
- Tenant → Event API: submits event
- Event API → Event Ingestion: delegates to (evidence: `src/main/java/com/webhookplatform/event/EventController.java`)
- Event Ingestion → Event Store: checks/writes (evidence: `src/main/java/com/webhookplatform/event/EventService.java`)
- Event Ingestion → Endpoint Store: loads active endpoints (evidence: `src/main/java/com/webhookplatform/event/EventService.java`)
- Event Ingestion → Delivery Queue: enqueues deliveries (evidence: `src/main/java/com/webhookplatform/event/EventService.java`)
- Event Store → Event Records: persists (evidence: `src/main/java/com/webhookplatform/event/EventRepository.java`)
- Delivery Queue → Delivery Records: persists (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryRepository.java`)
- Delivery Worker → Delivery Queue: claims due work (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`)
- Delivery Worker → Endpoint Store: loads endpoint (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`)
- Delivery Worker → Event Store: loads event (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`)
- Delivery Worker → HMAC Signer: signs payload (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`)
- Delivery Worker → Secret Cipher: decrypts secret (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`)
- Delivery Worker → Customer Endpoint: sends signed POST
- Delivery Worker → Attempt Store: records attempts (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryWorker.java`)
- Tenant → Delivery API: inspects/replays
- Delivery API → Delivery History: delegates to (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryController.java`)
- Delivery History → Delivery Queue: reads/requeues (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryService.java`)
- Delivery History → Attempt Store: loads history (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryService.java`)
- Delivery History → Event Store: checks tenant event (evidence: `src/main/java/com/webhookplatform/delivery/DeliveryService.java`)
- API Key Auth → Tenant Store: resolves tenant key (evidence: `src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java`)
- API Key Auth → Key Utilities: hashes/checks key (evidence: `src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java`)
- Tenant API → Tenant Records: manages
