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

# Compensation Analysis

> View and create compensation analyses including internal equity, market comparison, and distribution reports.

Compensation Analysis is available at route `/hr/compensation/analysis`. Access follows your organization's role and module configuration. ## Overview

The Compensation Analysis page presents a tabbed interface (list view and additional views). The main data table shows analyses with columns for date, analysis type (`internal_equity`, `market_comparison`, `distribution`), status badge, equity score, and recommendation count. An equity analysis section rendered by `EquityScoreGauge` and `EquityDisparityTable` provides organization-wide equity visualization. A dialog (triggered by a **New Analysis** button) contains `CompensationAnalysisForm` for creating new analyses. The list is loaded via `useCompensationAnalysisList` and equity data via `useEquityAnalysis`.

## Who it's for

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

* Compensation data and employee records must exist for meaningful analysis results.

## Steps

<Steps>
  <Step title="Open Compensation Analysis">Navigate to `/hr/compensation/analysis`.</Step>
  <Step title="Review existing analyses">Check the data table for prior analyses with their dates, types, statuses, and scores.</Step>
  <Step title="Create a new analysis">Click the new analysis button, complete `CompensationAnalysisForm`, and submit.</Step>
  <Step title="Review equity metrics">Examine the `EquityScoreGauge` and `EquityDisparityTable` for organization-wide equity status.</Step>
</Steps>

## Key concepts

| Term                         | Meaning in code                                                       |
| ---------------------------- | --------------------------------------------------------------------- |
| `analysis_type`              | `internal_equity`, `market_comparison`, `distribution`                |
| `CompensationAnalysisStatus` | `draft`, `reviewed`, `approved`, `implemented`                        |
| `equity_score`               | Numeric score displayed in the gauge; scale requires SME confirmation |
| `EquityDisparityTable`       | Component showing compensation disparities across groups              |

## Creating a compensation analysis

New analyses are created via a dialog launched from the `/hr/compensation/analysis` list page. The path `/hr/compensation/analysis/new` is referenced in the platform navigation label registry but has no dedicated `<Route>` entry in the HR router; direct navigation to that path may produce a 404.

`CompensationAnalysisForm` inside the dialog handles the creation form.

Before you start: compensation data and employee records must exist for meaningful analysis results.

1. Navigate to `/hr/compensation/analysis`.
2. Click the **New Analysis** button to open the creation dialog.
3. Complete `CompensationAnalysisForm` and submit.

## 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">
    Documentation coverage and governance.
  </Card>
</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/compensation/pages/CompensationAnalysisPage.tsx
  * src/cores/hr/compensation/hooks/useCompensationAnalysisList.ts
  * src/cores/hr/compensation/hooks/useEquityAnalysis.ts
  * src/platform/navigation/route-labels.ts
</Accordion>