Skip to main content

Performance Appraisal Troubleshooting

Symptoms​

Appraisal creation, goal addition, review, approval, close, or reopen is rejected or appears stuck.

Scope​

Canonical appraisal lifecycle and co-located admin actions.

Cause​

Likely causes​

Cycle not open; missing subject; no goal before submission; wrong lifecycle state; Workflow-managed direct action; missing record; compatibility/canonical mismatch.

Safe diagnostic steps​

  1. Identify current status and requested transition.\n2. Confirm the cycle accepts appraisals.\n3. Confirm goal presence category and Workflow linkage category.\n4. Compare audit/timeline/outbox status categories.

Resolution​

Safe resolution​

Use only the next valid supported transition or complete the Workflow-owned task when applicable. Do not bypass guards.

Validation​

Reload the appraisal and confirm state, evidence, and expected outbox intent for event-producing actions.

Evidence to collect​

Collect only environment category, time window, capability/route, status or error category, sanitized correlation reference, lifecycle state category, and recent approved change context.

Escalation​

Escalate domain inconsistencies to Performance; Workflow-owned cases jointly to Workflow; UI action gaps to frontend/product.

Source References​

  • microservices/src/performance-service/Domain/Appraisal/Appraisal.cs
  • microservices/src/performance-service/Application/Commands/AppraisalCommands.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/TalentAdminPages.tsx

Summary​

This Draft page provides non-destructive, source-backed diagnosis and explicitly stops where recovery authority is not confirmed.

Audience​

Performance users, support, operations, engineering, QA, architecture, security, and implementation teams.

Overview​

Use supported reads and sanitized evidence. Never expose personal/evaluation content, credentials, configuration values, infrastructure details, or operational commands.

See Also​

Keywords​

  • Performance troubleshooting
  • Safe diagnostics

Revision Information​

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