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

# Goal Quality

> Screen at /lo/goal-quality displaying SMART score analytics across all organizational goals with distribution charts and a low-score goals table.

The Goal Quality screen is accessible at `/lo/goal-quality` and provides an analytics dashboard showing SMART score metrics across all organizational goals, with a type filter, summary cards, distribution charts, and a low-scoring goals table.

## Overview

The `GoalQualityDashboardPage` loads analytics via `useGoalQualityAnalytics(filters)`. A goal-type filter (`all`, `strategic`, `quarterly`) narrows the data set. Four summary cards from `GoalQualitySummaryCards` display totals and scoring statistics. A `ScoreDistributionChart` shows score distribution, and a `GoalsByTypeChart` breaks down goals by type. A `LowScoreGoalsTable` lists goals below a threshold. A back-arrow button links to `/lo`. The page header reads "Goal Quality Analytics" with the subtitle "SMART score metrics across all organizational goals".

## Who it's for

Requires `LO_PERMISSIONS.DASHBOARD_VIEW` (`lo.dashboard.view`) via the shared `LOViewGuard`. No additional explicit permission gate is applied in this component.

## Before you start

* `lo.dashboard.view` permission required.
* At least one goal with a SMART score must exist for meaningful analytics to display.

## Steps

<Steps>
  <Step title="Navigate to Goal Quality">Go to `/lo/goal-quality` or select Goal Quality from the Leadership navigation.</Step>
  <Step title="Filter by goal type">Use the type selector to filter to `all`, `strategic`, or `quarterly` goals.</Step>
  <Step title="Review summary cards">`GoalQualitySummaryCards` shows total goals, average SMART score, excellent percentage, and needs-improvement count.</Step>
  <Step title="Analyze score distribution">Review `ScoreDistributionChart` to see how scores are spread across the range.</Step>
  <Step title="Review goals by type">See `GoalsByTypeChart` for a breakdown by goal type.</Step>
  <Step title="Address low-scoring goals">The `LowScoreGoalsTable` lists goals below the quality threshold for follow-up.</Step>
</Steps>

## Key concepts

* **SMART score**: a numeric quality score computed by `validateSMARTGoal`.
* **AnalyticsFilters**: `{ goalType: 'all' | 'strategic' | 'quarterly' }`.
* **LowScoreGoalsTable**: highlights goals that fall below a SMART score threshold (confirm threshold with SME).

## Related

<Columns cols={2}>
  <Card title="Leadership" icon="compass" href="/lo/overview">
    Leadership 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/lo.tsx
  * src/cores/lo/pages/GoalQualityDashboardPage.tsx
  * src/cores/lo/hooks/useGoalQualityAnalytics.ts
</Accordion>