Rhythm 2.0 Specifications

Appearance

WF-ACC-BKS-008Claim, Deliver and Record Scheduled Work

Markdown

WF-ACC-BKS-008

Claim, Deliver and Record Scheduled Work

Markdown
  • DocumentDraft
  • ImplementationObserved

Planning

Implements
CAP-ACC-BKS-018, CAP-ACC-BKS-010

KindWorkflowProduct areaAccountingModuleBooks, Business Units and Chart of AccountsRevision1

Read atservices-accounting f47cb263

Claim, Deliver and Record Scheduled Work ​

What It Does ​

Accounting coordinates recurring timing through schedule rows, one dispatcher and a queue consumer. The dispatcher chooses the latest due occurrence and can skip older backlog. Registered work covers recurring rolls, automatic close, Reconciliation sweeps and recurring Billing preparation. History records execution results and pause reasons.

The Flow ​

When Something Fails ​

Claim rollback leaves timing due. Explicit publish refusals are released, but an interruption between claim and publication can leave an offered run without delivery. Terminal work is acknowledged; unfinished work may execute again, including concurrently on duplicate delivery. Expected refusals settle immediately, while unexpected errors retry. On the final receive the consumer records failure and acknowledges it; malformed messages and failures that cannot be recorded can reach the dead-letter queue.

The scheduler does not compensate handler effects. Failure counts pause an enabled schedule after five recorded failures, with no attention notice. An invalid saved definition also pauses. Handler repeat safety and recovery of a closed unposted batch remain the owning module’s concerns.

Open Design Questions ​

Implementation preparation needs a delivery-recovery decision for stranded claims and an explicit idempotency contract for each handler. Billing’s scheduling ownership and pause notification also remain open.

Controls

28 controls apply, from the corpus control catalogue.

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

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