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

# Fingerprint Clearance

> Manage employee fingerprint clearance card records — view status, track expiring cards, add new records, and trigger AI-assisted updates.

The Fingerprint Clearance page (`/hr/fingerprint-clearance`) lists all fingerprint clearance card records for the organization with status tabs, stat cards, and management actions for creating and updating clearance records.

## Overview

The page shows four stat cards: Total records, Active, Expiring (within 90 days), and Suspended/Revoked. Tabs filter the list: All, Active, Expiring, Suspended. The `FingerprintClearanceList` component renders the filtered records. When a record is selected, a detail dialog (`FingerprintClearanceDetailDialog`) opens.

Users with the `hr.fingerprint_clearance.manage` permission see additional action options: a **New Record** button opens `FingerprintClearanceForm`, and an action dropdown provides an **AI-Assisted Wizard** (`FingerprintClearanceWizard` in create or update mode).

## Who it's for

Access follows your organization's role and module configuration. wraps the page route itself. Management actions (New Record, AI Wizard) are gated by `hr.fingerprint_clearance.manage` (checked via `useHasPermission`).

## Before you start

* To add or update clearance records, you need the `hr.fingerprint_clearance.manage` permission.
* Employee records must exist for the employees you are tracking clearances for.

## Steps

1. Navigate to **HR → Fingerprint Clearance** or go to `/hr/fingerprint-clearance`.
2. Review the stat cards for a summary of clearance status.
3. Use the tabs to filter by status (All, Active, Expiring, Suspended).
4. Click a record in the list to open the detail dialog.
5. (If authorized) Click **New Record** or use the dropdown to open the AI-Assisted Wizard to create or update a clearance record.

## Key concepts

| Concept             | Meaning                                                       |
| ------------------- | ------------------------------------------------------------- |
| Active              | Clearance card is current and valid                           |
| Expiring            | Card expires within 90 days                                   |
| Suspended / Revoked | Card is no longer in good standing — SME: confirm distinction |

## 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/FingerprintClearanceDashboardPage.tsx
  * src/cores/hr/hooks/fingerprint-clearance/useFingerprintClearanceList.ts
</Accordion>