Architecture
Flowbot follows a strict six-layer architecture with a side management plane. See the architecture diagrams for the complete visual reference.
Management Plane
Core Engines
Pipeline Engine
Event-driven automation with retry, checkpointing, and recovery.
Pipeline Templates
Go text/template-based parameter rendering with conditionals and FuncMap.
Workflow Engine
YAML-defined task DAGs with capability, shell, Docker, and SSH actions.
Notifications
Multi-channel notification configuration (Slack, Pushover, ntfy, etc.).
Reference
Configuration
Full server configuration reference and environment variable overrides.
Database
Table categories, migration guide, and backup procedures.
Schema Reference
Complete MySQL table schema with column definitions for 40+ tables.
Developer Guide
Deployment
Binary, Docker, and systemd deployment methods with health checks.
Tracing
OpenTelemetry distributed tracing across HTTP, events, pipeline, and DB.
Recovery
Restart recovery for incomplete pipeline runs and workflow jobs.
Conformance Tests
Standard compliance suite every provider adapter must pass.
Architecture Diagrams
PlantUML source files and rendered PNGs are in docs/architecture/:
- Component Diagram — full system components and their relationships
- Layered Architecture — six-layer stack with dependency rules
- Data Flows — chat message, workflow execution, event pipeline, hub lifecycle
- Deployment — Docker containers, CI/CD, and external services