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

# Workforce

> The Workforce page is the top-level HR dashboard, providing stat cards, area navigation, and quick actions for the HR core. It is served at route /hr.

The Workforce page is the top-level HR dashboard, providing stat cards, area navigation, and quick actions for the HR core. It is served at route `/hr`.

## Overview

`HROverview` uses `useHRDashboardStats` to populate stat cards: Active Employees, Departments, Positions, and a combined Pending Approvals count. Area navigation cards link to major HR sub-sections. `QuickActionsSection` provides shortcut buttons. `useOrganization` provides the current organization context.

Permission: `HR_PERMISSIONS.DASHBOARD_VIEW` — `RequirePermission` guard in `hr.tsx`. Also accessible at `/hr/dashboard` (same component).

Alternate route: `/hr/dashboard`.

## Who it's for

Permission: `hr.dashboard.view` (mapped via `HR_PERMISSIONS.DASHBOARD_VIEW`) — required by `RequirePermission` guard in `hr.tsx`.

## Before you start

* None required; this is the HR core entry point.

## Steps

1. Navigate to **HR** in the main navigation or go to `/hr`.
2. Review stat cards for a quick workforce snapshot.
3. Use the area navigation cards to jump to a specific HR domain (employees, scheduling, payroll, etc.).
4. Use quick action buttons for common tasks.

## Key concepts

| Term                            | Meaning                                                                   |
| ------------------------------- | ------------------------------------------------------------------------- |
| Pending approvals               | Combined count of pending leave requests and pending timesheet approvals. |
| Area navigation card            | `AreaNavigationCard` component linking to a major HR sub-section.         |
| HR\_PERMISSIONS.DASHBOARD\_VIEW | Permission key `hr.dashboard.view` required to access this page.          |

## 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/HROverview\.tsx
  * src/cores/hr/hooks/settings/useHRDashboardStats.ts
</Accordion>