Skip to content

CAP-PFM-ELG-020Adjust shared attention and personal visibility

Markdown

CAP-PFM-ELG-020

Adjust shared attention and personal visibility

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationPartially observed

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
Organizations tune wording and allowed priority, escalation and reminder settings while preserving item class.People can hide advisory kinds on Home while required kinds remain visible.
Surfaces
api
Intent sources
services-platform:docs/milestones/plans/PLAT-M16-plan.md#2. Scopeservices-platform:docs/milestones/plans/PLAT-M16-plan.md#A3services-platform:docs/milestones/plans/PLAT-M16-plan.md#A4services-platform:docs/milestones/plans/PLAT-M16-plan.md#D1services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-06

Controls

22 controls apply, from the corpus control catalogue.

TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-DAT-001 TC-DAT-003 TC-LOG-002 TC-LOG-003 TC-LOG-005 TC-PI-001 TC-PI-003 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-PRV-004 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

KeyChecked atScope
platform.attention.readapitenant
platform.attention.manageapitenant
platform.attention.useapitenant

Business Rules

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

IdRuleKindEnforced atProvenance
01must prove
Confirmed
Attention catalogue reads require read authority, while reading or changing a kind’s workspace settings requires sensitive management authority.
permissionapitest
services-platform:modules/attention/tests/e2e/attention.e2e.spec.js#refuses the settings to a caller without manage, with 403
02must prove
Confirmed
Workspaces can disable a kind or restrict its declared surfaces, hiding occurrences without resolving them.
policyservicetest
03must prove
Confirmed
Configured values must respect the kind’s declarations and bounds, with a workspace rank adjustment from minus ten to ten only for adjustable kinds.
validationapi, service, databasetest
services-platform:modules/attention/tests/integration/services/persistence/settings.integration.spec.js#refuses a rank adjustment on a definition that is not tenant-adjustable
04must prove
Confirmed
Wording overrides allow titles and group labels up to 200 characters and summaries up to 1,000, reference only declared facts and render every example; portal overrides remain rejected.
validationapi, servicetest
05must prove
Confirmed
Escalation settings require application permission to adjust and a registered responsibility or product role target; reminder intervals are at least one hour and counts at most ten.
validationservicetest
services-platform:modules/attention/tests/integration/services/persistence/settings.integration.spec.js#refuses an escalation on a definition that does not let the tenant change it
06must prove
Confirmed
Settings changes require the version read and are audited, including earlier and replacement wording and priority adjustments.
invariantservicetest
services-platform:modules/attention/tests/integration/services/persistence/settings.integration.spec.js#audits a change of the template overrides and the rank adjustment with both before and after
07must prove
Confirmed
Personal preferences may hide known advisory and opportunity kinds, never required kinds, using the read version and allowing explicit inclusion of hidden kinds.
validationservicetest
08must prove
Confirmed
Preferences are private to their owner and begin with no hidden attention kinds.
invariantservicetest
09
Confirmed
The product should provide the approved shared settings screen and personal preference panel; both remain absent from the console.
policyconsoleunknown

Scenarios

IdGivenWhenThenProvenance
01The posting kind allows workspace wording changes.An administrator changes its group wording and refreshes Home.The accepted wording appears and a template with an unknown fact fails validation.test
02Pat does not want the uncovered-area advisory displayed.Pat hides that optional kind.Only Pat’s view changes and required kinds remain unhideable.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.