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

# My QI Dashboard

> Personal Quality Improvement dashboard showing the current user's assigned improvements, QI projects they own, and active PDSA cycles.

The My QI Dashboard (`/gr/my-quality-improvement`) renders `MyQIDashboard`, a personal view scoped to the current user's quality improvement workload across improvements, projects, and PDSA cycles.

## Overview

`MyQIDashboard` calls three hooks scoped to the current user:

* `useMyImprovements()` — improvement action items assigned to the user
* `useMyQIProjects()` — QI projects owned by the user
* `useMyPDSACycles()` — active PDSA cycles the user participates in

Four stat cards show: My Improvements (total), My Projects (total and active count), Active Cycles (PDSA cycles in progress or planning), and Overdue (improvements past due).

Three tabs display the data: **My Improvements**, **My Projects**, and **My PDSA Cycles**. Clicking any card navigates to the corresponding QI project detail at `/gr/quality-improvement/:id`.

## Who it's for

Access follows your organization's role and module configuration. Any authenticated user can view their own QI workload.

## Before you start

* You must be authenticated. Data is scoped to your user account.
* The QI module must be enabled (`qi_enabled` in Governance Settings) for projects and cycles to appear.

## Steps

<Steps>
  <Step title="Open My QI Dashboard">
    Navigate to `/gr/my-quality-improvement`. The page loads your improvements, projects, and PDSA cycles.
  </Step>

  <Step title="Review stats">
    Check the four stat cards. A destructive Overdue count means improvement actions are past their due date.
  </Step>

  <Step title="Work on improvements">
    Click the **My Improvements** tab to see assigned improvement actions. Overdue items have a destructive border. Click any card to navigate to its parent QI project.
  </Step>

  <Step title="Review owned projects">
    Click **My Projects** to see QI projects you own. Status badges indicate active, planning, on hold, or completed. Click a card to go to the project detail.
  </Step>

  <Step title="Check PDSA cycles">
    Click **My PDSA Cycles** to see cycles you are participating in that are in progress or planning. Each card shows the cycle number, phase, status, and parent project.
  </Step>
</Steps>

## Key concepts

* **PDSA cycle** — Plan-Do-Study-Act improvement cycle; phases are `plan`, `do`, `study`, `act`.
* **useMyImprovements / useMyQIProjects / useMyPDSACycles** — hooks returning data scoped to the authenticated user's ID.
* **qi\_enabled** — module settings flag in `gr_module_settings`; must be `true` for QI functionality to be active.

## 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/MyQIDashboard.tsx
  * src/cores/gr/hooks/useMyQIProjects.ts
  * src/cores/gr/hooks/useMyPDSACycles.ts
</Accordion>