Rhythm 2.0 Specifications

Appearance

SVC-ACC-CLS-fiscal-closeFiscal Close Service Module

Markdown

SVC-ACC-CLS-fiscal-close

Fiscal Close Service Module

Markdown
  • DocumentDraft
  • ImplementationObserved

KindService contractProduct areaAccountingModuleMonth-End ClosingRevision1

Read atservices-accounting f47cb263react-console baf6dae3

Fiscal Close Service Module ​

What This Service Is For ​

Finance staff use this service to review monthly readiness, close the books, reopen eligible months and inspect retained evidence. Durable jobs carry out the financial sequence while the request remains available for progress and recovery. The module makes no model calls.

Boundary ​

Close owns period-closing fields, readiness, runs, their jobs and immutable close snapshots. It calls the calendar, posting, financial-document and reconciliation owners within Accounting. Platform supplies execution and aging infrastructure. Deployment currently places reads and recovery in Reconciliation, submissions in Books configuration and tasks in batch posting. No separate close function is declared.

Operations in Words ​

Calendar and authorization reads establish the subject and available actions. Readiness calculates a fresh review without independently writing records. Close and reopen submissions validate authority, request shape and calendar sequence, then save a request with its execution job. The API returns ordinary success with a run; asynchronous acceptance status is not declared.

History operations list requests and assemble one request’s task history or close record. Recovery retries retained failed work or cancels an eligible waiting or failed request. Its action grant depends on the request kind. Every operation records an unpublished Submissions reason; publication policy remains subject to verification of the external standard.

Events and Jobs ​

Two declared state machines execute close and reopen task catalogues. The module has no owned queue or schedule and declares no domain event-bus publication. Its events are job-local history. Several are appended after their domain transaction and can therefore be absent after a post-commit failure. Infrastructure alarms observe failed or timed-out executions; customer attention and notifications are not produced here.

Consistency Guarantees ​

Recognition and reversal retain their domain results with run output. Finalization atomically closes the month, captures evidence, accepts an aging request and succeeds the run. Aging contention can prevent that transaction from committing. Calendar maintenance and job history have separate commit boundaries. Period locks protect one month’s changing work; neighbouring sequence reads and the failure callback’s pre-lock run read need stronger concurrency proof.

Owns
DOM-ACC-CLS-001DOM-ACC-CLS-002DOM-ACC-CLS-003DOM-ACC-CLS-004
Repository
services-accounting

Controls

48 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-005 TC-AZ-006 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-SEC-001 TC-SEC-004 TC-CRY-001 TC-CRY-002 TC-CRY-003 TC-CRY-004 TC-DAT-001 TC-DAT-002 TC-DAT-004 TC-DAT-005 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-CHG-001 TC-CHG-002 TC-CHG-003 TC-CHG-004 TC-CHG-006 TC-AVL-001 TC-AVL-002 TC-AVL-003 TC-AVL-004 TC-MON-001 TC-MON-002 TC-MON-003 TC-MON-004 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005

Does Not Own

  • Books maintains calendar identity, dates, business units and the settings row. Close owns the period’s closing state and consumes its bank-verification policy.
  • Batch management supplies posting guards, system batches and the recognition schedules used by execution.
  • Transactions supplies the inspected financial documents and the aging report type.
  • Reconciliation supplies payment findings and the placement of eligible late effects.
  • Platform supplies durable execution, aging infrastructure, permission evaluation and person-name lookup.
  • Accounting Maintenance exposes close export and deletion participation to Platform’s workspace lifecycle.

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