Skip to main content

Workflow Capability Overview

Summary​

Workflow has an authoring side—definitions, versions, steps and conditions—and an execution side—instances, tasks and actions.

Business Purpose​

Give tenants a configurable approval model that can be reused by multiple record types.

Actors​

Workflow authors, approvers, delegates, process initiators, tenant administrators, product owners, support teams and owners of connected business modules.

Business Flow​

Definition lifecycle and instance lifecycle are independent. Editing targets a draft; running work retains the published version identifier selected at start.

Responsibilities​

Authors maintain valid draft steps before publication. Initiating modules supply a subject and routing context. Approvers act only on applicable pending tasks. Tenant and service owners govern access, integration enablement and operational support.

Business Rules​

Stages are ordered by step order. All conditions for a stage must pass. All tasks opened for an approved stage must be decided before advancement.

Integrations​

Workflow Service owns definitions, versions, instances and tasks. Connected modules can synchronously start and read instances when their integration is enabled; lifecycle domain events are persisted to an outbox and relayed as integration events.

Limitations​

Step mode and Notification step type are stored but not honored by distinct runtime strategies. No definition archive or instance cancellation operation is exposed.

Requires Confirmation​

Production enablement, approver-role naming, upstream access enforcement, terminal decision propagation, notification ownership, retention and operating procedures require confirmation.

Source References​

  • microservices/src/workflow-service/Domain/Workflow/WorkflowDefinition.cs
  • microservices/src/workflow-service/Domain/Workflow/WorkflowInstance.cs
  • microservices/src/workflow-service/Application/Commands/WorkflowInstanceCommands.cs

See Also​

Keywords​

Workflow, approval, definition, version, task, delegation.

Revision Information​

Draft source-backed business documentation reviewed on 2026-07-20; next quarterly review is 2026-10-20.