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

# Employee Lifecycle

> Unified dashboard for monitoring and managing employee onboarding, offboarding, and transitions across the organization.

The Employee Lifecycle page (`/hr/lifecycle`) is the central hub for tracking onboarding pipelines, offboarding pipelines, recent hires, and task assignments related to employee transitions.

## Overview

The Employee Lifecycle page surfaces four key stat cards — Active Onboardings, Upcoming Departures (within 7 days), Overdue Onboardings, and Recent Hires (last 30 days) — alongside widget panels for onboarding pipeline, offboarding pipeline, personal lifecycle tasks, onboarding templates, onboarding analytics, and recent transitions.

A **Refresh** button invalidates all cached lifecycle, onboarding-instance, and offboarding-instance queries for the current organization.

## Who it's for

Requires permission: `hr.onboarding.view` (`HR_PERMISSIONS.ONBOARDING_VIEW`).

## Before you start

* At least one onboarding or offboarding instance must exist in your organization for the pipeline widgets to show data.
* You must have the `hr.onboarding.view` permission assigned to your role.

## Steps

1. Navigate to **HR → Employee Lifecycle** or go directly to `/hr/lifecycle`.
2. Review the four stat cards at the top for a quick count of active, overdue, upcoming, and recent events.
3. Use the **Onboarding Pipeline** and **Offboarding Pipeline** widgets to see in-progress cases.
4. Check **My Lifecycle Tasks** for tasks assigned to you.
5. Click **Refresh** to reload all data if you suspect counts are stale.

## Key concepts

| Concept             | Meaning                                                              |
| ------------------- | -------------------------------------------------------------------- |
| Active Onboardings  | Onboarding instances currently in progress for your organization     |
| Upcoming Departures | Employees with a termination date within the next 7 days             |
| Overdue Onboardings | Onboarding instances that have passed their expected completion date |
| Recent Hires        | Employees who started within the last 30 days                        |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr.tsx
  * src/cores/hr/pages/LifecycleOverview\.tsx
  * src/cores/hr/hooks/employees/useLifecycleStats.ts
</Accordion>
