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

# Time & Scheduling

> The Time & Scheduling page is the overview hub for the time and scheduling domain, displaying status cards and contextual widgets for both employees and…

The Time & Scheduling page is the overview hub for the time and scheduling domain, displaying status cards and contextual widgets for both employees and managers. It is served at route `/hr/time`.

## Overview

The page uses `useTimeSchedulingStats` to populate four stat cards: Today's Shifts, Open Shifts, Pending Approvals, and Swap Requests. Manager-specific content is controlled by `useHasPermission('hr.time.approve')`. Widgets rendered include `TimeClockWidget`, `TimeClockStatusWidget`, `TimesheetSummaryWidget`, `TodaysScheduleWidget`, and `CoverageSummaryWidget`. A refresh button re-fetches stats.

No `RequirePermission` guard wraps this route.

## Who it's for

Access follows your organization's role and module configuration. Manager-specific widgets appear when the user has `hr.time.approve` permission.

## Before you start

* None required; the page is accessible to all users with HR access.

## Steps

1. Navigate to **HR > Time** or go to `/hr/time`.
2. Review the four stat cards for a quick status snapshot.
3. Use the **Time Clock Widget** to clock in or out.
4. Navigate to sub-pages via widget links:
   * Today's schedule → scheduling views
   * Timesheets → `/hr/my-timesheets`
   * Team timesheets (managers) → `/hr/team-timesheets`

## Key concepts

| Term              | Meaning                                                              |
| ----------------- | -------------------------------------------------------------------- |
| Open shifts       | Scheduled shifts without a confirmed assignment for the current day. |
| Pending approvals | Submitted timesheets awaiting manager approval.                      |
| Swap requests     | Pending shift swap requests requiring action.                        |
| Coverage summary  | Manager widget showing shift coverage status.                        |

## 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/TimeOverview\.tsx
  * src/cores/hr/hooks/time/useTimeSchedulingStats.ts
</Accordion>