The Patient Charts screen (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.
/cl/charts) is the clinical patient chart registry — a searchable list of all patient charts for the organization.
Overview
The page loads charts fromcl_patient_charts joined to pf_patient_identities (MRN) and pm_patients (first/last name) via useChartList. When a search term is provided, up to 200 charts (CHART_SEARCH_LIMIT) are fetched and filtered client-side by chart number, MRN, full name, and reversed name. Without a search, all non-deleted charts for the organization are returned ordered by created_at descending. Each chart row is a clickable link to /cl/charts/:chartId and displays a name avatar with initials, full name or fallback chart number, chart number and MRN, a ClinicalUrgencyIndicator if current_risk_level is set, and an active/secondary status badge. Charts with urgency critical or high render with an urgency-specific border class.
Who it’s for
Requires permission:cl.charts.view
Before you start
You must hold thecl.charts.view permission. Charts are scoped to your organization. Patient identity data (name, MRN) is PHI — handle per your organization’s privacy policy and applicable regulations.
Steps
Navigate to /cl/charts
Open the Clinical module and navigate to Patient Charts. The registry loads all non-deleted charts for your organization.
Search for a patient chart
Type in the search box to filter by patient name, MRN, or chart number. The search field also supports reversed name order (last name first).
Key concepts
Search behavior
Search behavior
Search is client-side after a server fetch limited to 200 rows. Matches on chart number, MRN,
first last, and last first name combinations. No pagination UI is present in this version.Risk level display
Risk level display
If
current_risk_level is present on a chart record, a ClinicalUrgencyIndicator renders the value as an uppercase label. Charts with critical or high urgency also receive an urgency border class on the card.Empty state
Empty state
When no charts match, the page shows: “No patient charts — Patient charts will appear here once created.”
Error state
Error state
If the data fetch fails, a destructive card renders the sanitized error message above the chart list.
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/ChartListPage.tsx
- src/cores/cl/hooks/useChartList.ts
- src/cores/cl/components/ClinicalUrgencyIndicator.tsx
- src/cores/cl/components/clinicalUrgencyUtils.ts