Skip to main content

Workflow Publication

Summary​

Publication freezes the current draft and makes it the version selected for new instances.

Business Purpose​

Create a controlled boundary between authoring and executable approval logic.

Actors​

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

Business Flow​

An author invokes publish. Workflow rejects publication when there is no current draft or the draft has no steps. A successful publish marks the version and definition published and records audit/timeline evidence.

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​

Only one current draft is published per call. The latest published version is selected at instance start.

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 service defines authenticated-user policies but the policy list is empty and endpoints do not require authorization. The Portal exposes Publish without a confirmation or review step.

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/Application/Commands/WorkflowDefinitionCommands.cs
  • microservices/src/workflow-service/Api/WorkflowEndpoints.cs
  • microservices/src/workflow-service/Api/Policies.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx

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.