Skip to content

CAP-PFM-ELG-017Deliver relevant attention with a reason

Markdown

CAP-PFM-ELG-017

Deliver relevant attention with a reason

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

KindCapabilityProduct areaPlatformModuleEligibility, Responsibilities and AttentionRevision1

Read atservices-platform ad3f6a65react-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes
Audience members receive ordered work with an explanation of why it reaches them.Changes to holders and delegates affect visibility without rewriting items.
Surfaces
consoleapi
Intent sources
services-platform:docs/milestones/plans/PLAT-M15-plan.md#2. Scopeservices-platform:docs/milestones/plans/PLAT-M15-plan.md#D2services-platform:docs/milestones/plans/PLAT-M15-plan.md#A9services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-04services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-06

Controls

31 controls apply, from the corpus control catalogue.

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

Permissions

KeyChecked atScope
platform.attention.useapitenant
platform.attention.read-othersapitenant

Business Rules

14 rules, 14 to be proved before approval. A rule's product intent is derived from its origin: 14 confirmed by a product decision, the rest inheriting this capability's confirmed.

IdRuleKindEnforced atProvenance
01must prove
Confirmed
Every signed-in console staff member can read and respond to personal attention through baseline use authority, while portal attention remains withheld.
permissionapiobserved
02must prove
Confirmed
Audiences resolve during reads through scoped responsibility holders and delegates, direct users and role holders; team audiences currently match nobody.
calculationdatabase, servicetest
03must prove
Confirmed
Ending a holding removes its audience match on the next read without rewriting the occurrence or removing it from other holders.
invariantservicetest
services-platform:modules/attention/tests/integration/services/read/ending-assignment.integration.spec.js#removes Pat’s item on the next read, without touching the item, and leaves the second holder’s
04must prove
Confirmed
Multiple audience matches produce one item with the preferred reason in order: resource responsibility, workspace responsibility, delegation, cover, team, role, escalation and direct user.
calculationservicetest
services-platform:modules/attention/tests/integration/services/persistence/items.queries.integration.spec.js#answers an item reaching the viewer through two audiences once, with the better reason
05must prove
Confirmed
Rank combines class weights of 300, 200 and 100, urgency weights of 60, 40 and 20, allowed adjustments and up to ten daily age points; opportunity cannot outrank required, and displayed due-soon urgency uses workspace calendar days with a seven-day default.
calculationdatabase, servicetest
services-platform:modules/attention/tests/unit/rules.spec.js#never lets an opportunity outrank a required item within the declared bounds
06must prove
Confirmed
Lists exclude dismissed items and normally snoozed items, support rank, due-date or opening order and cursor pages of 25 by default or at most 100 without duplication or omission.
policyservicetest
services-platform:modules/attention/tests/integration/services/read/viewer-summary.integration.spec.js#pages each sort by its keyset without repeating or dropping an item
07must prove
Confirmed
Summaries group kinds with urgency, snooze and unread counts plus three leading items; unread means required, unacknowledged and unsnoozed, with per-kind counts capped at 500 and reflected on the bell.
calculationservicetest
08must prove
Confirmed
Empty summaries distinguish disabled attention, no holdings or direct audiences, and no outstanding conditions.
calculationservicetest
services-platform:modules/attention/tests/integration/services/persistence/items.queries.integration.spec.js#says no_responsibilities to a viewer who holds none and is addressed by nothing
09must prove
Confirmed
Presentation renders declared facts and scope labels, readable titles and workspace-zone times and durations instead of exposing internal references or raw timestamps.
calculationservicetest
10must prove
Confirmed
An item detail explains its condition, audience match, next action and expected change, concealing occurrences outside the viewer’s audience.
policyservicetest
services-platform:modules/attention/tests/e2e/attention.e2e.spec.js#answers 404 for an item addressed to somebody else
11must prove
Confirmed
Item actions require their declared permissions and explain missing authority; audience membership itself grants no record or action access.
permissionservicetest
services-platform:modules/attention/tests/e2e/attention.e2e.spec.js#allows an action to a reader holding the permission its definition declares, and says what another reader needs
12must prove
Confirmed
Record attention shows all open occurrences about that record with personal matches marked, only to an authorized record reader.
permissionapi, servicetest
services-platform:modules/attention/tests/e2e/attention.e2e.spec.js#answers 404 to a caller who may not read the record
13must prove
Confirmed
Reading a colleague’s attention requires read-others authority and creates an audit record.
permissionapitest
services-platform:modules/attention/tests/e2e/attention.e2e.spec.js#lists a colleague’s items to a holder of read-others, and audits the read
14must prove
Confirmed
Attention remains workspace-isolated, and reads without a workspace return no items.
invariantdatabasetest

Scenarios

IdGivenWhenThenProvenance
01A unit held by Pat has a closed batch.Pat reads Home.A waiting-posting group and unread increase appear, with the responsibility reason and a link to the batch.test
02A reviewer has no role-specific attention grant.A review directed to them becomes due.Baseline staff authority lets their Home present it.test

Edge Cases

IdGivenWhenThenProvenance
03A kind has over 500 outstanding occurrences.Its recipient opens Home.The summary displays a capped count and one full-list link.test

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.