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

# All Submissions

> Clinician-facing list of patient-reported screening results filterable by status and instrument type, scoped to the current organisation.

The All Submissions screen is a clinician-facing list at `/cl/patient-submissions` that surfaces patient-reported outcomes and screening results stored in `cl_patient_submissions`.

## Overview

The screen displays all patient-submitted screening results for the current organisation, ordered by submission date descending. Each card shows the instrument type (PHQ-9, GAD-7, AUDIT-C, DAST-10, or C-SSRS Screener), a status badge (Pending Review / Reviewed / Incorporated), a "Crisis" badge if `score_result.crisis_detected` is `true`, the computed score and severity label from `score_result`, the submission timestamp, and a "View" link to the detail page at `/cl/patient-submissions/:id`. Two dropdowns allow filtering by status and by instrument type; selecting "all" in either dropdown removes that filter.

## Who it's for

Requires the `cl.patient-submissions.view` permission.

## Before you start

* The `cl.patient-submissions.view` permission must be assigned to your role.
* Patient-submitted screening results must exist in `cl_patient_submissions` for the current organisation; otherwise the empty state is shown.

## Steps

<Steps>
  <Step title="Open the submissions list">Navigate to `/cl/patient-submissions`. The page loads all submissions for your organisation ordered by most-recent first.</Step>
  <Step title="Filter by status (optional)">Use the "Filter by status" dropdown to narrow results to Pending Review, Reviewed, or Incorporated submissions.</Step>
  <Step title="Filter by instrument type (optional)">Use the "Filter by type" dropdown to show only a specific instrument: PHQ-9, GAD-7, AUDIT-C, DAST-10, or C-SSRS Screener.</Step>
  <Step title="Identify priority items">Look for cards with a destructive "Crisis" badge — these indicate the `crisis_detected` field is `true` on the score result.</Step>
  <Step title="Open a submission detail">Click "View" on any card to navigate to the submission detail page at `/cl/patient-submissions/:id`.</Step>
</Steps>

## Key concepts

The supported submission types and their UI labels, exactly as defined in the component:

| Code             | Display label   |
| ---------------- | --------------- |
| `phq9`           | PHQ-9           |
| `gad7`           | GAD-7           |
| `audit_c`        | AUDIT-C         |
| `dast10`         | DAST-10         |
| `cssrs_screener` | C-SSRS Screener |

Submission statuses are `pending_review`, `reviewed`, and `incorporated`. The `score_result` JSON field contains `total_score`, `severity`, and `crisis_detected` rendered on each card.

<AccordionGroup>
  <Accordion title="Empty state">
    When no submissions match the current filters the page shows an empty state: "No submissions found — Patient-reported screening results will appear here once submitted."
  </Accordion>

  <Accordion title="Error state">
    If the query fails a card is shown with "Unable to load submissions. Please try again."
  </Accordion>

  <Accordion title="Loading state">
    While fetching, five skeleton rows are displayed.
  </Accordion>
</AccordionGroup>

## Related

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

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</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/PatientSubmissionsListPage.tsx
  * src/cores/cl/hooks/usePatientSubmissionsList.ts
  * src/cores/cl/types/patient-submissions.ts
</Accordion>