How koto7-io/koto7-tuma works
Tuma durably accepts provider webhooks, verifies source signatures, persists events, then dispatches Temporal delivery workflows that retry destination requests and expose exhausted failures for replay. Operators manage connections, issues, metrics, alerting, settings, and a simulated playground through the React console. The excerpts establish the inbound persistence and workflow dispatch; several backend capabilities are supported by README descriptions and indexed references, but their detailed handlers were not sampled.
Main entry points: server.go HTTP API · store.go Event and connection store · pages Management pages · api.ts Browser API client
Components 22
Webhook intake
- HTTP API
internal/api/server.go - Source adapters
internal/adapters/adapters.go - Event and connection store
internal/storage/store.go
Delivery operations
- Retry workflow
internal/workflow/delivery.go - Issues and metrics
internal/storage/stats.go
Operator console
- Console routing
web/src/App.tsx - Management pages
web/src/pages - Browser API client
web/src/lib/api.ts - Shared console UI
web/src/components
Alerting and settings
- Alert evaluator
internal/alerting/evaluator.go - Notification settings
internal/notifysettings/settings.go - Email and Slack
internal/notification/service.go
Playground
- Playground UI
web/src/pages/PlaygroundPage.tsx - Playground API
internal/api/playground.go - Event simulation
internal/playground/simulate.go
Other components
- Webhook provider
- Postgres
- Temporal
- Destination app
- Console operator
- SMTP service
- Slack
Connections 24
- Webhook provider → HTTP API: posts webhook
- HTTP API → Source adapters: verifies signature
internal/api/server.go - HTTP API → Event and connection store: persists event
internal/api/server.go - Event and connection store → Postgres: stores durably
- HTTP API → Temporal: starts workflow
internal/api/server.go - Temporal → Retry workflow: dispatches workflow
- Retry workflow → Destination app: delivers with retries
- Retry workflow → Event and connection store: records outcomes
internal/workflow/delivery.go - Console operator → Console routing: uses console
web/src/App.tsx - Console routing → Management pages: routes to
web/src/App.tsx - Management pages → Browser API client: requests data
web/src/pages/ConnectionsPage.tsx - Browser API client → HTTP API: calls endpoints
web/src/lib/api.ts - Management pages → Shared console UI: renders
web/src/pages/ConnectionsPage.tsx - Management pages → Issues and metrics: shows issues and metrics
- Alert evaluator → Event and connection store: reads delivery state
internal/alerting/evaluator.go - Alert evaluator → Email and Slack: sends alerts
internal/alerting/evaluator.go - Notification settings → Event and connection store: loads saved settings
internal/notifysettings/settings.go - Notification settings → Email and Slack: provides effective config
internal/notifysettings/settings.go - Email and Slack → SMTP service: sends email
- Email and Slack → Slack: sends direct messages
- Console operator → Playground UI: runs demo
- Playground UI → Browser API client: controls simulation
web/src/lib/api.ts - Browser API client → Playground API: calls demo endpoints
web/src/lib/api.ts - Playground API → Event simulation: simulates events
internal/api/playground.go