The Performance Review Wizard atDocumentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
/hr/performance/reviews/:id/wizard is a guided multi-step form for conducting a performance review. It collects goal ratings, competency ratings, manager comments, and an overall rating, then submits the review for employee acknowledgment.
Overview
The wizard is accessible from the Review Details page when a review is indraft or in_progress status. It loads the review by :id, then renders a ModuleWizardRenderer with draft-persistence and a “Save and Exit” option. On completion, the wizard: (1) updates the review with overall, goals, and competencies ratings plus manager comments; (2) updates individual goal statuses; (3) updates competency ratings and identifies gaps if flagged; (4) calls submitReview to transition the review to pending_acknowledgment; (5) navigates back to the review detail page.
Who it’s for
No explicit permission gate on this route.Before you start
- The review must exist and be in
draftorin_progressstatus. - The employee’s goals and competencies should be added to the review before starting the wizard, so they appear as items to rate.
Steps
- Open a review at
/hr/performance/reviews/<reviewId>. - Click Conduct Review to launch the wizard at
/hr/performance/reviews/<reviewId>/wizard. - Work through each wizard step, rating goals and competencies as prompted.
- Enter manager comments and select an overall rating on the final step.
- Click Submit Review to finalize. The review transitions to
pending_acknowledgment. - To save progress without submitting, use Save and Exit — the wizard uses draft persistence.
Key concepts
| Term | Meaning |
|---|---|
| Draft Persistence | Wizard data is saved automatically so the reviewer can return without losing progress. |
pending_acknowledgment | Review status after submission, awaiting the employee’s acknowledgment signature. |
| Gap | A competency rated below an expected threshold, flagged for training recommendations. |
Related
Human Resources
Human Resources core overview.
Governance & parity
This page documents shipped product behavior. It is not medical, legal, or
billing advice. Verify against your organization’s policies and applicable
regulations before using it for clinical, compliance, or billing decisions.
Protected health information (PHI) shown in the product is governed by your
tenant’s access controls and is never exposed in this documentation.
Documentation sources
Documentation sources
- src/routes/hr/performance-routes.tsx
- src/cores/hr/pages/PerformanceReviewWizardPage.tsx
- src/cores/hr/hooks/performance/usePerformanceReviewMutation.ts
- src/cores/hr/hooks/performance/usePerformanceCompetencyMutation.ts