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

# Recruitment overview & dashboard

> Recruitment in Hitaji 360 is the journey of turning a hiring need into a new colleague.

Recruitment in Hitaji 360 is the journey of turning a hiring need into a new colleague. It starts with someone in the business saying "we need a person for this role", and ends with that person becoming an employee on your payroll. Everything in between — advertising the role, collecting applicants, interviewing them, making an offer, and sending the appointment letter — lives in this module so you can see the whole pipeline in one place rather than juggling spreadsheets and email threads.

This page explains how the pieces fit together and walks through the recruitment dashboard, which is your control tower for live hiring activity.

**You'll find this at:** `/hr/recruitment`

> 📷 *Screenshot: Recruitment dashboard with the KPI strip, funnel, and charts — to be added.*

***

## The recruitment funnel — how a hire actually happens

Recruitment flows through a chain of stages. Each stage hands off to the next, and the module is designed to lead you from one to the next:

1. **[Job requisition](/hr/user/recruitment/job-requisitions)** — the formal *request to hire*. A manager says "I need to fill this role", it gets approved (or rejected/held), and once approved it can be turned into a public job opening.
2. **[Staffing plan](/hr/user/recruitment/staffing-plans)** — the *headcount plan*. Plan how many people you need per role over a period, with an estimated budget. This is planning rather than a step every hire passes through, but it tells you where your vacancies are.
3. **[Job opening](/hr/user/recruitment/job-openings)** — the *advertised role*. A live posting that candidates apply to. You can publish it to your public careers site.
4. **[Job applicant](/hr/user/recruitment/job-applicants)** — the *candidate*. Every person who applies (or whom you add manually) becomes an applicant, and you move them through a pipeline: Applied → In Review → On Hold → Rejected, or onward to an offer.
5. **Interview** — you schedule interviews, capture scorecards and feedback, and a decision (Cleared / Rejected) advances or ends the candidate's journey. See [Interviews](/hr/user/recruitment/interviews).
6. **Job offer** — you put a formal offer to the chosen candidate. When they **accept the offer**, the applicant becomes **Accepted**. See [Job offers](/hr/user/recruitment/job-offers).
7. **Appointment letter** — the formal letter confirming the appointment. See [Appointment letters](/hr/user/recruitment/appointment-letters).
8. **Hire** — the accepted applicant is turned into an **employee**, and they leave recruitment and join your [employee directory](/hr/user/employees/employees).

Two supporting masters keep the funnel tidy: **[opening templates](/hr/user/recruitment/opening-templates)** (reusable job-posting starting points) and **[applicant sources](/hr/user/recruitment/applicant-sources)** (where candidates came from, so you can measure which channels work).

> Hitaji 360 is **multi-business**. Recruitment data — requisitions, openings, applicants, interviews, offers — belongs to a single business. Before you do anything, check the correct business is selected in the business switcher at the top of the app. The dashboard will not load until a business is selected.

***

## The dashboard

The dashboard pulls live numbers from across the funnel for the **currently selected business** and lays them out as a KPI strip, a conversion funnel, several charts, and two work-queues. If no business is selected you'll see a prompt:

> *"Select an active business from the switcher to view its recruitment dashboard."*

Three quick links sit in the header — **Openings**, **Applicants**, and **Interviews** — to jump straight into those areas.

### The KPI strip

Eight headline numbers sit across the top:

| Metric                   | What it counts                                                                                                                                               |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Open roles**           | Job openings currently in *Open* status (with the count of requisitions shown as a hint).                                                                    |
| **Active candidates**    | Applicants who are still in play — those in *Open*, *Replied* (In Review), or *Hold*.                                                                        |
| **Interviews scheduled** | Interviews in *Pending* or *Under Review*.                                                                                                                   |
| **Offers out**           | Offers in *Awaiting Response*. Highlighted amber when there are any waiting.                                                                                 |
| **Total applicants**     | Every applicant across all statuses.                                                                                                                         |
| **Hires**                | Offers that have been linked to an employee (i.e. someone who was actually hired). Shown in green.                                                           |
| **Avg time to fill**     | Average days taken to fill requisitions that have been filled, or "—" if none yet.                                                                           |
| **Offer acceptance**     | Of the offers that have been decided (accepted + rejected), the percentage accepted. Green at 60% or above, amber below, "—" if no offers have been decided. |

### The recruitment funnel chart

A tapering funnel showing four stages in order — **Applicants → Interviews → Offers → Hires** — with the *% advanced* between each stage and an overall *Applicant → Hire* rate at the bottom. If you have no applicants yet it reads "No applicants yet. The funnel fills as candidates apply."

### The charts

* **Status donuts** — three doughnuts breaking down **applicants**, **interview outcomes**, and **offers** by status, each with the total in the centre.
* **Hiring trend** — applications (area) versus hires (line) over the last six months.
* **Source effectiveness** — for each [applicant source](/hr/user/recruitment/applicant-sources), the total applicants versus how many were accepted, with the conversion rate. This is why recording a source on each applicant matters — it's the only way this chart can tell you which channels actually produce hires.
* **Time to fill by designation** — average days to fill, per role, colour-coded green (fast) through amber to red (slow). It only appears once you have filled requisitions.

### Work queues

Two lists sit at the foot of the dashboard:

* **Most active openings** — your busiest openings by applicant count, with applicant and offer counts, linking to each opening.
* **Requisitions awaiting approval** — the requisitions sitting in *Pending* that need a decision, so approvers know what's on their plate.

***

## Permissions

Everything in recruitment is gated by the `hr-recruitment` permission family. Your role may have some levels and not others:

| You can…                                                                                                                   | Permission               |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| View any recruitment page, list, dashboard, or analytics                                                                   | `hr-recruitment:read`    |
| Create / edit requisitions, plans, openings, applicants; move applicants; schedule interviews; raise offers; issue letters | `hr-recruitment:write`   |
| Approve / reject requisitions, submit staffing plans, publish / unpublish openings                                         | `hr-recruitment:approve` |
| Manage the masters — applicant sources, interview types, opening & offer-term templates                                    | `hr-recruitment:config`  |

The dashboard and all analytics need only `hr-recruitment:read`.

***

## Related

* [Job requisitions](/hr/user/recruitment/job-requisitions) — the request to hire
* [Staffing plans](/hr/user/recruitment/staffing-plans) — headcount planning
* [Job openings](/hr/user/recruitment/job-openings) — advertising a role
* [Job applicants](/hr/user/recruitment/job-applicants) — the candidate pipeline
* [Applicant sources](/hr/user/recruitment/applicant-sources) — where candidates come from
* [Interviews](/hr/user/recruitment/interviews) — scheduling and scorecards
* [Job offers](/hr/user/recruitment/job-offers) — putting an offer to a candidate
* [Appointment letters](/hr/user/recruitment/appointment-letters) — confirming the appointment
* [The public careers site](/hr/user/recruitment/careers-site) — published openings and public applications