Skip to main content

Workflow Administrator Experience

Summary​

The Portal provides one combined Workflow Administration page with tabs for tasks and definitions.

Business Purpose​

Give authorized administrative users a foundation surface for publishing definitions and handling assigned work.

Actors​

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

Business Flow​

The page loads caller tasks and definition summaries. It can create a definition containing one approval step, publish listed definitions, and approve, reject or delegate caller tasks.

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​

The create form requires key and name and supplies one step. Portal route/navigation checks accept Workflow, Workflow.Manage or settings session values and selected roles.

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 page cannot inspect definition versions, edit definitions, build multiple stages/conditions, start instances, inspect instance history or manage all tenant tasks. No gateway Workflow route was found, so deployed request routing requires confirmation.

Requires Confirmation​

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

Source References​

  • UI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx
  • microservices/src/workflow-service/Api/WorkflowEndpoints.cs
  • microservices/src/gateway-api/Program.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.