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

# Governance Reports

> Hub page linking to QI reports, accreditation reports, and audit management — surfaces available report destinations behind per-tile permission gates.

The Governance Reports hub (`/gr/reports`) renders `GRReportsHubPage`, a tile-based landing page that links to distinct report surfaces across the GR module, gating each tile behind its own permission.

## Overview

`GRReportsHubPage` presents three report tiles, each guarded by a separate `PermissionGate`:

| Tile                  | Destination route                 | Required permission      |
| --------------------- | --------------------------------- | ------------------------ |
| QI reports            | `/gr/quality-improvement/reports` | `gr.qi.view`             |
| Accreditation reports | `/gr/accreditations/reports`      | `gr.accreditations.view` |
| Audit management      | `/gr/audits`                      | `gr.audits.view`         |

Tiles whose permission the current user lacks will not display an **Open** button (the gate hides the control).

## Who it's for

Access follows your organization's role and module configuration. Individual tiles are gated by `GR_PERMISSIONS.QI_VIEW`, `GR_PERMISSIONS.ACCREDITATIONS_VIEW`, and `GR_PERMISSIONS.AUDITS_VIEW`.

## Before you start

* Hold at least one of `gr.qi.view`, `gr.accreditations.view`, or `gr.audits.view` to interact with any tile.
* To export reports from the destination surfaces, additional export permissions may be required (e.g., `gr.compliance.export`).

## Steps

<Steps>
  <Step title="Open Governance Reports">
    Navigate to `/gr/reports`. The hub displays up to three report tiles depending on your permissions.
  </Step>

  <Step title="Select a report surface">
    Click **Open** on the desired tile. You will be navigated to the corresponding report or list page.
  </Step>

  <Step title="Use filters and export on the destination page">
    Each destination page (QI reports, accreditation reports, audit list) provides its own filters and export controls.
  </Step>
</Steps>

## Key concepts

* **PermissionGate** — platform component that hides its children when the current user lacks the specified permission. Used here to conditionally show the **Open** button per tile.
* **REPORT\_TILES** — static array in `GRReportsHubPage` defining title, description, route, permission, and icon for each tile.

## Related

<Columns cols={2}>
  <Card title="Governance & Compliance" icon="scale-balanced" href="/gr/overview">
    Governance & Compliance core overview.
  </Card>

  <Card title="Governance & parity" icon="clipboard-check" 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/gr.tsx
  * src/cores/gr/pages/GRReportsHubPage.tsx
  * src/platform/permissions/constants.ts
</Accordion>