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 Item Detail screen shows a single in-basket item with its full metadata and activity history at /cl/in-basket/:itemId.

​
Overview

The page loads a single in-basket item via useInbasketItemDetail, which returns both the item record and its activity log. A main detail card (spanning 2 of 3 columns) shows item type (human-readable label from TYPE_LABELS), classification, priority badge, status badge, creation date, optional due date, and optional assignee. If the item type is chart_message and the payload contains a conversation_id, an Open Message Thread button deep-links to /pm/messaging/:conversationId. If chart_id is set, a View Patient Chart link navigates to /cl/charts/:chartId. Users with cl.inbasket.manage see a status select dropdown (new, read, in_progress, completed, deferred, escalated). Users with cl.inbasket.escalate additionally see an Escalate button that sets priority to urgent, records escalated_at, and transitions status to escalated. An Activity timeline card (1 column) shows each logged cl_inbasket_item_activity entry in chronological order.

​
Who it’s for

Requires permission cl.inbasket.view. Additional actions require:
  • cl.inbasket.manage — update item status
  • cl.inbasket.escalate — escalate item priority and status

​
Before you start

  • You must have cl.inbasket.view.
  • The item must exist in cl_inbasket_items and be accessible to your organization.

​
Steps

1

Open the item

Navigate to /cl/in-basket, then click an item row. The detail page loads the item and activity timeline.
2

Review item metadata

The main card shows item type, classification, priority badge, status badge, creation date, optional due date, and optional assignee.
3

Open the linked patient chart (if available)

If chart_id is set, click View Patient Chart to navigate to /cl/charts/:chartId.
4

Open the linked message thread (chart_message type only)

If the item type is chart_message and a conversation_id is present in the payload, click Open Message Thread to navigate to /pm/messaging/:conversationId.
5

Update status (manage permission required)

Use the status dropdown (requires cl.inbasket.manage) to transition the item through new → read → in_progress → completed / deferred / escalated. Setting completed also records completed_at.
6

Escalate the item (escalate permission required)

Click Escalate (visible when cl.inbasket.escalate is held and status is not already escalated) to set priority to urgent, record escalated_at, and transition status to escalated.

​
Key concepts

cosign_request, lab_review, refill_request, chart_message, referral_response, cds_alert. The human-readable label is resolved from TYPE_LABELS. Only chart_message items show the message thread deep-link.
low, normal, high, urgent, stat. Priority stat renders a destructive badge; urgent renders a secondary badge; others render outline.
Each entry in cl_inbasket_item_activity is displayed with activity_type (formatted: underscores replaced with spaces) and activity_at timestamp. Activity is created automatically on status changes and escalations via useUpdateInbasketItem.
  • Load error: destructive Alert with sanitized error message and a back link to /cl/in-basket.
  • Item not found: centered Inbox icon with “Item not found” heading and back link.
  • No activity: “No activity recorded yet.”
  • Loading: skeleton for the header and two-column grid.

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/InBasketItemDetailPage.tsx
  • src/cores/cl/hooks/useInbasketItemDetail.ts
  • src/cores/cl/hooks/useInbasketItemMutation.ts
  • src/cores/cl/types/inbasket.ts