[EPIC] Logic Operator v2.0 - Implementation Roadmap

[ricardozanini]

Logic Operator v2.0 - Implementation Roadmap

Migration Strategy: Clean Slate - New Operator
Design: Approved 2026-06-22

Overview

This issue tracks the overall v2.0 implementation across 13 EPICs organized in 6 phases.

EPICs by Phase

Phase 0: Cleanup (1-2 weeks)

• Codebase Cleanup & Preparation #3 [EPIC 0] Codebase Cleanup & Preparation

Phase 1: Core CRDs & Controllers

• Core CRDs & API Types #4 [EPIC 1] Core CRDs & API Types
• LogicFlowRuntime Controller #5 [EPIC 2] LogicFlowRuntime Controller
• LogicFlowDefinition Controller #6 [EPIC 3] LogicFlowDefinition Controller
• LogicFlowService Controller #7 [EPIC 4] LogicFlowService Controller

Phase 2: Data Index Integration

• LogicPlatform Controller (Local Mode) #8 [EPIC 5] LogicPlatform Controller (Local Mode)
• Data Index Integration #9 [EPIC 6] Data Index Integration
• End-to-End Testing (Phase 1 Validation) #10 [EPIC 7] End-to-End Testing

Phase 3: Versioning & Traffic

• Multi-Version Support & Traffic Splitting #11 [EPIC 8] Multi-Version Support & Traffic Splitting

Phase 4: Advanced Features

• LogicPlatform Centralized Mode #12 [EPIC 9] LogicPlatform Centralized Mode
• Runtime Autoscaling #13 [EPIC 10] Runtime Autoscaling

Phase 5: Production Readiness

• Migration Guide & Documentation #14 [EPIC 11] Migration Guide & Documentation
• Production Readiness #15 [EPIC 12] Production Readiness

Architecture Changes

New CRDs (v1)

• LogicPlatform - Data Index infrastructure management
• LogicFlowRuntime - Quarkus Flow Runner deployments
• LogicFlowDefinition - Immutable workflow definitions (versions)
• LogicFlowService - Service endpoints, traffic routing

Removed Components

• Jobs Service (removed)
• Container Builder (removed)
• Workflow Project Handler (removed)
• SonataFlow v1alpha08 CRDs (removed)
• Dev mode support (removed)

New Components

• Quarkus Flow Runner integration
• Data Index MODE1 (FluentBit + PostgreSQL + GraphQL)
• Multi-version workflow support
• Traffic splitting (Ingress canary)
• Centralized Data Index (multi-tenant)

Key Design Decisions

1. Runtime Model Shift: From per-workflow containers to shared runners
2. Specification Support: Only SW DSL v1.0.0 (drop v0.8)
3. Metadata-Driven: Workflow name from annotations, not CR name
4. Immutable Versions: LogicFlowDefinition is production-ready at creation
5. Dual-Mode Data Index: Local (per-namespace) or Centralized (multi-tenant)
6. Lease-Based Durability: Kubernetes Leases for stable workflow identity

Success Criteria

• All CRDs defined and documented
• Controllers reconcile successfully
• Data Index integration working
• Multi-version workflows supported
• E2E tests passing in CI
• Migration guide available
• Production-ready (security, observability, OLM)