Rhythm 2.0 Specifications

Appearance

CAP-PFM-ELG-015Identify and repair gaps in responsibility coverage

Markdown

CAP-PFM-ELG-015

Identify and repair gaps in responsibility coverage

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

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

Implementation

Executable suites
TST-PFM-ELG-378, TST-PFM-ELG-390, TST-PFM-ELG-391, TST-PFM-ELG-499, TST-PFM-ELG-501, TST-PFM-ELG-502, TST-PFM-ELG-503, TST-PFM-ELG-506

KindCapabilityProduct areaPlatformModuleEligibility, Responsibilities and AttentionRevision1

Read atservices-platform ad3f6a65react-console baf6dae3

Identify and repair gaps in responsibility coverage ​

Purpose ​

Organizations need to know when an area expected to be held has nobody responsible. Defaults and gap reporting support that oversight.

How It Works ​

Applications declare their responsibility areas and defaults during deployment. Platform validates and applies the declaration set. Changed declarations trigger bounded immediate reconciliation. Nightly work completes remaining reconciliation and revisits each workspace. Removed defaults remain removed. Assignment changes update the uncovered-area report as part of the write. Attention refresh turns an uncovered area into an administrator-facing advisory. Giving the area a holder clears that advisory when refresh succeeds. Applications can also synchronize holdings derived from their own records without discarding history.

Relationships ​

Coverage repair maintains declared responsibility defaults and publishes uncovered-area attention.

The Formal Contract

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

Outcomes
Registration supplies declared default holders for a new area.Administrators see coverage gaps until an eligible holder is assigned.
Surfaces
consoleapijob
Intent sources
services-platform:docs/milestones/plans/PLAT-M15-plan.md#2. Scopeservices-platform:docs/milestones/plans/PLAT-M15-plan.md#PLAT-M15-S07services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-02

Controls

33 controls apply, from the corpus control catalogue.

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-CRY-001 TC-CRY-002 TC-CRY-003 TC-CRY-004 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-005 TC-MON-001 TC-PI-001 TC-PI-003 TC-PI-005 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

KeyChecked atScope
platform.responsibilities.readapitenant

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
Responsibility registration validates an application’s complete list and rejects foreign keys, unsupported scope or derivation objects, unknown roles and missing fallback areas without partial writes.
proved by ATS-PFM-ELG-015-01, TST-PFM-ELG-503, TST-PFM-ELG-506
validationservicetest
services-platform:modules/responsibilities/tests/integration/services/registration/register-service-responsibilities.integration.spec.js#refuses a malformed manifest whole, as ObjectInvalid, writing nothing
02must prove
Confirmed
Registration updates changed areas, skips unchanged ones, retains omitted areas as retired and replaces role defaults.
proved by ATS-PFM-ELG-015-02, TST-PFM-ELG-503
lifecycleservicetest
services-platform:modules/responsibilities/tests/integration/services/registration/register-service-responsibilities.integration.spec.js#retires a definition the manifest no longer declares, and keeps its row
03must prove
Confirmed
Changed registrations reconcile operational workspaces within a 30-second budget, initializing defaults and uncovered-area state, with remaining work deferred to nightly processing.
proved by ATS-PFM-ELG-015-03, TST-PFM-ELG-501
lifecycleservicetest
services-platform:modules/responsibilities/tests/integration/services/reconcile/reconcile-after-registration.integration.spec.js#gives the tenant the role default of a newly registered definition
04must prove
Confirmed
Nightly reconciliation creates declared role defaults, respects removed defaults, ends undeclared ones and makes no changes on an identical rerun.
origin: services-platform:docs/proposals/responsibilities-and-attention/16-decisions.md#D-02
proved by ATS-PFM-ELG-014-10, ATS-PFM-ELG-015-04, ATS-PFM-ELG-015-08, TST-PFM-ELG-502
lifecycleservicetest
services-platform:modules/responsibilities/tests/integration/services/reconcile/reconcile-tenant.integration.spec.js#(a) writes one active role-default assignment of the declared role at the tenant
05must prove
Confirmed
An always-held area without a workspace-level active primary appears in the unassigned report, updated atomically by assignment changes and cleared when coverage returns.
proved by ATS-PFM-ELG-013-14, ATS-PFM-ELG-015-05, ATS-PFM-ELG-015-07, ATS-PFM-ELG-015-10, TST-PFM-ELG-499, TST-PFM-ELG-502
calculationservicetest
services-platform:modules/responsibilities/tests/integration/services/persistence/unassigned-responsibilities.integration.spec.js#opens the row at once when the only assignment of an area is ended
06must prove
Confirmed
Unassigned areas produce advisory attention for administrators and clear when covered, with post-write attention refresh failures leaving the responsibility write successful.
proved by ATS-PFM-ELG-015-06, ATS-PFM-ELG-015-09, ATS-PFM-ELG-015-10, ATS-PFM-ELG-016-13, TST-PFM-ELG-378, TST-PFM-ELG-390, TST-PFM-ELG-391
policyservicetest
services-platform:modules/attention/tests/integration/services/evaluate/refresh-unassigned-attention.integration.spec.js#resolves the item as cleared when the refresh runs after the assignment
07
Confirmed
Responsibility readers can inspect uncovered areas and follow their assignment links.
permissionapi, consoletest
services-platform:modules/responsibilities/tests/e2e/responsibilities.e2e.spec.js#answers the unassigned report
08must prove
Confirmed
Applications synchronize record-derived holdings through a function that inserts missing holdings and ends obsolete ones without deleting history.
no proof recorded yet
invariantdatabaseobserved
services-platform:db/migrations/20261019011302_responsibilities.sql:platform.sync_derived_responsibilities
09must prove
Confirmed
Derived synchronization requires the transaction’s workspace and actor, a valid application and derivation key, an array of active responsibility entries declared derivable from that application’s objects with people, allowed holder kinds, valid scopes and ordered dates, and no repeated responsibility at a scope; it serializes each derivation, validates before writing, refreshes changed dates and audits inserts, endings and refreshes in the same transaction.
no proof recorded yet
validationdatabaseobserved
services-platform:db/migrations/20261019011302_responsibilities.sql:platform.sync_derived_responsibilities

Scenarios

IdGivenWhenThenProvenance
01An application adds an always-held financial-close area without defaults.Its changed registration completes.Workspaces gain an uncovered-area report promptly and assignment clears the gap.test
react-console:acceptance/platform-attention/playwright/journeys/responsibilities/RA-ACC-0003.spec.ts#RA-ACC-0003

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