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

# Clinical Oversight

> Tabbed hub for clinical supervision relationships, sessions, compliance, and reports.

Clinical Oversight is available at route `/hr/oversight`. Access follows your organization's role and module configuration.

## Overview

The Clinical Oversight hub (`OversightHubPage`) is a tabbed page with four sections: **Relationships** (supervision pairings), **Sessions** (supervision session records), **Compliance** (compliance dashboard), and **Reports** (compliance reports). The active tab is persisted in the URL via `?tab=`. Detail routes for individual relationships (`/hr/oversight/relationships/:id`) and sessions (`/hr/oversight/sessions/:id`, `/hr/oversight/sessions/:id/sign`) remain as separate route entries for drill-down navigation. Redirect routes (`/hr/oversight/relationships`, `/hr/oversight/sessions`, `/hr/oversight/compliance`, `/hr/oversight/reports`) all redirect to the hub with the appropriate tab parameter.

<Frame caption="Clinical Oversight hub — supervision relationships with type and status, plus the sessions, compliance, and reports tabs.">
  <img src="https://mintcdn.com/encoreos/9uGfYOeeHogjmoRk/images/hr-oversight/oversight-hub.png?fit=max&auto=format&n=9uGfYOeeHogjmoRk&q=85&s=fc5874772cd772f5b3ffd04c01f70919" alt="Clinical Oversight hub" width="1440" height="900" data-path="images/hr-oversight/oversight-hub.png" />
</Frame>

## Who it's for

Access follows your organization's role and module configuration. ## Before you start

* Supervision relationships must exist to see meaningful data in the Relationships tab.

## Steps

<Steps>
  <Step title="Open Clinical Oversight">Navigate to `/hr/oversight`.</Step>
  <Step title="Select a tab">Click Relationships, Sessions, Compliance, or Reports.</Step>
  <Step title="Drill into detail">Click a relationship or session row to navigate to the detail page.</Step>
</Steps>

## Key concepts

| Term                              | Meaning in code                                             |
| --------------------------------- | ----------------------------------------------------------- |
| `useTabUrlState`                  | Platform hook syncing active tab with `?tab=` URL parameter |
| `VALID_TABS`                      | `['relationships', 'sessions', 'compliance', 'reports']`    |
| `OversightRelationshipDetailPage` | Detail page at `/hr/oversight/relationships/:id`            |
| `OversightSessionSignPage`        | Signature page at `/hr/oversight/sessions/:id/sign`         |

## Permissions

Access to the Clinical Oversight hub is gated by your organization's **role and module configuration** — the `/hr/oversight` route has no standalone `hr.*` permission key, so visibility is granted through the role editor rather than a single capability flag. Clinical-supervision authorization (peer supervision, session co-signature) is governed by the **Clinical core** where configured, not by an HR permission.

| Capability                          | Gating                                                                             |
| ----------------------------------- | ---------------------------------------------------------------------------------- |
| View the Clinical Oversight hub     | Role / module configuration (no dedicated `hr.*` key) — managed in the role editor |
| Sign / co-sign supervision sessions | Clinical-core supervision permissions, where configured                            |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </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/hr.tsx
  * src/routes/hr/oversight-analytics-succession-routes.tsx
  * src/cores/hr/pages/oversight/OversightHubPage.tsx
</Accordion>