HR Incidents

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:

​

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

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