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

# Quality Measures

> HEDIS and MA STARS measure period results showing denominator, numerator, and rate by measure ID with year and type filtering.

The Quality Measures screen displays measure period results from `cl_quality_measure_periods` at the in-app route `/cl/population-health/quality-measures`.

## Overview

The Quality Measures page is gated by `cl.quality-measures.view` via `PermissionGate`. A tab bar allows switching between `HEDIS` and `MA STARS` measure types, and a year selector (current year and the two preceding years) sets the reporting period. The page fetches measure periods via `useQualityMeasurePeriods` for the selected type and full-year date range. Results are displayed in a table with columns for Measure (measure ID plus a human-readable label from `MEASURE_ID_LABELS`), Type (badge), Denominator count, Numerator count, and Rate (formatted as a percentage). An "Export Measure Data" button is present but currently disabled. Below the table, a `HedisFuhFumPanel` component renders a HEDIS FUH/FUM compliance summary.

## Who it's for

Requires permission `cl.quality-measures.view`.

## Before you start

* Permission `cl.quality-measures.view` must be granted.
* Measure period data must have been populated in `cl_quality_measure_periods` for the selected year and measure type.

## Steps

<Steps>
  <Step title="Select the measure type">
    Use the HEDIS / MA STARS tab bar to choose the measure set to view.
  </Step>

  <Step title="Select the reporting year">
    Use the year dropdown to pick a reporting year (current year or up to two prior years). The table reloads for the full January–December period.
  </Step>

  <Step title="Review the measure table">
    Each row shows the measure ID and its label, type badge, denominator count, numerator count, and calculated rate as a percentage.
  </Step>

  <Step title="Review the FUH/FUM panel">
    Below the table, the HEDIS FUH/FUM compliance summary panel shows follow-up after hospitalization/ED visit data.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Measure type values">
    `HEDIS` and `MA_STARS` — from `MeasureType` in `src/cores/cl/types/quality-measure-periods.ts`.
  </Accordion>

  <Accordion title="Measure ID labels">
    The following measure IDs are defined in code: `AMM` (Antidepressant Medication Management), `FUH` (Follow-Up After Hospitalization for Mental Illness), `FUM` (Follow-Up After Emergency Department Visit for Mental Illness), `ADD`, `SAA`, `SSD`, `APM`, `IET`, `IET-COD`. Unlabeled IDs render their raw identifier.
  </Accordion>

  <Accordion title="Rate formatting">
    Rates are stored as decimals (0.0–1.0) and displayed as percentages with one decimal place. A null or missing rate renders as `—`.
  </Accordion>

  <Accordion title="Empty and error states">
    When no data is available for the selected period, an EmptyState component is shown with the message "No measure data for this period." A skeleton table (4 rows) is shown while loading.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Clinical" icon="stethoscope" href="/cl/overview">
    Overview of the Clinical core.
  </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/cl.tsx
  * src/cores/cl/pages/population-health/QualityMeasuresPage.tsx
  * src/cores/cl/types/quality-measure-periods.ts
</Accordion>