How deepti1917/webhook-platform works
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: DeliveryWorker.java Delivery Worker · EndpointService.java Endpoint Service · EventService.java Event Ingestion · DeliveryService.java Delivery History
Components 26
Tenant Administration
- Tenant API
src/main/java/com/webhookplatform/tenant/AdminTenantController.java - Tenant Service
src/main/java/com/webhookplatform/tenant/TenantService.java - Tenant Store
src/main/java/com/webhookplatform/tenant/TenantRepository.java - Tenant Records
src/main/java/com/webhookplatform/tenant/Tenant.java
Endpoint Management
- Endpoint API
src/main/java/com/webhookplatform/endpoint/EndpointController.java - Endpoint Service
src/main/java/com/webhookplatform/endpoint/EndpointService.java - Endpoint Store
src/main/java/com/webhookplatform/endpoint/WebhookEndpointRepository.java - Endpoint Records
src/main/java/com/webhookplatform/endpoint/WebhookEndpoint.java
Event Ingestion
- Event API
src/main/java/com/webhookplatform/event/EventController.java - Event Ingestion
src/main/java/com/webhookplatform/event/EventService.java - Event Store
src/main/java/com/webhookplatform/event/EventRepository.java - Event Records
src/main/java/com/webhookplatform/event/Event.java
Delivery Lifecycle
- Delivery Queue
src/main/java/com/webhookplatform/delivery/DeliveryRepository.java - Delivery Worker
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Delivery API
src/main/java/com/webhookplatform/delivery/DeliveryController.java - Delivery History
src/main/java/com/webhookplatform/delivery/DeliveryService.java - Attempt Store
src/main/java/com/webhookplatform/delivery/DeliveryAttemptRepository.java - Delivery Records
src/main/java/com/webhookplatform/delivery/Delivery.java
Security
- URL Guard
src/main/java/com/webhookplatform/security/UrlGuard.java - API Key Auth
src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java - Key Utilities
src/main/java/com/webhookplatform/security/ApiKeys.java - HMAC Signer
src/main/java/com/webhookplatform/security/HmacSigner.java - Secret Cipher
src/main/java/com/webhookplatform/security/SecretCipher.java
Other components
- Admin
- Tenant
- Customer Endpoint
Connections 34
- Admin → Tenant API: provisions
- Tenant API → Tenant Service: delegates to
src/main/java/com/webhookplatform/tenant/AdminTenantController.java - Tenant Service → Tenant Store: reads/writes
src/main/java/com/webhookplatform/tenant/TenantService.java - Tenant Service → Key Utilities: generates keys
src/main/java/com/webhookplatform/tenant/TenantService.java - Tenant Store → Tenant Records: persists
src/main/java/com/webhookplatform/tenant/TenantRepository.java - Tenant → Endpoint API: manages endpoints
- Endpoint API → Endpoint Service: delegates to
src/main/java/com/webhookplatform/endpoint/EndpointController.java - Endpoint Service → URL Guard: validates URL
src/main/java/com/webhookplatform/endpoint/EndpointService.java - Endpoint Service → Secret Cipher: encrypts secret
src/main/java/com/webhookplatform/endpoint/EndpointService.java - Endpoint Service → Key Utilities: generates secret
src/main/java/com/webhookplatform/endpoint/EndpointService.java - Endpoint Service → Endpoint Store: reads/writes
src/main/java/com/webhookplatform/endpoint/EndpointService.java - Endpoint Store → Endpoint Records: persists
src/main/java/com/webhookplatform/endpoint/WebhookEndpointRepository.java - Tenant → Event API: submits event
- Event API → Event Ingestion: delegates to
src/main/java/com/webhookplatform/event/EventController.java - Event Ingestion → Event Store: checks/writes
src/main/java/com/webhookplatform/event/EventService.java - Event Ingestion → Endpoint Store: loads active endpoints
src/main/java/com/webhookplatform/event/EventService.java - Event Ingestion → Delivery Queue: enqueues deliveries
src/main/java/com/webhookplatform/event/EventService.java - Event Store → Event Records: persists
src/main/java/com/webhookplatform/event/EventRepository.java - Delivery Queue → Delivery Records: persists
src/main/java/com/webhookplatform/delivery/DeliveryRepository.java - Delivery Worker → Delivery Queue: claims due work
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Delivery Worker → Endpoint Store: loads endpoint
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Delivery Worker → Event Store: loads event
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Delivery Worker → HMAC Signer: signs payload
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Delivery Worker → Secret Cipher: decrypts secret
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Delivery Worker → Customer Endpoint: sends signed POST
- Delivery Worker → Attempt Store: records attempts
src/main/java/com/webhookplatform/delivery/DeliveryWorker.java - Tenant → Delivery API: inspects/replays
- Delivery API → Delivery History: delegates to
src/main/java/com/webhookplatform/delivery/DeliveryController.java - Delivery History → Delivery Queue: reads/requeues
src/main/java/com/webhookplatform/delivery/DeliveryService.java - Delivery History → Attempt Store: loads history
src/main/java/com/webhookplatform/delivery/DeliveryService.java - Delivery History → Event Store: checks tenant event
src/main/java/com/webhookplatform/delivery/DeliveryService.java - API Key Auth → Tenant Store: resolves tenant key
src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java - API Key Auth → Key Utilities: hashes/checks key
src/main/java/com/webhookplatform/security/ApiKeyAuthFilter.java - Tenant API → Tenant Records: manages