---
id: SCR-PFM-ELG-003
title: Header attention bell
route: the header bell on every console page
surface: console
product_area: platform
module: eligibility
revision: 1
status: draft
design_intent: confirmed
origin: >-
  PLAT-M15 plan approved by Andrew 2026-10-21 (header badge); the built surface
  is the approved baseline under the UI change approval rule
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: >-
  Keep required attention discoverable from the console header using its
  existing summary-based badge and leading items.
supports:
  - JNY-PFM-ELG-004
  - CAP-PFM-ELG-017
permission: platform.attention.use
entry_from:
  - Console shell header
exits_to:
  - 'SCR-PFM-ELG-002: complete attention list'
  - Declared item destination
displays:
  - field: >-
      Estimated required-unread badge derived from group counts and sampled
      acknowledgements, with 99+ and 500+ limits
    source: >-
      getMyAttentionSummary groups;
      react-console:lib/attention/model.ts:unreadRequiredCount
  - field: Up to five leading unread required occurrences from summary samples
    source: getMyAttentionSummary items
actions:
  - label: Acknowledge
    operation_id: acknowledgeMyAttentionItem
    permission: platform.attention.use
    confirm: false
  - label: Snooze
    operation_id: snoozeMyAttentionItem
    permission: platform.attention.use
    confirm: false
states:
  - empty
  - loading
  - error
validation:
  - BR-CAP-PFM-ELG-017-07
  - BR-CAP-PFM-ELG-018-03
patterns:
  - Popover
  - AttentionItemRow
  - Accessible badge label
component: components/console/alerts-popover.tsx
evidence:
  - >-
    react-console at baf6dae: components/console/alerts-popover.tsx;
    lib/attention/model.ts (bellLabel, topRequiredItems, unreadRequiredCount).
controls: [TC-AVL-001, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-IAM-001, TC-IAM-002, TC-IAM-003, TC-IAM-004, TC-IAM-005, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-005, TC-MON-001, TC-MON-002, TC-PI-001, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---
# Header attention bell

## What the Screen Is For

The header bell links staff to required work without returning to Home.

## What It Shows and Lets People Do

The bell uses the Home summary but estimates unread totals from its small item samples. It shows a numeric badge, 99+ for larger uncapped values or 500+ at the cap, and displays up to five leading required items with personal actions and a list link.

## States and Errors

No sampled required items produces the empty popover message, even when an estimated badge remains nonzero. Summary availability determines content; the component does not guarantee its badge equals the authoritative unread count. That discrepancy remains a finding.

## Patterns It Must Respect

Retain the console Popover, accessible count label and shared item row. Advisory and opportunity occurrences do not contribute to this required-work badge.