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

# Care Gaps

> Paginated work list of open population-health care gaps detected by automated rules, with gap-type, priority, and site filters.

The Care Gaps screen is a population-health work list at `/cl/population-health/care-gaps` that displays open care gaps detected by automated rules, with filtering, risk-tier context, and the ability to close individual gaps.

## Overview

The screen loads open care gaps from `cl_care_gaps` for the current organisation, paginated at 25 per page. Each row shows patient name (resolved from the linked chart's profile), risk tier badge with composite risk score, gap type label, priority badge, detected date, and due date. The hook enriches each row with the most-recent risk stratification from `cl_risk_stratifications` for that chart. Rows are sorted client-side by composite risk score descending then due date ascending within each page. Clicking any row opens a `GapDetailSheet` side panel. Users with the `cl.care-gaps.close` permission see a "Close" button per row that opens a `CloseGapDialog`.

## Who it's for

Requires the `cl.care-gaps.view` permission. The "Close" button additionally requires `cl.care-gaps.close`.

## Before you start

* The `cl.care-gaps.view` permission must be assigned to your role.
* Open care gaps must exist in `cl_care_gaps` for the current organisation; otherwise the empty state is shown.
* If only one site exists for the organisation the site filter is not displayed.

## Steps

<Steps>
  <Step title="Open the care gap work list">Navigate to `/cl/population-health/care-gaps`. The table loads the first 25 open care gaps for your organisation.</Step>
  <Step title="Filter by gap type (optional)">Use the "Gap Type" dropdown to show gaps of a specific type: Overdue PHQ-9, Overdue GAD-7, Plan Not Reviewed, No Recent Contact, Assessment Expired, or Follow-Up Not Scheduled.</Step>
  <Step title="Filter by priority (optional)">Use the "Priority" dropdown to show Critical, Urgent, or Routine gaps only.</Step>
  <Step title="Filter by site (optional)">If multiple sites exist, use the "Site" dropdown to scope the list to a specific site.</Step>
  <Step title="Review risk tier and score">For each row, the Risk Tier column shows a colour-coded badge (low / medium / high / critical) and the numeric composite risk score from the most-recent risk stratification.</Step>
  <Step title="Open gap detail">Click any row to open the GapDetailSheet side panel for full gap details.</Step>
  <Step title="Close a gap (requires cl.care-gaps.close)">Click "Close" on a row to open the CloseGapDialog. Provide a closure type and optional override reason, then confirm to record the closure via `useCareGapClose`.</Step>
  <Step title="Navigate pages">Use the "Previous" / "Next" buttons at the bottom of the table to page through results when the total gap count exceeds 25.</Step>
</Steps>

## Key concepts

<Tooltip tip="Care gap — an open record in cl_care_gaps representing a population-health finding that an automated rule has detected for a patient chart.">Care gap</Tooltip> types supported in the filter (labels from component code):

| Code                      | Display label           |
| ------------------------- | ----------------------- |
| `overdue_phq9`            | Overdue PHQ-9           |
| `overdue_gad7`            | Overdue GAD-7           |
| `plan_not_reviewed`       | Plan Not Reviewed       |
| `no_contact`              | No Recent Contact       |
| `assessment_expired`      | Assessment Expired      |
| `follow_up_not_scheduled` | Follow-Up Not Scheduled |

Priority levels: `critical` (destructive badge), `urgent` (default badge), `routine` (secondary badge).

Risk tiers: `low` (outline), `medium` (secondary), `high` (default), `critical` (destructive).

<AccordionGroup>
  <Accordion title="Empty state">
    When no open gaps match the current filters the screen shows "No care gaps found — No open care gaps match the current filters. Gaps are detected by automated rules running daily."
  </Accordion>

  <Accordion title="Loading state">
    Five skeleton rows are shown while the query is in flight.
  </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/CareGapWorkListPage.tsx
  * src/cores/cl/hooks/useCareGapList.ts
  * src/cores/cl/types/care-gaps.ts
  * src/cores/cl/types/risk-stratifications.ts
</Accordion>