Workflow Definitions
Summary
A definition owns its versions and identifies a reusable process by tenant, key, name, description and category.
Business Purpose
Let process owners describe who should approve a class of business request and in which stage order.
Actors
Workflow authors, approvers, delegates, process initiators, tenant administrators, product owners, support teams and owners of connected business modules.
Business Flow
Creation produces draft version 1 and replaces its steps with the submitted specification. Later updates can change descriptive fields and, when steps are supplied, replace the current draft step set.
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
Key and name are required. Keys are unique per tenant. Missing category defaults to General. Unknown approver types are rejected; missing/unknown step type or mode defaults to Approval/Sequential.
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
The administration UI creates only one approval step and cannot edit existing definitions, conditions or multi-step designs. Definition deletion, cloning, archival and ownership are not implemented.
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.csmicroservices/src/workflow-service/Application/Commands/WorkflowDefinitionCommands.csmicroservices/src/workflow-service/Application/Dtos.csUI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx
Related Articles
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.