Rhythm 2.0 Specifications

Appearance

DOM-PFM-ELG-005Attention Item

Markdown

DOM-PFM-ELG-005

Attention Item

Markdown
  • DocumentDraft
  • ImplementationObserved

Planning

Specified by
CON-PFM-ELG-005

Design

Owned by
SVC-PFM-ELG-attention

KindDomain objectProduct areaPlatformModuleEligibility, Responsibilities and AttentionRevision1

Read atservices-platform ad3f6a65react-console baf6dae3

Attention Item ​

What It Models ​

An attention occurrence presents a condition that needs someone, such as unposted batches or a gap in accountability.

Identity and Attributes ​

Kinds describe the condition; occurrences retain facts and timing; personal responses remain separate from lifecycle status.

Relationships ​

Providers own the business records. Responsibilities and Security supply current audience membership.

Invariants ​

Occurrence uniqueness, generation retention and response concurrency have different guarantees and are stated separately.

How It Is Stored and Shared ​

Attention owns declarations, occurrences, audiences, settings, responses and follow-up records. Provider functions enforce transactional writes; no custom fields are declared.

Open Design Questions ​

Reminder audience checks, delivery deduplication, the Notifications boundary and response races remain unresolved. Portal attention stays held.

Relationships

ToCardinalityOwnershipCrosses a serviceOn archive or delete
DOM-PFM-ELG-004Multiple occurrences can address the same responsibility area.Attention stores the area reference and resolves its effective holders when read.no

Invariants

InvariantProtectsEnforced atProvenance
INV-DOM-PFM-ELG-005-01
A retained key has one open occurrence; generation numbering can restart after fourteen idle months of key cleanup.
databaseobserved
services-platform:modules/attention/db/attention-item-keys.table.ts; services-platform:modules/attention/services/persistence/items.ts:deleteOrphans
INV-DOM-PFM-ELG-005-02
Restricted writes check workspace and service ownership and run within the caller’s transaction.
databaseobserved
services-platform:docs/attention.md#2. The write functions
INV-DOM-PFM-ELG-005-03
Item writes validate declared fact types, a workspace-ended scope chain of at most ten and one to ten permitted audiences.
databaseobserved
services-platform:docs/attention.md#2. The write functions
INV-DOM-PFM-ELG-005-04
Resolved and expired occurrences cannot be reopened in place.
service, databaseobserved
services-platform:modules/attention/rules.ts:canTransition
INV-DOM-PFM-ELG-005-05
The service refuses dismissal of required attention.
serviceobserved
services-platform:modules/attention/rules.ts:decideStateAction
INV-DOM-PFM-ELG-005-06
Audience membership grants visibility only; record and action permissions remain independently checked.
serviceobserved
services-platform:modules/attention/services/read/action-permissions.ts:allowedActionPermissions
INV-DOM-PFM-ELG-005-07
Escalation stamps each occurrence once and preserves original audiences through provider refresh.
service, databaseobserved
services-platform:modules/attention/services/persistence/items.ts:escalateOverdueItems
INV-DOM-PFM-ELG-005-08
Existing response rows are locked, and accepted writes advance version and audit atomically; concurrent first inserts lack an absent-row lock and retry.
serviceobserved
services-platform:modules/attention/services/persistence/states.ts:applyStateAction
INV-DOM-PFM-ELG-005-09
Private preferences cannot hide required kinds.
serviceobserved
services-platform:modules/attention/services/persistence/preferences.ts:putPreferences
INV-DOM-PFM-ELG-005-10
Database workspace isolation prevents unscoped reads from returning attention.
databaseobserved
services-platform:docs/attention.md#1. The tables

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