Skip to content
ZYNXTECH

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.

Cycle
  1. not_started
  2. draft
  3. submitted
  4. manager_reviewed
  5. hr_reviewed
  6. completed
Ratingsselfmgr
Results8/7
Quality7/7
Problem solving9/8
Collaboration6/8
Learning8/6
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 SELECT at a time, a schema browser, database export 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.