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

# Scorecard Metrics

> Screen at /lo/scorecard-metrics for managing the metrics tracked on weekly scorecards, filterable by role.

The Scorecard Metrics screen is accessible at `/lo/scorecard-metrics` and allows users to create, edit, and delete the metrics that are measured on weekly scorecards.

## Overview

The `ScorecardMetricsPage` loads metrics via `useScorecardMetrics` (filtered by `roleId` when a specific role is selected) and role definitions via `useRoleDefinitions`. A role filter allows narrowing metrics by role. Each metric is displayed in a card with its name and a role badge. Edit and delete action buttons appear on each card. The `MetricFormDialog` opens for creating new metrics or editing existing ones. Deletion is confirmed via an `AlertDialog` before calling `remove.mutateAsync`.

## Who it's for

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

## Before you start

* `lo.dashboard.view` permission required.
* At least one role must be defined to assign metrics to roles.

## Steps

<Steps>
  <Step title="Navigate to Scorecard Metrics">Go to `/lo/scorecard-metrics`.</Step>
  <Step title="Filter by role">Select a role from the dropdown to view only metrics for that role, or leave as "all".</Step>
  <Step title="Create a metric">Select the "+" button to open `MetricFormDialog` in create mode.</Step>
  <Step title="Edit a metric">Select the edit button on a metric card to open `MetricFormDialog` in edit mode.</Step>
  <Step title="Delete a metric">Select the delete button and confirm in the `AlertDialog` to remove the metric.</Step>
</Steps>

## Key concepts

* **ScorecardMetric**: the data type representing a measurable item on a scorecard.
* **MetricFormDialog**: the dialog for creating and editing metrics.
* **role\_id**: metrics are associated with a role definition from the Accountability Chart.

## 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/ScorecardMetricsPage.tsx
  * src/cores/lo/hooks/useScorecardMetrics.ts
  * src/cores/lo/hooks/useRoleDefinitions.ts
</Accordion>