> ## 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.

# COD

> The /cl/cod route does not exist as a standalone screen. The active COD route is /cl/cod/caseload, which lists charts flagged as Co-Occurring Disorder.

The `/cl/cod` path is **not a registered route** in the Clinical core router. The active route for Co-Occurring Disorder (COD) work is `/cl/cod/caseload`, which renders the COD Caseload page.

## Overview

`/cl/cod` is **not a registered route**. Navigating to it renders the `NotFound` component. The operational screen lives at `/cl/cod/caseload`, which renders `CODCaseloadPage`.

`CODCaseloadPage` displays charts where `cod_indicator = true` in `cl_patient_charts`. Each row shows:

* Patient name and MRN
* A COD badge
* A "Plan Extension" badge if a `cl_cod_treatment_plan_extension` record exists for the chart
* Total assessment count and last assessment date/type (from `cl_cod_assessments`)

Clicking a row navigates to `/cl/charts/:chartId?tab=cod-assessments`.

## Who it's for

Permission required: `cl.cod_assessments.view` (on the `/cl/cod/caseload` route).

## Before you start

* You need the `cl.cod_assessments.view` permission.
* Charts must have `cod_indicator = true` to appear in this list.

## Steps

<Steps>
  <Step title="Navigate to COD Caseload">
    Go to `/cl/cod/caseload`. The page loads charts flagged as Co-Occurring Disorder for your organization.
  </Step>

  <Step title="Search for a patient">
    Use the search field to filter by patient name or MRN. Filtering is performed client-side on the loaded dataset.
  </Step>

  <Step title="Review assessment status">
    Each row shows the total number of assessments and the date and type of the most recent assessment. A "Plan Extension" badge indicates a treatment plan extension record is present.
  </Step>

  <Step title="Open a chart">
    Click any row to navigate to the patient's chart with the `cod-assessments` tab pre-selected.
  </Step>
</Steps>

## Key concepts

| Term                              | Meaning                                                                                            |
| --------------------------------- | -------------------------------------------------------------------------------------------------- |
| `cod_indicator`                   | Boolean field on `cl_patient_charts` marking a chart as Co-Occurring Disorder                      |
| `cl_cod_assessments`              | Table storing COD assessment records linked to a chart                                             |
| `cl_cod_treatment_plan_extension` | Table storing treatment plan extension records for COD charts                                      |
| `useCODCaseload`                  | Hook fetching up to 500 COD-flagged charts with assessment aggregates for the current organization |

## Related

<Columns cols={2}>
  <Card title="Clinical" icon="stethoscope" href="/cl/overview">
    Clinical core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  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.
</Note>

<Accordion title="Documentation sources">
  * src/routes/cl.tsx
  * src/cores/cl/pages/CODCaseloadPage.tsx
  * src/cores/cl/hooks/useCODCaseload.ts
</Accordion>