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

# QI Dashboard

> Aggregate dashboard showing Quality Improvement project metrics, trend charts, and overdue improvement alerts.

The QI Dashboard provides an organization-wide view of Quality Improvement activity, including project counts by category, metric trend distributions, active projects, and overdue improvement items. It is located at route `/gr/quality-improvement/dashboard`.

## Overview

The dashboard renders three data sources in parallel: `useQIDashboard` (aggregate stats), `useActiveQIProjects`, and `useOverdueImprovements`. Visualizations include a pie chart of projects by category and a bar chart of metric trends (improving, stable, declining). Active QI project cards and overdue improvement cards are listed below the charts. No permission gate is declared on this route in `gr.tsx`.

## Who it's for

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

* Navigate from the Quality Improvement section in the GR core sidebar.
* QI projects must exist to see meaningful data.

## Steps

1. Go to **Governance & Compliance → Quality Improvement → Dashboard** at `/gr/quality-improvement/dashboard`.
2. Review the category distribution chart to understand where QI effort is concentrated.
3. Review the metric trend chart for improving vs. declining indicators.
4. Scroll to active projects and select any to open the QI Project Details page.
5. Review overdue improvement items and navigate to the relevant project to address them.

## Key concepts

| Concept              | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| PDSA cycles          | Plan-Do-Study-Act improvement cycles tracked within QI projects    |
| Metric trends        | `improving`, `stable`, `declining` — trend direction of QI metrics |
| Overdue improvements | Improvement items past their due date; surfaced as alerts          |
| Categories           | `clinical`, `operational`, `safety`, `compliance`, `outcomes`      |

## 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/QIDashboard.tsx
  * src/cores/gr/hooks/useQIDashboard.ts
  * src/cores/gr/hooks/useQIProjectList.ts
</Accordion>