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