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 Ambient Review screen is a queue at /cl/ambient-review that lists all ambient recording sessions for the current organisation, with a status filter and row-level navigation to the detail review page.

​
Overview

The screen renders an “Ambient Review Queue” card with a status-filter dropdown in the header. Each session row shows patient name, provider name, session start date and time, and a processing-status badge. Rows are ordered by session_start descending (most recent first). Only sessions where deleted_at IS NULL for the current organisation are fetched. Clicking any row navigates to /cl/ambient-review/:sessionId for detail review and approval actions.

​
Who it’s for

Requires the cl.ambient.view permission.

​
Before you start

  • The cl.ambient.view permission must be assigned to your role.
  • The current organisation must have ambient sessions recorded in cl_ambient_sessions; otherwise the empty state is shown.

​
Steps

1

Open the ambient review queue

Navigate to /cl/ambient-review. The queue loads all non-deleted sessions for your organisation, most recent first.
2

Filter by processing status (optional)

Use the status dropdown in the card header to narrow the list. Available statuses are: Recording, Processing, Draft Ready, Approved, Failed, Cancelled. Select “All Statuses” to clear the filter.
3

Read the session row

Each row shows the patient name, provider name, and session start date/time alongside a colour-coded status badge.
4

Open a session for review

Click any row to navigate to the session detail page at /cl/ambient-review/:sessionId where review and approval actions are available.

​
Key concepts

processing statuses and their display labels, exactly as defined in code:
StatusDisplay label
recordingRecording
processingProcessing
draft_readyDraft Ready
approvedApproved
failedFailed
cancelledCancelled
The approval mutation (useApproveAmbientSession) only succeeds when the session is currently in draft_ready status; the DB update is conditional on that state.
When no sessions exist (or none match the current filter) the card body shows “No ambient sessions — Ambient recording sessions will appear here for review and approval.”
If the query fails the card body shows “Failed to load sessions. Please try again.” in destructive text.
While fetching, five skeleton rows are shown inside the card.

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/AmbientReviewQueuePage.tsx
  • src/cores/cl/ai-documentation/hooks/useAmbientSession.ts
  • src/cores/cl/ai-documentation/types/ambient.ts