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.

This screen displays the detail of a single Level-of-Care assessment record at route /cl/loc-assessments/:assessmentId.

​
Overview

The LoC Assessment detail page loads a single assessment from the cl_loc_assessments table using the assessmentId URL parameter. It displays the instrument type (ASAM or LOCUS), the date and time of the assessment, and a status badge (draft, finalized, or amended). The Summary tab shows a dimensional profile radar chart and a recommendation card. When a prior assessment exists for the same patient and instrument type, a Comparison tab appears showing side-by-side dimension scores. For draft assessments, action buttons allow the clinician to accept the computed recommendation or open an override dialog to record a different Level-of-Care with a reason category and rationale.

​
Who it’s for

Requires the cl.loc_assessment.view permission. The Override button additionally requires cl.loc_assessment.override. The Accept Recommendation button additionally requires cl.loc_assessment.sign.

​
Before you start

  • You must hold the cl.loc_assessment.view permission for your organization.
  • The assessment must exist in the system; navigating to an unknown assessmentId renders an “Assessment not found” message with a link back to the list.
  • To finalize with an override, you must also hold cl.loc_assessment.override and cl.loc_assessment.sign.

​
Steps

1

Open an assessment from the list

Navigate to /cl/loc-assessments and select a record, or follow a direct link to /cl/loc-assessments/:assessmentId.
2

Review the Dimensional Profile

On the Summary tab, inspect the radar chart showing per-dimension scores. If a prior assessment exists, a previous-score overlay is rendered for comparison.
3

Review the recommendation card

The Recommendation card displays the system-computed recommended_loc value derived from computeLocRecommendation. If a final LoC has been set and differs from the recommendation, the card indicates the assessment is overridden.
4

Compare with a prior assessment (if available)

If a prior assessment exists for the same patient and instrument type, select the Comparison tab to view the LocAssessmentComparisonView side-by-side display.
5

Accept the recommendation or override (draft only)

For draft assessments, either click Accept Recommendation to finalize with the computed LoC, or click Override (requires cl.loc_assessment.override) to open the LocOverrideDialog. In the dialog, select a reason category and enter a rationale of at least 20 characters, then confirm.

​
Key concepts

The instrument_type field is either asam or locus. ASAM assessments use six dimensions (acute_intoxication, biomedical_conditions, emotional_behavioral_cognitive, readiness_to_change, relapse_continued_use, recovery_environment). LOCUS assessments use six dimensions (risk_of_harm, functional_status, medical_comorbidity, recovery_environment, treatment_history, engagement).
The status field follows the values draft, finalized, and amended. Action buttons for accepting a recommendation or overriding are only visible when status === 'draft'.
An override occurs when the final_loc set on the assessment differs from recommended_loc. An override requires a OverrideReasonCategory selection and a rationale string; the database enforces a minimum rationale length of 20 characters.
If the assessment record is not found or does not belong to the current organization, the page renders: “Assessment not found.” with a Back to List button.

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/LocAssessmentDetailPage.tsx
  • src/cores/cl/hooks/useLocAssessments.ts
  • src/cores/cl/types/loc-assessment.ts