PerfReview
Performance appraisals with self, manager and HR stages.
A Flask REST API with a React front end for running an appraisal cycle. Employees assess themselves on five competencies, managers review their reportees, HR signs off, and a dashboard shows where every review stands.
- not_started
- draft
- submitted
- manager_reviewed
- hr_reviewed
- completed
- competency areas, each rated 1 to 10 with a written answer
- 5competency areas, each rated 1 to 10 with a written answer
- roles, enforced through JWT claims
- 4roles, enforced through JWT claims
- states from not started to completed
- 6states from not started to completed
- auto-save interval on drafts
- 30 sauto-save interval on drafts
One cycle, three reviewers
An appraisal moves through six states, and each move belongs to one role:
| State | Who moves it on | What happens |
|---|---|---|
| not_started | Employee | The cycle opens. |
| draft | Employee | Answers are saved every 30 seconds. |
| submitted | Employee | The self-assessment locks and goes to the manager. |
| manager_reviewed | Manager | The manager rates and comments on each section. |
| hr_reviewed | HR | HR gives the final rating. |
| completed | HR | HR marks the appraisal done. |
The five competency areas are Results and Delivery; Quality and Ownership; Problem Solving and Initiative; Collaboration and Communication; and Learning, Adaptability and Growth. Each gets a 1 to 10 rating and a written response, followed by optional remarks and an overall rating.
Features
- Self-assessment with drafts, auto-save and a lock once submitted.
- Manager review of each reportee’s submission.
- HR review and sign-off, with the final rating.
- Role-based access for Employee, Manager, HR and Admin. Each role inherits the one before it.
- User management: create, edit and disable users, issue temporary passwords and upload users in bulk from CSV.
- Org hierarchy: assign managers one at a time or by CSV, and see the result as a tree.
- Dashboard: a status funnel, rating distributions, department and section breakdowns, and the gap between employee and manager ratings, all filterable by cycle.
- Admin tools: a read-only SQL console that accepts one
SELECTat a time, a schema browser, database export, a JSON export of a cycle’s appraisals and an audit log of logins, submissions and admin actions. - Light and dark themes throughout.
How it is put together
The Flask app is a set of blueprints (auth, users, appraisals, dashboard, admin) over SQLAlchemy models. The React app talks to it through one Axios client and keeps auth, theme and toasts in context providers.
For production, the built React bundle is served by Flask itself from one origin, under gunicorn or waitress, with client-side routes handled by a catch-all. Every setting comes from the environment, and the app logs a warning at startup if a secret is still at its development default.
It started as a demonstration project, so it ships with seed data and a few deliberately simple defaults for exploring the flows locally. The README lists each of them and what to change before a real deployment.
Questions
- What does an appraisal cycle look like in PerfReview?
- Employees assess themselves on five competencies, managers review their reportees, and HR gives the final rating and marks the appraisal complete. Submitted self-assessments are locked.