> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitaji360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 360° Feedback

> 360° feedback is a colleague, manager, or peer's rated assessment of an employee, captured against one of that employee's appraisals.

360° feedback is a colleague, manager, or peer's rated assessment of an employee, captured against one of that employee's appraisals. Where the self-appraisal records what the employee thinks of their own performance and goals track what they actually delivered, 360° feedback brings in the view of the people who work *around* them — a line manager, a peer on the same team, an internal customer. Each reviewer scores the appraisee against a set of feedback criteria and leaves a written comment, and those scores roll up into the appraisal's overall picture.

An appraisal can collect **many** feedback documents — one per reviewer — and the appraisal's average feedback score is simply the average of every *submitted* one. This page covers how a reviewer drafts and submits feedback, how the criteria are pre-filled from the appraisal's template, the statuses a feedback document moves through, and how each submission feeds back into the appraisal score.

**You'll find this at:** `/hr/performance/feedback`

> Hitaji 360 is **multi-business**: each business keeps its own employees, appraisals, and feedback. Feedback is scoped to the business you have selected in the switcher at the top of the app — you cannot attach feedback to (or read) another business's appraisal, and the system fails closed if you try. Confirm the correct business is selected before you start.

> 📷 *Screenshot: the 360° Feedback page with its **Received** / **Given** tabs and the feedback list — to be added.*

***

## The feedback page

The 360° Feedback page is a read-and-browse view of feedback across all your appraisal cycles, split into two tabs:

| Tab          | What it shows                                                                                      |
| ------------ | -------------------------------------------------------------------------------------------------- |
| **Received** | Feedback documents written *about* an employee (filter by the **Employee** the feedback is about). |
| **Given**    | Feedback documents written *by* a reviewer (the same list, viewed from the reviewer's side).       |

Each row shows the **reviewer** (and their designation, where recorded), the **appraisal cycle**, the **date** the feedback was added, its **score** (0–5, to two decimals), and its **status**. You can filter by employee and by cycle, and clicking a row opens the parent appraisal on its **Feedback** tab, where the full history lives.

> The feedback list and history are read-only browsing surfaces. Feedback documents are **created and submitted from inside an appraisal** (its Feedback tab), not from this page — see [Appraisals](/hr/user/performance/appraisals).

> 📷 *Screenshot: the appraisal Feedback tab showing the rating-distribution and average-score summary cards above the chronological feedback cards — to be added.*

***

## The feedback lifecycle (statuses)

A feedback document is a *submittable* document: it starts as a working draft, and submitting it locks the scores in and folds them into the appraisal.

| Status        | Meaning                                                                                    | What you can do                                      |
| ------------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| **Draft**     | Created but not yet submitted; its score does **not** count towards the appraisal average. | Submit it, or delete it.                             |
| **Submitted** | Locked in; its score is now included in the appraisal's average feedback score.            | Cancel it.                                           |
| **Cancelled** | Withdrawn; removed from the appraisal average.                                             | Nothing further (delete it if you wish to clean up). |

Two things to keep in mind:

* **Only Draft feedback can be submitted.** Once submitted, a document cannot be re-submitted or edited in place — cancel it and create a fresh one if you need to change a score.
* **A submitted document must be cancelled before it can be deleted.** The system refuses to delete a document that is still in the Submitted state.

***

## How a feedback document is scored

A feedback document holds a set of **ratings — one per feedback criterion**. Each rating is a **0–5** score (the star control), and each criterion carries a **weightage** (a percentage). The criteria and their weightages come from the **appraisal's template**, not from the reviewer — so every reviewer scores the same employee against the same yardstick.

The document's **total score** is the weighted average of its ratings, on a 0–5 scale:

> total score = Σ ( rating × weightage ) ÷ 100

So a reviewer who gives 4/5 on a criterion weighted 60% and 5/5 on a criterion weighted 40% produces a total of (4 × 60 + 5 × 40) ÷ 100 = **4.40**. The weightages on a template must add up to 100% — the system rejects a set that does not.

***

## Pre-populating the criteria

When you start a new feedback document for an appraisal, the form pre-fills the right rows for you. Behind the scenes it reads the **feedback criteria from the appraisal's template** (`GET …/feedback/:appraisalId/criteria`), so the reviewer starts with exactly the criteria — and the weightages — defined for that appraisal. You then set a 0–5 rating on each row and write your comment.

If the appraisal has no template attached, no criteria rows come back and there is nothing to rate.

***

## Creating feedback (Draft)

A new feedback document is created as a **Draft** from an appraisal's Feedback tab.

| Field                    | Required | Notes                                                                                                                                                                                                               |
| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Employee (appraisee)** | Yes      | The employee the feedback is about. Must match the appraisal's employee.                                                                                                                                            |
| **Appraisal**            | Yes      | The appraisal the feedback attaches to.                                                                                                                                                                             |
| **Reviewer**             | No       | The employee giving the feedback. If you leave it blank, the system uses the employee linked to *your* user account (the self-service path). If your user is not linked to an employee, you must supply a reviewer. |
| **Comment**              | Yes      | The written feedback (free text, up to 20,000 characters).                                                                                                                                                          |
| **Ratings**              | Yes      | At least one rating, up to 100. Each is a 0–5 score against a feedback criterion.                                                                                                                                   |

The system enforces several rules at creation time:

* **A reviewer cannot give feedback about themselves** — the reviewer and the appraisee must be different employees.
* **Both the reviewer and the appraisee must be active.** Employees who are *terminated* or *suspended* are rejected; *active* and *on-leave* employees are allowed (an on-leave employee can still give or receive feedback).
* **Every rated criterion must belong to the appraisal's template.** Rating a criterion that is not part of this appraisal's template is rejected.
* **You cannot add feedback to a closed appraisal or cycle.** Feedback is refused if the appraisal has been *submitted* (finalised) or *cancelled*, or if its appraisal cycle is already *completed*.

Once saved, the document's total score is computed from your ratings and the document sits as a **Draft**.

***

## Submitting feedback

Submitting a Draft locks it in and is the moment its score starts counting. When you submit:

1. The document moves to **Submitted** and is stamped with the submission date.
2. **The parent appraisal's average feedback score is recalculated immediately** — the average of every *submitted, non-cancelled* feedback document on that appraisal — and the appraisal's scores are refreshed. This recalculation happens synchronously: if it fails, the submit fails and can be retried, so a submitted score is never silently dropped.
3. A best-effort **notification** is emitted to flag the new feedback.

Submission re-checks the context, because a Draft can sit for a while: if the appraisal was cancelled or the cycle was completed while the feedback waited in Draft, the submit is refused.

***

## Cancelling feedback

Cancelling withdraws a feedback document. Like submitting, cancelling **recalculates the appraisal's average feedback score straight away** — the cancelled document drops out of the average, and the appraisal's scores are refreshed to match. A document that is already cancelled cannot be cancelled again.

***

## Deleting feedback

A Draft or Cancelled document can be **deleted** (a soft delete — it is removed from view rather than physically purged). A document that is still **Submitted** cannot be deleted: cancel it first, then delete it. This keeps a submitted score from disappearing from the appraisal average without the average being recomputed.

***

## Permissions

Actions on 360° feedback are gated by these permission slugs (your role may have some and not others):

| Action                                       | Permission             |
| -------------------------------------------- | ---------------------- |
| View the list, history, criteria, and detail | `hr-performance:read`  |
| Create, submit, cancel, or delete feedback   | `hr-performance:write` |

All feedback is tenant- and business-scoped via the active business (`X-Business-Id`); requests for another business's feedback fail closed.

***

## Behind the scenes — how feedback feeds the appraisal

Each appraisal carries a **final score** built from three components, each on a 0–5 scale: the **goal score**, the **self-appraisal score**, and the **average feedback score** — the last of which is exactly the average of the submitted feedback documents described on this page.

When you submit or cancel a feedback document, only that average feedback component is recomputed and the appraisal's final score is refreshed (either as the plain average of the three components, or via a custom formula if the cycle defines one). So a reviewer's submitted feedback flows directly into the employee's overall appraisal result — and pulling it back out (by cancelling) updates that result the same way.

On the appraisal's Feedback tab you also see a **rating distribution** (how many reviewers landed on each whole-star average, 1 to 5) and the running **average score** across all submitted reviews, alongside the chronological list of feedback cards.

***

## Related

* [Performance overview](/hr/user/performance/overview) — how the performance module fits together
* [Appraisals](/hr/user/performance/appraisals) — where feedback is created, viewed, and folded into the score
* [Feedback criteria](/hr/user/performance/feedback-criteria) — the reusable criteria reviewers rate against
* [Appraisal templates](/hr/user/performance/appraisal-templates) — where criteria and their weightages are set for an appraisal
