Skip to content

docs: Add ADR-001 Logic Operator v2.0 Architecture Design#18

Open
ricardozanini wants to merge 2 commits into
mainfrom
docs/v2-design-spec
Open

docs: Add ADR-001 Logic Operator v2.0 Architecture Design#18
ricardozanini wants to merge 2 commits into
mainfrom
docs/v2-design-spec

Conversation

@ricardozanini

@ricardozanini ricardozanini commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Description

Adds ADR-001 documenting the comprehensive architecture design for Logic Operator v2.0 refactoring.

Summary

This ADR captures the complete design for migrating from SonataFlow to Quarkus Flow, including:

Architecture Changes

  • New CRDs: LogicPlatform, LogicFlowService, LogicFlowDefinition, LogicFlowRuntime
  • Removed Components: Jobs Service, Container Builder, SonataFlow v1alpha08 CRDs
  • Runtime Model: Shift from per-workflow containers to shared Quarkus Flow runners
  • Data Index: MODE1 architecture (FluentBit + PostgreSQL + GraphQL)

Key Features

  • Multi-version workflow support with traffic splitting
  • Dual-mode topology: local (per-namespace) and centralized (multi-tenant)
  • Metadata-driven workflow definitions (DRY principles)
  • Lease-based durable workflow coordination
  • Immutable version snapshots

Implementation

Related Issues

Closes: None (design document only)

Relates-to: #3, #4, #5, #6, #7, #8, #9, #10, #11, #12, #13, #14, #15, #16

Checklist

  • Design reviewed and approved
  • EPICs created on GitHub
  • ADR follows naming convention (adr/NNN-title.md)
  • Document is comprehensive and self-contained

Next Steps

After merge:

  1. Begin EPIC 0 (Codebase Cleanup) - Codebase Cleanup & Preparation #3
  2. Set up GitHub Projects for sprint planning
  3. Break down EPICs into smaller implementation issues

ricardozanini and others added 2 commits June 23, 2026 10:36
Add comprehensive architecture design document for Logic Operator v2.0
refactoring from SonataFlow to Quarkus Flow.

Key architectural changes:
- New CRDs: LogicPlatform, LogicFlowService, LogicFlowDefinition, LogicFlowRuntime
- Removed: Jobs Service, Container Builder, SonataFlow v1alpha08 CRDs
- Runtime model shift: per-workflow containers → shared Quarkus Flow runners
- Data Index MODE1: FluentBit + PostgreSQL + GraphQL
- Multi-version workflow support with traffic splitting
- Dual-mode topology: local (per-namespace) and centralized (multi-tenant)

Implementation organized in 13 EPICs across 6 phases (6 months).
GitHub issues created: #3-#16

Relates-to: #3, #4, #5, #6, #7, #8, #9, #10, #11, #12, #13, #14, #15, #16

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add path filters to PR workflows to skip CI when only documentation
files are changed:

- pr-checks: Skip for **.md, docs/, adr/, LICENSE, .gitignore
- e2e-minimal: Skip for **.md, docs/, adr/, cli/, LICENSE, .gitignore
- CLI workflows: Already have proper path filters (cli/**)

This prevents unnecessary CI runs for documentation PRs.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant