Skip to main content

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.

The Clinician Panels screen provides a supervisor-level overview of all clinician panel assignments and population health metrics at route /cl/population-health/panels.

Overview

The page displays a table of all clinicians who have active patient panels, drawn from cl_patient_charts.assigned_clinician_id. For each clinician the table shows panel size (number of assigned charts), average risk score (mean of composite_risk_score from cl_risk_stratifications), open gap count (count of cl_care_gaps with status = 'open'), and the date of the last risk stratification refresh. Clicking a clinician row navigates to that clinician’s individual panel at /cl/population-health/my-panel?clinicianId=<id>. A collapsible section below the main table lists patients whose charts have no assigned clinician (assigned_clinician_id is null); each row links to the patient chart at /cl/charts/<chartId>. The table is sorted by open gap count descending. If no clinicians have active panels, an empty state is shown with guidance that panel attribution runs daily.

Who it’s for

Requires permission cl.population-dashboard.view.

Before you start

  • You must hold the cl.population-dashboard.view permission.
  • Clinician panels are populated from cl_patient_charts. If no data appears, verify that charts have assigned_clinician_id values set and that risk stratifications have been run.

Steps

1

Open the Clinician Panels screen

Navigate to /cl/population-health/panels. The table loads with a skeleton state while data is fetched.
2

Review the panel summary table

Each row shows a clinician’s name, panel size, average risk score, open gap count, and last refresh date. Rows are sorted by open gap count (highest first).
3

Drill into a clinician's panel

Click any clinician row to navigate to that clinician’s individual panel view at /cl/population-health/my-panel?clinicianId=<id>.
4

Review unattributed patients

Click the “Unattributed Patients (N)” button to expand the collapsible section. Use “Open Chart” on any row to navigate to that patient’s chart.

Key concepts

  • No clinicians with active panels — shown when clinicians array is empty. The empty state message reads: “Panel attribution runs daily. Ensure patients have recent encounters or explicit clinician assignments.”
  • No unattributed patients — shown inside the collapsible when unattributedPatients array is empty.
Query results are cached with a 5-minute stale time (staleTime: 5 * 60 * 1000). The “Last Refresh” column reflects the most recent stratification_date from cl_risk_stratifications for that clinician’s charts.

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.
  • src/routes/cl.tsx
  • src/cores/cl/pages/population-health/SupervisorPanelsPage.tsx
  • src/cores/cl/hooks/useClinicianPanelSummary.ts