Skip to main content

Workflow Integration

Summary​

Optional delegation of appraisal decisions to the Workflow service.

Audience​

Engineers, architects, QA, support, security reviewers, and operators working with the Performance module.

Overview​

When enabled, self submission starts a remote approval instance and attaches its identity to the appraisal. While linked and self-submitted, direct manager, HR, and approval actions are blocked. A terminal callback applies approval or rejection.

Confirmed implementation​

  • A null client is injected when integration is disabled.
  • The typed client forwards tenant, user, role, and correlation context.
  • Approved callbacks fast-forward review records and finalize the appraisal; rejected callbacks reopen it.
  • Already-decided callbacks are acknowledged without reapplying events.
  • Callback state verification is optional and best-effort according to source.

Classification​

Transitional because direct and Workflow-managed decision paths coexist.

Requires confirmation​

Callback trust model, retry ownership, Workflow definition governance, and failure recovery require confirmation.

Diagram​

See Also​

Keywords​

  • Performance service
  • Workflow Integration
  • Draft technical documentation

Source References​

  • microservices/src/performance-service/Application/WorkflowIntegration.cs
  • microservices/src/performance-service/Application/Commands/AppraisalCommands.cs
  • microservices/src/performance-service/Infrastructure/WorkflowServiceClient.cs
  • microservices/src/performance-service/Program.cs

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-16
  • Review cycle: Quarterly