Skip to main content

Workflow Business Lifecycle

Summary​

The business lifecycle joins definition authoring with instance execution but preserves their distinct states.

Business Purpose​

Provide a traceable path from approval design to terminal business decision.

Actors​

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

Business Flow​

Archived, Cancelled, Delegated and Skipped values exist in enums but have no complete lifecycle command.

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​

Starting requires a definition ID or key and a published version. Rejection is immediately terminal. Completion produces result Approved; rejection produces result Rejected.

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​

No reopen, correction, withdrawal, cancellation, timeout, escalation or resubmission lifecycle was found.

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/Common/Enums.cs
  • 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.