How ishatalwaria/eventflow-ai works
EventFlow AI accepts tenant events, creates workflow state and an outbox record transactionally, then routes work through broker-backed workflow stages with retries and compensation. Operators use the React console to explore events, workflows, commerce, incidents, analytics, health, and settings. The README documents the dual-broker delivery and ClickHouse lifecycle analytics; source-index references and excerpts support selected implementation links. Several subsystems were not sampled, so their internal call paths are not expanded.
Main entry points: features Operations Features · services.py Event Acceptance · engine.py Saga Engine · processing Broker Delivery
Components 19
Event Ingestion
- Event API
apps/events/views.py - Event Acceptance
apps/events/services.py - Events
apps/events/models.py
Workflow Runtime
- Transactional Outbox
apps/processing/outbox.py - Broker Delivery
apps/processing - Workflow State
apps/workflows/models.py - Saga Engine
apps/processing/saga/engine.py - Saga Definitions
apps/processing/saga/definitions.py
Operations Intelligence
- Lifecycle Analytics
apps/analytics - Incident Assistant
apps/incidents/service.py - Health Observability
apps/common/observability.py
Commerce Domain
- Commerce Stages
apps/commerce/stages/fulfillment.py - Orders Inventory Payments
apps/commerce/models.py
Web Console
- Console Routes
frontend/src/App.tsx - API Client
frontend/src/api/client.ts - Operations Features
frontend/src/features - Authentication Management
frontend/src/features/settings/SettingsPage.tsx
Other components
- Operator
- Service Client
Connections 20
- Service Client → Event API: submits events
- Event API → Event Acceptance: accepts events
- Event Acceptance → Events: creates events
apps/events/services.py - Event Acceptance → Workflow State: creates workflow
apps/events/services.py - Event Acceptance → Transactional Outbox: records outbox
apps/events/services.py - Transactional Outbox → Broker Delivery: publishes messages
- Broker Delivery → Saga Engine: dispatches tasks
apps/processing/saga/engine.py - Saga Engine → Workflow State: updates state
apps/processing/saga/engine.py - Saga Engine → Saga Definitions: selects definition
apps/processing/saga/engine.py - Saga Engine → Commerce Stages: gets handler
apps/processing/saga/engine.py - Commerce Stages → Orders Inventory Payments: updates commerce
apps/commerce/stages/fulfillment.py - Broker Delivery → Lifecycle Analytics: streams lifecycle
- Operator → Console Routes: uses console
- Console Routes → Operations Features: routes to
frontend/src/App.tsx - Operations Features → API Client: requests data
- API Client → Event API: calls API
- Operations Features → Lifecycle Analytics: views analytics
- Operations Features → Incident Assistant: investigates incidents
- Operations Features → Health Observability: views health
- Operations Features → Authentication Management: manages credentials