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

# My Panel

> This screen shows the logged-in clinician's attributed patient panel and is accessible at /cl/population-health/my-panel.

This screen shows the logged-in clinician's attributed patient panel and is accessible at `/cl/population-health/my-panel`.

## Overview

The My Panel page shows the clinician's attributed patients in a summary card grid and a patient table. Four summary cards display Panel Size, Avg Risk Score, Open Gaps, and Last Refresh. The patient table columns are Patient (last, first), Risk Tier (badge), Risk Score (numeric), and Actions. The Actions column provides three icon buttons per patient: open chart (`/cl/charts/:chartId`), view care gaps for that patient (`/cl/population-health/care-gaps?chart=:chartId`), and schedule an encounter (`/pm/scheduling/new?patient=:patientId`). Data is loaded by `useRiskStratifications` (patient-level risk data from `cl_risk_stratifications`) and `useCareGapList` (open gap counts per chart, up to 200 records). Small-cell suppression via `maskSmallCell` is applied to the Panel Size and Open Gaps card values.

## Who it's for

Requires the `cl.care-gaps.view` permission (enforced by both `RequirePermission` in `cl.tsx` and a `PermissionGate` inside the component).

## Before you start

* You must hold `cl.care-gaps.view` to access this page.
* The panel is populated from `cl_risk_stratifications` rows for the current organization; no patients will appear if no stratifications exist for your panel.

## Steps

<Steps>
  <Step title="Navigate to My Panel">
    Open the Clinical core and go to `/cl/population-health/my-panel`. Summary cards load immediately showing Panel Size, Avg Risk Score, Open Gaps, and Last Refresh.
  </Step>

  <Step title="Review panel summary cards">
    The four cards show aggregate metrics for your attributed panel. "Last Refresh" is the most recent `stratification_date` across all panel rows.
  </Step>

  <Step title="Review the patient table">
    The table lists each attributed patient with their Risk Tier badge and composite risk score. Rows with higher risk scores appear first (ordered by `composite_risk_score` descending in `useRiskStratifications`).
  </Step>

  <Step title="Open a patient chart">
    Click the external link icon in the Actions column to open that patient's chart at `/cl/charts/:chartId`.
  </Step>

  <Step title="View open care gaps for a patient">
    Click the filter icon in the Actions column to navigate to the care gaps work list filtered to that patient.
  </Step>

  <Step title="Schedule an encounter for a patient">
    Click the calendar-plus icon in the Actions column to open the scheduling screen pre-populated with the patient ID.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Risk tier badge variants">
    The Risk Tier badge renders using: `low` → outline, `medium` → secondary, `high` → default, `critical` → destructive. Labels come from `RISK_TIER_LABELS` in the `risk-stratifications` type module.
  </Accordion>

  <Accordion title="Empty and error states">
    If no stratifications exist, an empty state shows "No patients in your panel" with the attribution explanation. If the query errors, an empty state shows "Unable to load panel — An error occurred."
  </Accordion>

  <Accordion title="Small-cell suppression">
    Panel Size and Open Gaps values are passed through `maskSmallCell` (imported from `usePopulationDashboard`). The threshold and output of suppression are not visible in this component — SME confirmation of the privacy basis is recommended.
  </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/ClinicianPanelPage.tsx
  * src/cores/cl/hooks/useRiskStratifications.ts
  * src/cores/cl/hooks/useCareGapList.ts
</Accordion>