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

# Recruitment overview

> From an open headcount to a signed contract — how hiring flows through the platform.

Recruitment in Swiss HR Easy is one continuous flow. A position becomes a job ad,
the ad becomes applications, applications move through a configurable pipeline, and a
hire becomes a pre-boarding journey without anyone re-typing a name.

```mermaid theme={null}
flowchart LR
  A[Position created] --> B{Reportable<br/>occupation?}
  B -- yes --> C[SECO Job-Room<br/>Stellenmeldung]
  C --> D[5-working-day<br/>embargo]
  D --> E[Publish publicly]
  B -- no --> E
  E --> F[Applications]
  F --> G[Pipeline stages]
  G --> H[Interviews &<br/>reference checks]
  H --> I[Hiring decision]
  I --> J[Pre-boarding journey]
```

## The pieces

<CardGroup cols={2}>
  <Card title="Positions" icon="briefcase" href="/guides/recruitment/positions">
    The opening itself: function, location, Pensum, requirements, and the job ad in each locale.
  </Card>

  <Card title="Job distribution" icon="tower-broadcast" href="/guides/recruitment/job-distribution">
    The careers page, the SECO Job-Room, and multi-channel distribution.
  </Card>

  <Card title="Pipeline" icon="diagram-project" href="/guides/recruitment/pipeline">
    Configurable stages with their own e-mails, tasks and document requests.
  </Card>

  <Card title="Interviews and references" icon="user-check" href="/guides/recruitment/interviews-and-references">
    Scheduling through Microsoft Graph and structured reference checks.
  </Card>

  <Card title="Decisions" icon="gavel" href="/guides/recruitment/decisions">
    Making the hiring call with a method, not just a meeting.
  </Card>
</CardGroup>

## Where applications come from

| Source            | How it works                                                                                                                               |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Careers page      | The public site renders published positions and takes applications directly.                                                               |
| Shared HR mailbox | A scheduled scan reads the Outlook mailbox, attaches mail and attachments to the matching application, and can move it along the pipeline. |
| Manual entry      | HR creates an application for a candidate who applied by another route.                                                                    |
| Talent pool       | A previously saved candidate is put forward for a new opening.                                                                             |

## Who sees what

`MANAGER` holds `applications:view`, so managers reach the recruitment surfaces. What
they see is scoped: without `applications:view-all` a manager sees only the
applications for positions they are responsible for — their own position-role
assignments plus their direct reports'. HR staff and administrators hold
`applications:view-all` and see everything.

Position visibility follows the same idea: a position can be restricted so that only
the people assigned to it work its pipeline.

## Metrics

The module computes recruitment metrics — time-to-hire, stage throughput, source
effectiveness — over the pipeline history. These feed the
[reports](/guides/admin/reports) surface.

<Note>
  Recruitment can be switched off entirely on installations that only use Swiss HR Easy for employee
  administration: set `FEATURE_RECRUITMENT=false`. See [Feature flags](/operations/feature-flags).
</Note>
