The Care Gaps screen is a population-health work list atDocumentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
/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 fromcl_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 thecl.care-gaps.view permission. The “Close” button additionally requires cl.care-gaps.close.
Before you start
- The
cl.care-gaps.viewpermission must be assigned to your role. - Open care gaps must exist in
cl_care_gapsfor the current organisation; otherwise the empty state is shown. - If only one site exists for the organisation the site filter is not displayed.
Steps
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.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.
Filter by priority (optional)
Use the “Priority” dropdown to show Critical, Urgent, or Routine gaps only.
Filter by site (optional)
If multiple sites exist, use the “Site” dropdown to scope the list to a specific site.
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.
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.Key concepts
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 |
critical (destructive badge), urgent (default badge), routine (secondary badge).
Risk tiers: low (outline), medium (secondary), high (default), critical (destructive).
Empty state
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.”
Loading state
Loading state
Five skeleton rows are shown while the query is in flight.
Related
Clinical
Overview of the Clinical core.
Governance & parity
Documentation coverage and governance.
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.
Documentation sources
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