Version: 26.02.06 | Java: 25+ | Spring Boot: 3.x | Reactor: 3.x
Firefly Orchestration is a reactive framework for coordinating multi-step business processes in Spring Boot applications. It provides three complementary patterns — Workflow, Saga, and TCC — unified by a shared core layer for persistence, observability, retry, and event integration.
New to Firefly Orchestration? Start with the Tutorial: Fintech Payment Processing — a step-by-step guide that builds a complete fund transfer system using all three patterns.
| Document | Description |
|---|---|
| Part I: Foundations | Introduction, architecture overview, pattern selection guide |
| Part II: Workflow Pattern | Workflow annotations, builder DSL, lifecycle management, signals & timers, execution reporting |
| Part III: Saga Pattern | Saga annotations, builder DSL, compensation policies, fan-out, saga composition |
| Part IV: TCC Pattern | TCC annotations, builder DSL, try/confirm/cancel phases, TCC composition |
| Part V: Core Infrastructure | ExecutionContext, argument injection, retry, events, persistence, DLQ, observability, backpressure, validation, metrics endpoint, event sourcing |
| Part VI: Configuration | Configuration properties, auto-configuration chain, Spring Boot integration |
| Part VII: Recipes & Production | Pattern composition, testing, error handling, production checklist, validation & reporting, event sourcing |
- §4 Workflow Annotation Reference
- §5 Workflow Tutorial
- §6 Workflow Lifecycle Management
- §7 Signals and Timers
- §8 Workflow Builder DSL
- §9 WorkflowEngine API
- §10 Child Workflows
- §11 Search Attributes & Queries
- §12 Execution Reporting for Workflows
- §13 Saga Annotation Reference
- §14 Saga Tutorial
- §15 Saga Compensation Deep Dive
- §16 ExpandEach (Fan-Out)
- §17 Saga Builder DSL
- §18 SagaEngine API
- §19 SagaResult
- §20 Saga Composition
- §21 TCC Annotation Reference
- §22 TCC Tutorial
- §23 TCC Phases & Timeout/Retry
- §24 TCC Builder DSL
- §25 TccEngine API
- §26 TccResult
- §27 TCC Composition
- §28 ExecutionContext
- §29 Argument Injection (Parameter Resolution)
- §30 RetryPolicy
- §31 Event Integration
- §32 Scheduling
- §33 Lifecycle Callbacks
- §34 Persistence
- §35 Dead-Letter Queue
- §36 Recovery Service
- §37 Observability: Events Interface
- §38 Observability: Metrics & Tracing
- §39 Topology & DAG Execution
- §40 REST API
- §41 Backpressure Strategies
- §42 Execution Reporting
- §43 Validation Framework
- §44 Metrics Endpoint
- §45 Event Sourcing
- §49 Recipe: Composing Patterns
- §50 Recipe: Testing Orchestrations
- §51 Recipe: Error Handling
- §52 Recipe: Event-Driven Architecture
- §53 Production Checklist
- §54 Resilience Patterns
- §55 Continue-as-New
- §56 FAQ & Troubleshooting
- §57 Recipe: Validation & Reporting
- §58 Recipe: Event Sourcing
Copyright 2024-2026 Firefly Software Foundation. Licensed under the Apache License, Version 2.0.