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 PDMP Monitoring screen displays PDMP query history for a specific patient chart at the in-app route /cl/pdmp.

​
Overview

The PDMP Monitoring page loads when a chartId query parameter is present in the URL; without it the page renders a “No Chart Selected” empty state prompting the user to navigate to a patient chart first. When a chart is provided, the PdmpResultsView component fetches the patient’s PDMP query history from cl_pdmp_queries via usePdmpQueryList. Each query entry shows the datetime, gateway provider badge, attestation status, and a risk-flag badge. Users can expand any entry to view prescription count, risk indicators (daily MME, overlapping prescriptions, multiple prescribers, multiple pharmacies), exception type, and interstate query details. Queries that have not yet been attested show an “Attest” button (guarded by cl.pdmp.queries.create) that opens a PdmpAttestationDialog.

​
Who it’s for

Requires permission cl.pdmp.queries.view.

​
Before you start

  • Permission cl.pdmp.queries.view must be granted.
  • Navigate to this page from a patient chart context that passes a chartId query parameter; the standalone route at /cl/pdmp without a chartId renders an empty prompt.

​
Steps

1

Open a patient chart

Navigate to the patient’s chart. The PDMP history link passes the chartId as a query parameter to /cl/pdmp.
2

Review query entries

The page lists PDMP query records in reverse-chronological order. Each entry shows the query datetime, gateway provider, and attestation status.
3

Check risk flags

Each entry displays a “Risk Flags” badge (destructive) if any of the following are present: overlapping prescriptions, multiple prescribers, multiple pharmacies, or daily MME at or above the configured threshold. “No Risk Flags” (outline) indicates none were detected.
4

Expand details

Click “View Details” on any entry to see prescription count, risk indicator breakdown, exception type (if the query failed), and interstate query states.
5

Attest a query (if permitted)

If you hold the cl.pdmp.queries.create permission and the query has not been attested, click “Attest” to open the attestation dialog and record your attestation.

​
Key concepts

The component surfaces four boolean/numeric risk indicators from results_summary.risk_indicators: overlapping_prescriptions, multiple_prescribers, multiple_pharmacies, and mme_daily. A daily MME value is highlighted in destructive styling when it meets or exceeds the threshold constant in code.
If no queries are recorded for the chart, an empty state is shown. If the fetch fails, a sanitized error message is displayed inside the card. If no chartId query parameter is provided, a full-page “No Chart Selected” card is shown.
When interstate_query is true on a record, the detail expansion lists the states_queried array.

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/PdmpHistoryPage.tsx
  • src/cores/cl/components/PdmpResultsView.tsx
  • src/cores/cl/types/pdmp.ts