Tasker Core Architecture
This directory contains architectural reference documentation describing how Tasker Core’s components work together.
Documents
| Document | Description |
|---|---|
| Crate Architecture | Workspace structure and crate responsibilities |
| Messaging Abstraction | Provider-agnostic messaging (PGMQ, RabbitMQ) |
| Actors | Actor-based orchestration lifecycle components |
| Worker Actors | Actor pattern for worker step execution |
| Worker Event Systems | Dual-channel event architecture for workers |
| States and Lifecycles | Dual state machine architecture (Task + Step) |
| Events and Commands | Event-driven coordination patterns |
| Domain Events | Business event publishing (durable/fast/broadcast) |
| Idempotency and Atomicity | Defense-in-depth guarantees |
| Backpressure Architecture | Unified resilience and flow control |
| Circuit Breakers | Fault isolation and cascade prevention |
| Deployment Patterns | Hybrid, EventDriven, PollingOnly modes; PGMQ/RabbitMQ backends |
When to Read These
- Designing new features: Understand how components interact
- Debugging flow issues: Trace message paths through actors
- Understanding trade-offs: See why patterns were chosen
- Onboarding: Build mental model of the system
Related Documentation
- Principles - The “why” behind architectural decisions
- Guides - Practical “how-to” documentation
- CHRONOLOGY - Historical context for decisions