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

# HR Incidents

> View and manage employee relations incidents — filter by type and status, review details with documents, and edit records.

The Incidents page (`/hr/employee-relations/incidents`) lists all employee relations incident reports for the organization, with filtering and a new-incident creation action.

## Overview

The page renders the incident list via the `IncidentListPage` component. Filtering options include incident type, status, severity, and date range (SME: confirm exact filter set from `IncidentListPage`). A **New Incident** button navigates to `/hr/employee-relations/incidents/new`. Each row links to `/hr/employee-relations/incidents/:id` for full detail. Row actions include edit (navigates to the edit form).

## Who it's for

Access follows your organization's role and module configuration.

## Before you start

* Incidents are filed via the new incident form.

## Steps

1. Navigate to **HR → Employee Relations → Incidents** or go to `/hr/employee-relations/incidents`.
2. Use filters to narrow the list by type, severity, or date.
3. Click an incident row to view the full detail.
4. Click **New Incident** to file a new incident report.

## Viewing an incident

The Incident Details page (`/hr/employee-relations/incidents/:id`) displays a single incident record with severity badge, incident type, date and time, location, description, and associated documents, with an option to edit the incident.

The page uses `useIncidentDetail` to load the incident by `:id` and sets a breadcrumb to the incident type label (formatted from snake\_case). A severity badge is shown with destructive styling for `critical`, default for `serious`, secondary for `moderate`, and outline for `minor`. A date, time, and location card and a description card are displayed. The `CaseDocuments` component renders associated documents. An **Edit** button navigates to `/hr/employee-relations/incidents/:id/edit`. Organization context (`currentOrganization`) is available for permission scoping.

Before you start: the incident record must exist in your organization.

1. Navigate to **HR → Employee Relations → Incidents** and click an incident row, or go to `/hr/employee-relations/incidents/:id`.
2. Review the incident severity, type, date, time, and location.
3. Read the description and review attached documents.
4. Click **Edit** to update the incident record.

**Key detail concepts:**

| Concept       | Meaning                                           |
| ------------- | ------------------------------------------------- |
| Severity      | Impact level: critical, serious, moderate, minor  |
| Incident type | Category of the incident — SME: confirm full list |

## Editing an incident

The Edit Incident page provides a form for updating an existing workplace incident record. It is available at route `/hr/employee-relations/incidents/:id/edit`. The route renders `IncidentFormPage` in edit mode (`isEdit = true`, because the `id` param is present). The existing record is fetched via `useIncidentDetail`. The form normalizes `incident_type` and `severity` against known valid sets before submitting. Valid incident types from code: `accident`, `injury`, `safety_violation`, `property_damage`, `near_miss`, `other`. Valid severities: `minor`, `moderate`, `serious`, `critical`. On submit, `updateMutation` is called.

Before you start: navigate from an incident detail page at `/hr/employee-relations/incidents/:id`.

1. From an incident detail page, click the edit action. You land on `/hr/employee-relations/incidents/:id/edit`.
2. Update type, severity, description, or other fields.
3. Submit the form. On success, you are redirected to the detail 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/employee-relations-routes.tsx
  * src/cores/hr/employee-relations/pages/IncidentListPage.tsx
  * src/cores/hr/employee-relations/pages/IncidentDetailPage.tsx
  * src/cores/hr/employee-relations/pages/IncidentFormPage.tsx
  * src/cores/hr/employee-relations/hooks/useIncidentDetail.ts
  * src/cores/hr/employee-relations/hooks/useIncidentMutation.ts
</Accordion>