Bring waiting batches to the posting team’s attention

Purpose

A posting attention item makes unfinished batch work visible to the people responsible for it.

How It Works

Rhythm watches batches entering states that await posting. Their unit and posting responsibility determine the attention audience. The item carries identifying information and a deadline calculated in the workspace calendar. Changes refresh the existing item rather than creating duplicates. Leaving the waiting state resolves it. A recurring sweep repairs missing or stale items, while the provider’s bulk-action declaration still needs proof of its console execution.

Relationships

Prerequisite: Use the batch’s permitted lifecycle actions, which addresses the connected batch work.
Related outcome: Run and monitor a batch posting job, which addresses the connected batch work.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

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

Outcomes: Waiting collections have accountable attention items that resolve or refresh as their state changes.
Surfaces: consolejob
Constraints: Platform supplies the responsibility audience and attention presentation.

Controls

23 controls apply, from the corpus control catalogue.

TC-IAM-001 TC-IAM-005 TC-IAM-006 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-DAT-001 TC-DAT-004 TC-LOG-005 TC-AVL-001 TC-AVL-004 TC-MON-001 TC-MON-002 TC-MON-004 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005

Business Rules

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

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	Closed, Verified, Posting and Error transaction batches qualify as awaiting posting, whereas system batches do not. proved by `ATS-ACC-BAT-001-13`, `ATS-ACC-BAT-008-01`, `ATS-ACC-BAT-008-06`, `TST-ACC-BAT-120`	policy	service	test services-accounting:modules/batches/tests/unit/attention/batches-awaiting-posting.spec.js#holds for a transaction batch in exactly closed, verified, posting and error
`02`must prove Proposed	Entering a waiting state publishes one required attention item in the batch transaction for its unit’s posting responsibility. proved by `ATS-ACC-BAT-008-02`, `TST-ACC-BAT-082`	policy	service	test services-accounting:modules/batches/tests/integration/services/persistence/batch-attention-items.integration.spec.js#publishes one open item of the batch with every element mapped
`03`must prove Proposed	The item identifies the batch by code or name and includes its unit, document count and period end, refreshing the existing item when those facts change. proved by `ATS-ACC-BAT-008-02`, `TST-ACC-BAT-082`	calculation	service	test services-accounting:modules/batches/tests/integration/services/persistence/batch-attention-items.integration.spec.js#keeps one open item, its first generation, with the new label and number
`04`must prove Proposed	Posting, reopening, archiving or deleting resolves the item, and a subsequent close starts a new attention generation. proved by `ATS-ACC-BAT-004-11`, `ATS-ACC-BAT-006-07`, `ATS-ACC-BAT-008-03`, `ATS-ACC-BAT-008-07`, `ATS-ACC-BAT-008-08`, `ATS-ACC-BAT-008-09`, `ATS-ACC-BAT-013-19`, `TST-ACC-BAT-082`	lifecycle	service	test services-accounting:modules/batches/tests/integration/services/persistence/batch-attention-items.integration.spec.js#resolves a reopened batch reopened, and its next close opens the second generation
`05`must prove Proposed	The deadline adds the workspace’s posting allowance in local calendar days to the last change, accepting zero through thirty whole days and defaulting invalid or missing values to two. proved by `ATS-ACC-BAT-008-04`, `TST-ACC-BAT-082`, `TST-ACC-BAT-120`	calculation	service	test services-accounting:modules/batches/tests/unit/attention/batches-awaiting-posting.spec.js#answers the default 2 for a missing, fractional, out-of-bounds or mistyped value
`06`must prove Proposed	An hourly sweep restores missing items, clears stale ones and refreshes deadlines using the current allowance. proved by `ATS-ACC-BAT-008-05`, `TST-ACC-BAT-082`	policy	service	test services-accounting:modules/batches/tests/integration/services/persistence/batch-attention-items.integration.spec.js#publishes the batch whose item was lost
`07`must prove Proposed	The provider declares a bulk Post action bound to the posting operation, but console grouping and execution by business unit remain unverified. no proof recorded yet	policy		documented services-accounting:modules/batches/attention/batches-awaiting-posting.attention.ts:batchesAwaitingPosting

Scenarios

Id	Given	When	Then	Provenance
`01`	The workspace allows five posting days and has a posting responsible.	Staff close a batch on Monday afternoon.	Its attention deadline falls five calendar days after close, and posting resolves the item.	test services-accounting:modules/batches/tests/integration/services/persistence/batch-attention-items.integration.spec.js#dues the item five days after the close
`02`	No person holds the workspace’s posting responsibility.	A batch enters a waiting state.	The documented attention item remains without a recipient until the responsibility is assigned.	documented services-accounting:docs/milestones/walkthroughs/ACCT-M3-handoff.md#Start here (step 3)

Planning

Implementation

Bring waiting batches to the posting team’s attention ​

Purpose ​

How It Works ​

Relationships ​