Rhythm 2.0 Specifications

Appearance

CAP-PFM-ELG-016Maintain attention conditions throughout their lifecycle

Markdown

CAP-PFM-ELG-016

Maintain attention conditions throughout their lifecycle

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-PFM-ELG-05
Exercised by
FAS-PFM-ELG-05-01, FAS-PFM-ELG-05-02, FAS-PFM-ELG-05-03, FAS-PFM-ELG-05-04, FAS-PFM-ELG-05-05, FAS-PFM-ELG-06-03
Key concepts
CON-PFM-ELG-005
Actors
ACT-PFM-024, ACT-PFM-026, ACT-PFM-007
Journeys
JNY-PFM-ELG-004
Related
CAP-PFM-ELG-015, CAP-PFM-ELG-017
Proved by
ATS-PFM-ELG-016

Implementation

Executable suites
TST-PFM-ELG-375, TST-PFM-ELG-388, TST-PFM-ELG-390, TST-PFM-ELG-392, TST-PFM-ELG-400, TST-PFM-ELG-402, TST-PFM-ELG-403, TST-PFM-ELG-408

KindCapabilityProduct areaPlatformModuleEligibility, Responsibilities and AttentionRevision1

Read atservices-platform ad3f6a65react-console baf6dae3

Maintain attention conditions throughout their lifecycle ​

Purpose ​

Attention needs an accountable lifecycle tied to the application condition. Providers publish and clear occurrences while Platform maintains the shared projection.

How It Works ​

An application declares each kind’s meaning and presentation. Deployment validation checks the full set. The provider publishes an occurrence alongside its business change. Later refreshes keep the same open occurrence current. Clearing the business condition resolves it. Recurrence creates a fresh generation for personal responses. Provider sweeps repair missed updates, and Platform sweeps maintain expiry and rank. Computed kinds obtain their matches through reporting. An authorized administrator can resolve an occurrence with an explanation. Merges redirect supported references to the surviving record.

Relationships ​

Condition lifecycle supplies the attention read experience and the coverage-gap conditions created by responsibility reconciliation.

The Formal Contract

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

Outcomes
Application conditions create attention and remove it on completion.Transactional publication prevents committing invalid attention alongside the business update.
Surfaces
apijob
Intent sources
services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-03services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-05services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-06services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-10services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-12services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-13services-platform:docs/milestones/plans/PLAT-M15-plan.md#2. Scope

Controls

36 controls apply, from the corpus control catalogue.

TC-AVL-005 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-CHG-001 TC-CHG-002 TC-CHG-003 TC-CHG-004 TC-CHG-005 TC-CHG-006 TC-CHG-007 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-DAT-004 TC-IAM-001 TC-IAM-006 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-MON-001 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-005 TC-PRV-001 TC-PRV-002 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.resolve-manuallyapitenant

Business Rules

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

IdRuleKindEnforced atProvenance
01must prove
Confirmed
Application attention declarations are validated together, rejecting foreign keys, changed classes, unexplained required classes, escalating opportunities, incompatible audiences, invalid templates, unavailable actions or permissions and foreign about-objects.
origin: services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-06
proved by ATS-PFM-ELG-016-01, TST-PFM-ELG-400, TST-PFM-ELG-403
validationservicetest
services-platform:modules/attention/tests/integration/services/registration/register-service-attention.integration.spec.js#refuses a class that changes between releases
02must prove
Confirmed
Removing a declared kind retires it and resolves its open workspace items while retaining workspace settings.
proved by ATS-PFM-ELG-016-02, ATS-PFM-ELG-016-16, TST-PFM-ELG-400
lifecycleservicetest
services-platform:modules/attention/tests/integration/services/registration/register-service-attention.integration.spec.js#retires a definition the manifest no longer declares, resolves its open items and keeps its settings
03must prove
Confirmed
Applications publish and resolve attention within their transaction through four restricted database functions, rejecting foreign workspace or service claims and unavailable kinds, while Platform can evaluate any application’s computed kinds.
origin: services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-13
proved by ATS-PFM-ELG-016-03, ATS-PFM-ELG-016-11, TST-PFM-ELG-375, TST-PFM-ELG-392
permissiondatabasetest
services-platform:modules/attention/tests/integration/services/persistence/items.integration.spec.js#reaches no table directly: a provider cannot write an item but through the functions
04must prove
Confirmed
Item publication rejects invalid facts, scope chains over ten or an organization scope placed before the end, unsupported or excessive audiences, missing responsibility targets, teams, unknown product roles and non-Platform eligibility audiences, rolling back refused writes.
proved by ATS-PFM-ELG-016-04, TST-PFM-ELG-392
validationdatabasetest
services-platform:modules/attention/tests/integration/services/persistence/items.integration.spec.js#writes nothing when it refuses
05must prove
Confirmed
Each kind and deduplication key has one open occurrence, refreshed in place with replacement audiences while retaining escalations; recurrence after resolution creates a new generation.
proved by ATS-PFM-ELG-016-05, ATS-PFM-ELG-016-15, ATS-PFM-ELG-019-07, TST-PFM-ELG-392, TST-PFM-ELG-402
invariantdatabasetest
services-platform:modules/attention/tests/integration/services/persistence/items.integration.spec.js#opens the next generation, a new item, when a resolved condition recurs
06must prove
Confirmed
Published surfaces reflect the kind’s and workspace’s choices, and scope chains end at the workspace after application-provided resource ancestry.
origin: services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-05
proved by ATS-PFM-ELG-016-06, TST-PFM-ELG-392
calculationdatabasetest
services-platform:modules/attention/tests/integration/services/persistence/items.integration.spec.js#masks the surfaces to the tenant’s: a console-and-portal definition the tenant keeps on the console
07must prove
Confirmed
Resolution reports whether it closed an open occurrence and safely repeats; unconfirmed resolution clears matching occurrences not refreshed since a given instant, optionally within a scope.
proved by ATS-PFM-ELG-015-09, ATS-PFM-ELG-016-07, ATS-PFM-ELG-016-11, ATS-PFM-ELG-016-13, ATS-PFM-ELG-016-14, ATS-PFM-ELG-017-17, TST-PFM-ELG-375, TST-PFM-ELG-392
lifecycledatabasetest
services-platform:modules/attention/tests/integration/services/persistence/items.integration.spec.js#resolves the open items not confirmed since the instant, in the scope given, and leaves the confirmed
08must prove
Confirmed
Closed occurrences do not reopen; a 15-minute sweep expires overdue expiry dates, releases their deduplication keys, clears recently retired kinds, refreshes rank and removes orphaned supporting records.
proved by ATS-PFM-ELG-016-08, TST-PFM-ELG-402, TST-PFM-ELG-408
lifecycleservicetest
services-platform:modules/attention/tests/integration/services/sweep/sweep-tenant.integration.spec.js#frees the expired item’s dedupe key, so the condition can open again
09must prove
Confirmed
Scheduled computed attention uses reporting data to publish matching records and clear missing matches, stopping above 100,000 without clearing items and rejecting eligibility audiences until customer authoring exists.
proved by ATS-PFM-ELG-016-09, TST-PFM-ELG-390
policyservicetest
services-platform:modules/attention/tests/integration/services/evaluate/evaluate-definition.integration.spec.js#stops a run past its cap as over_capacity, resolving nothing
10must prove
Confirmed
Manual resolution requires its separate permission and an audited reason, returning not found for an occurrence already closed.
proved by ATS-PFM-ELG-016-10, TST-PFM-ELG-388
permissionapitest
services-platform:modules/attention/tests/e2e/attention.e2e.spec.js#resolves an open item with the reason, audited
11must prove
Confirmed
Monthly attention storage retains 13 months, dropping remaining open occurrences with their partition for providers to recreate on a subsequent sweep.
no proof recorded yet
lifecycledatabasetest
services-platform:modules/attention/tests/integration/db/attention-items.table.integration.spec.js#partitions the items by month on opened_at, registered for the maintenance with thirteen months kept
12must prove
Confirmed
Contact and organization merges redirect attention references and audiences to the survivor, including a merged contact’s personal state.
proved by ATS-PFM-ELG-016-12
lifecycledatabasedocumented
services-platform:docs/attention.md#8. The merge participant
13
Confirmed
Attention does not automatically create tasks or messages and currently emits no business lifecycle events.
origin: services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-10
policyservicedocumented
services-platform:docs/attention.md#9. What is not built

Scenarios

IdGivenWhenThenProvenance
01Publishing is enabled and Pat holds unit posting.A batch closes within that unit.The same save publishes the waiting-posting item and posting resolves it.test
react-console:acceptance/platform-attention/playwright/journeys/attention/RA-ACC-0100.spec.ts#RA-ACC-0100
02A reconciliation condition becomes blocked.The reconciliation later clears.Its holder’s blocker item appears and then resolves.test
react-console:acceptance/platform-attention/playwright/journeys/attention/RA-ACC-0104.spec.ts#RA-ACC-0104

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.

Rhythm Software