> ## 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.

# The employee profile & its tabs

> The employee profile is the single 360° view of one person — their identity, their contracts, their leave and attendance, their pay, their performance,…

The employee profile is the single 360° view of one person — their identity, their contracts, their leave and attendance, their pay, their performance, their documents, and their place in their lifecycle from onboarding to separation. It's organised as a **hub**: a hero panel with the essentials at the top, a left-hand navigation rail (a tab strip on mobile), and a panel that swaps as you move between sections.

This page is a map of the profile. It explains the header and its actions, then walks each section at a high level and points you to the detailed module pages where the real work happens.

**You'll find this at:** `/hr/employees/:id` (click any employee in the [directory](/hr/user/employees/employees))

> 📷 *Screenshot: Employee profile showing the hero header, the left section rail and the Overview panel — to be added.*

***

## Deep links

The profile accepts an optional `?section=` query parameter so other parts of the app (for example the accounting "Employee" party links) can drop you straight onto a specific tab — e.g. `/hr/employees/<id>?section=payslips`. Without it, the profile opens on **Overview**.

***

## The header and its actions

The hero panel is the single source of identity: avatar, full name, status badge, and the key metadata — position (with the [title / position-type fallback](/hr/user/employees/employees#the-no-position--title-fallback-behaviour)), department, manager, employment type, hire date and tenure. It also surfaces the **login account** state — whether an account is linked, whether an invitation is still pending — with inline actions to **invite**, **link**, **resend the invitation**, or **unlink** the account.

The primary actions sit in the page header (top-right), each gated by permission:

| Action                       | When it shows                                                                    | What it does                                                                                                                                                                                                                                                       | Permission                   |
| ---------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- |
| **Edit**                     | If you can write                                                                 | Opens the edit form to change personal/contact/identity fields.                                                                                                                                                                                                    | `hr:write`                   |
| **Transfer**                 | If you can write, the employee is **Active**, and they have an active employment | Opens the transfer modal to move them to a new unit/position/manager. See [Transfers](/hr/user/employees/transfers).                                                                                                                                               | `hr:write`                   |
| **App access** (break-glass) | If you can manage the business and the employee is **Active**                    | Administrator-only shortcut to grant a reviewed **access profile** directly, with a written justification — for emergencies where the normal request-and-approve path is too slow. See [Break-glass](/hr/user/employees/app-access#break-glass-granting-directly). | platform business management |
| **Delete**                   | If you can administer                                                            | Soft-deletes the employee (deactivates and hides them; employment history and leave balances are preserved).                                                                                                                                                       | `hr:admin`                   |

> ⚠️ **Current state — action gating.** These header buttons are deliberately gated on the **coarse** `hr:write` / `hr:admin` slugs that the API actually enforces, rather than the finer `hr-employees:*` scopes used elsewhere, so that a manager the API would authorise isn't hidden out of the buttons. If a button is unexpectedly missing or present for a role, this slug choice is why — it's been noted for the team.

There's also a confirmation when you **unlink** an account: it warns that the person loses self-service (My HR) access, but their user account and any other product access are left intact.

***

## The sections

The rail groups the sections so related things sit together. Each panel is a high-level summary that links onward to the full module page.

### Profile

* **Overview** — the landing panel. Pulls together an **Employment summary** (department, position, type, reports-to, work location, start/hire dates, tenure, and termination date if any), a **Compensation** snapshot for the active contract, a **Personal & contact** block (gender, date of birth with age, employee number, email, phone, location, address), a **Leave balances** snapshot for the current year, and an **App access** panel showing the employee's access and its status with a **Request access** action ([app access](/hr/user/employees/app-access)). If a transfer is awaiting approval, a banner appears here. Quick links jump to the History, Documents and Leave sections.
* **Documents** — files attached to this employee (contracts, IDs, certificates, CVs). Upload, categorise and download here; this is the same data shown on the standalone documents page. See [HR documents](/hr/user/employees/hr-documents).

### Work

* **Employment** — the employee's **employment history**: every contract, newest first, with type, dates, tenure, location and manager. Add a new employment record, or click one to open its detail sheet (contract, role & placement, statutory & bank details, compensation, leave approver, and the **End Employment** action). This is the deep contract surface — see [Employment records & contracts](/hr/user/employees/employment-and-contracts).
* **Work History** — a chronological timeline of life events: hires, transfers, promotions and contract endings, drawn from the contract, transfer and promotion records.
* **Attendance** — the employee's attendance and check-in records. See [Attendance](/hr/user/attendance/attendance).

### Time Off

* **Leave** — this employee's leave balances and requests, with the ability to manage them if you have write access. See [Applying for & approving leave](/hr/user/leave/leave-requests) and [Leave reports](/hr/user/leave/leave-reports).

### Growth

* **Performance** — the employee's appraisals, goals and feedback. See [Performance overview](/hr/user/performance/overview).

### Compensation

* **Payslips** — the employee's generated payslips. See [Payslips](/hr/user/payroll/payslips).
* **Advances & Loans** — salary advances and employee loans. See [Employee loans & loan types](/hr/user/payroll/employee-loans).
* **Expenses & Reimbursements** — expense claims and reimbursements tied to this employee.

> These three panels are loaded on demand (so payroll data isn't pulled in until you open them); you may briefly see a skeleton.

### Lifecycle

* **Onboarding** — the new-joiner onboarding checklist/activities for this employee. See [Onboarding](/hr/user/lifecycle/onboarding).
* **Grievances** — grievances raised by or about this employee. See [Grievances](/hr/user/lifecycle/grievances).
* **Separation** — the offboarding record. Available when the employee is being separated. See [Separation (offboarding)](/hr/user/lifecycle/separation).

### System

* **Activity** — the audit-style activity timeline and a comment thread for this employee record.

***

## Permissions

| Area                                                                                     | Permission |
| ---------------------------------------------------------------------------------------- | ---------- |
| View the profile and its read-only panels                                                | `hr:read`  |
| Edit / Transfer / manage leave, documents, grievances, separation (the "manage" toggles) | `hr:write` |
| Delete the employee; link/unlink/terminate the account                                   | `hr:admin` |

The compensation, performance, attendance and leave panels also respect their own module permissions for any actions taken inside them.

***

## Related

* [Employees (the people directory)](/hr/user/employees/employees) — the list this profile opens from
* [Employment records & contracts](/hr/user/employees/employment-and-contracts) — the Employment section in depth
* [Transfers](/hr/user/employees/transfers) · [Promotions](/hr/user/employees/promotions) — role changes that show in Work History
* [HR documents](/hr/user/employees/hr-documents) — the Documents section
* [Leave requests](/hr/user/leave/leave-requests) · [Payslips](/hr/user/payroll/payslips) · [Performance overview](/hr/user/performance/overview)
* [Onboarding](/hr/user/lifecycle/onboarding) · [Separation (offboarding)](/hr/user/lifecycle/separation) · [Grievances](/hr/user/lifecycle/grievances)