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

> The Time Analytics page provides visual analytics for time exceptions — trends, type distribution, department breakdown, and resolution metrics — with a date…

The Time Analytics page provides visual analytics for time exceptions — trends, type distribution, department breakdown, and resolution metrics — with a date range picker and CSV export. It is served at route `/hr/time/analytics`.

## Overview

The page uses `useTimeExceptionAnalytics` with a `dateRange` object (default: last 30 days). Chart components rendered include `ExceptionTrendChart`, `ExceptionTypeDistributionChart`, `DepartmentExceptionChart`, `ResolutionMetricsCard`, and `TopExceptionsTable`. A date range picker allows custom time windows. A **Download CSV** button exports trend data (Date, Total, Critical, Warning, Info columns).

## Who it's for

Access follows your organization's role and module configuration. ## Before you start

* Time exceptions must be recorded before analytics data appears.

## Steps

1. Navigate to **HR > Time > Analytics** or go to `/hr/time/analytics`.
2. Use the date range pickers to select a custom analysis window (default: last 30 days).
3. Review the exception trend line chart for volume over time.
4. Examine the type distribution, department breakdown, and resolution metrics.
5. Review the **Top Exceptions Table** for the highest-volume exception types.
6. Click **Download CSV** to export trend data for the selected date range.

## Key concepts

| Term               | Meaning                                                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| Exception type     | Category: missed\_clock\_in, missed\_clock\_out, late\_arrival, early\_departure, overtime\_unauthorized, overtime\_approaching. |
| Trend data         | Daily counts of exceptions by severity (critical, warning, info).                                                                |
| Resolution metrics | Statistics on how exceptions were resolved. SME: confirm scope.                                                                  |

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