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 Patient Chart screen displays the comprehensive clinical record for one patient at route /cl/charts/:chartId.

​
Overview

The Patient Chart page loads a single cl_patient_charts row (filtered by organization_id) and renders a sticky PatientBanner showing patient name, MRN, allergy count, and active problem count. A contextual sidebar replaces the module navigation on desktop, providing chart section tabs with badge counts for draft notes, pending consents, and high-risk screening results. On mobile, a bottom sheet handles section navigation. A CdsAlertsPanel appears above content whenever CDS (clinical decision support) alerts are present for the chart. Quick-action buttons for new note, record vitals, new screening, and order-set activation are always available. A “Generate C-CDA” button is shown when the user holds the cl.cda.view permission.

​
Who it’s for

Requires permission: cl.charts.view Individual chart sections enforce additional scoped permissions (e.g., cl.progress_note.view, cl.medications.view, cl.results.view) via PermissionGate.

​
Before you start

  • Must hold cl.charts.view permission to reach this page.
  • The chart must exist and not be soft-deleted (deleted_at IS NULL).

​
Steps

1

Open a chart

Navigate to /cl/charts, select a row, or follow any deep-link to /cl/charts/:chartId. The sticky Patient Banner loads immediately with name, MRN, allergy count, and active-problem count.
2

Select a section tab

Use the contextual sidebar (desktop) or bottom-sheet (mobile) to switch between sections: Summary, Timeline, Notes, Assessments, COD Assessments, Treatment Plans, Orders, Labs, PDMP, Medications, Allergies, Risk, Vitals, SDOH, Care Team, Outcomes, Transitions, Peer, Discharge, Consents, Disclosures.
3

Act on quick actions

Use the floating ChartQuickActions buttons to open a new note form (navigates to Notes tab), record vitals, start a risk screening, or launch an order-set activation dialog.
4

Generate C-CDA (optional)

If cl.cda.view is held, click “Generate C-CDA” to navigate to /cl/charts/:chartId/cda.
5

Export chart

Click the export button on the Patient Banner to open the ChartExportDialog.

​
Key concepts

Each tab renders a dedicated section component under a PermissionGate. If the user lacks the tab’s permission, the section is not rendered. The active tab is persisted in the URL via the tab query parameter (managed by useTabUrlState).
Three badge counters appear on the sidebar: Notes shows the count of notes with status === 'draft'; Consents shows consents with no revoked_at, no deleted_at, and no signed_by_patient_at; Risk shows 1 when the most recent risk screening has risk_level of high or imminent.
A CODFlagBadge is displayed if the chart’s cod_indicator field is truthy. The COD (co-occurring disorder) indicator enables the COD Assessments tab and the COD section inside Treatment Plans.
On chart load, useCdsLabMonitoring is evaluated for the chart. If evaluation fails, a destructive alert is shown. Any active CDS alerts are displayed in the CdsAlertsPanel above the tabbed content.
If the chart fails to load, a destructive card with a sanitized error message is shown. If the chart ID is not found or is deleted, a “Chart not found” empty-state card is shown.

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/PatientChartPage.tsx
  • src/cores/cl/hooks/useChartDetail.ts