Firefly Framework - Transactional Engine

ARCHIVED — This repository has been superseded by fireflyframework-orchestration.

The unified orchestration engine combines Workflow, Saga, and TCC patterns into a single module with a shared core layer for persistence, observability, retry, event integration, backpressure, validation, execution reporting, and event sourcing.

Migrate to:

<dependency>
    <groupId>org.fireflyframework</groupId>
    <artifactId>fireflyframework-orchestration</artifactId>
    <version>26.02.06</version>
</dependency>

This repository is marked for deletion in a future revision. No further updates will be made here.

---

Overview

Firefly Framework Transactional Engine provided a production-grade distributed transaction management system implementing both the SAGA and TCC (Try-Confirm/Cancel) patterns with annotation-driven orchestration and automatic compensation handling.

All capabilities from this project have been incorporated into fireflyframework-orchestration, which additionally provides:

• Unified core layer shared across Workflow, Saga, and TCC patterns
• Enhanced Saga composition with DAG topology, data flow, and visualization
• Enhanced TCC composition with parallel execution and data mapping
• Compensation error handlers: fail-fast, retry-with-backoff, log-and-continue, composite, robust
• Execution reporting with ExecutionReport attached to SagaResult and TccResult
• Backpressure strategies for fan-out and parallel composition
• Event sourcing persistence with snapshots and projections
• Validation framework for definition integrity checks
• Actuator metrics endpoint
• Comprehensive documentation (58 sections across 7 reference documents)

License

Copyright 2024-2026 Firefly Software Solutions Inc.

Licensed under the Apache License, Version 2.0. See LICENSE for details.