Rhythm 2.0 Specifications

Appearance

CAP-ACC-CLS-011Reopen the most recent closed month for correction

Markdown

CAP-ACC-CLS-011

Reopen the most recent closed month for correction

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-ACC-CLS-03
Exercised by
FAS-ACC-CLS-03-02, FAS-ACC-CLS-03-03, FAS-ACC-CLS-03-04, FAS-ACC-CLS-03-05, JNY-ACC-CLS-004
Key concepts
CON-ACC-CLS-003, CON-ACC-CLS-001
Actors
ACT-ACC-015, ACT-ACC-016
Journeys
JNY-ACC-CLS-003
Depends on
CAP-ACC-CLS-002
Related
CAP-ACC-CLS-009, CAP-ACC-CLS-012, CAP-ACC-CLS-014
Proved by
ATS-ACC-CLS-011

Implementation

Executable suites
TST-ACC-CLS-002, TST-ACC-CLS-017, TST-ACC-CLS-022, TST-ACC-CLS-050

KindCapabilityProduct areaAccountingModuleMonth-End ClosingRevision1

Read atservices-accounting f47cb263react-console baf6dae3

Reopen the most recent closed month for correction ​

Purpose ​

An authorized person explains a correction and reopens the latest eligible month while retaining its close evidence.

How It Works ​

The controller locates the latest closed month and chooses Reopen. The console asks for a reason and the exact month label. The request checks eligibility and saves a run before starting its job. The locking step checks sequence and reason again. It preserves the earlier close details before moving the period into reopening. Revenue reversal follows, or records a skipped result when appropriate. Finalization opens the month and records the completed reopen. Staff can then post their correction and close the month again. The original snapshot remains available throughout. A stopped reopen may require retry rather than cancellation once revenue has been reversed.

Relationships ​

  • Authorization checks the permitted reopening sequence.
  • Revenue processing reverses the close-owned posting.
  • Recovery handles stopped execution.
  • The close record retains the previous evaluation and linked reopen.

The Formal Contract

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

Outcomes
Post-close corrections have an accountable request and reason.The month records another completed reopen without losing the earlier snapshot.
Surfaces
consoleapijob
Preconditions
The selected period is the latest eligible closed period.
Postconditions
The period returns to open with its reopen counted, revenue reversed and earlier close evidence retained.
Constraints
Close and reopen requests use the same command-replay and exclusive-period mechanisms.
Intent sources
services-accounting:docs/milestones/plans/ACCT-M4-plan.md#4a row 75 (class A: reopen needs a reason of at least ten characters and accounting.fiscal-periods.reopen; the period counts its reopens)

Controls

24 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-DAT-001 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-005

Permissions

KeyChecked atScope
accounting.fiscal-periods.reopenapitenant

Business Rules

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

IdRuleKindEnforced atProvenance
01must prove
Confirmed
A reopen request requires an idempotency key and a trimmed reason from ten to two thousand characters.
origin: services-accounting:docs/milestones/plans/ACCT-M4-plan.md#4a row 75 (class A; plan approved 2026-10-21)
proved by ATS-ACC-CLS-011-01, TST-ACC-CLS-017, TST-ACC-CLS-050
validationapitest
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-runs.e2e.spec.js#refuses a reason under ten characters with 400
02must prove
Confirmed
Submitting a reopen requires the reopen grant, independently of the close grant.
origin: services-accounting:docs/milestones/plans/ACCT-M4-plan.md#4a row 75 (class A; plan approved 2026-10-21)
proved by ATS-ACC-CLS-011-01, ATS-ACC-CLS-011-07, TST-ACC-CLS-002, TST-ACC-CLS-017, TST-ACC-CLS-050
permissionapitest
services-accounting:tests/unit/fiscal-close-permissions.spec.ts#is required by the fiscal close routes: close by the close, reopen by the reopen, read by every other
03must prove
Confirmed
Submission and locking both reject a month that is not the latest eligible closed month, including a month already open.
origin: fiscal-close design L10 (Rhythm 1.0 REOPEN-1 and REOPEN-2 kept)
proved by ATS-ACC-CLS-011-02, ATS-ACC-CLS-011-05, TST-ACC-CLS-002, TST-ACC-CLS-022
validationservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#refuses reopening August while September is closed, with 1.0’s sentence
04must prove
Confirmed
Reopen execution locks the period, reverses close-owned revenue and finalizes the return to open in three durable steps.
proved by ATS-ACC-CLS-011-03, ATS-ACC-CLS-011-06, TST-ACC-CLS-017, TST-ACC-CLS-022
lifecycleservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#completes its three steps
05must prove
Confirmed
The lock step checks the reason again and preserves the prior closer and close time for cancellation; an invalid reason leaves the period closed.
origin: services-accounting:docs/milestones/plans/ACCT-M4-plan.md#4a row 75 (class A; plan approved 2026-10-21)
proved by ATS-ACC-CLS-011-04, TST-ACC-CLS-022
validationservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#refuses a reason under ten characters in the job’s lock, the period left closed
06must prove
Confirmed
Finalization clears close details, increments the reopen count and records the requester and reason in a run event.
origin: services-accounting:docs/milestones/plans/ACCT-M4-plan.md#4a row 75 (class A: the period counts its reopens)
proved by ATS-ACC-CLS-011-03, ATS-ACC-CLS-011-06, TST-ACC-CLS-017, TST-ACC-CLS-022
lifecycleservice, databasetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#opens the period and counts the reopen
07must prove
Confirmed
Reopening retains the close snapshot and adds the reopen to the close record’s linked history.
origin: fiscal-close design §6.2
proved by ATS-ACC-CLS-011-03, ATS-ACC-CLS-011-06, TST-ACC-CLS-017, TST-ACC-CLS-022
invariantservice, databasetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#keeps the close’s snapshot
08
Confirmed
The reopen run identifies the close whose work it reverses.
policyservice, databasetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#ends the reopen succeeded, naming the close it reverses
09
Confirmed
Reopening makes no aging request; another close requests the next aging version.
origin: Snapshot Architecture agreement of 2026-10-16 (recorded in the plan)
policyservicedocumented
services-accounting:docs/fiscal-close/PHASE-2-PLAN.md#4.1 A/R aging snapshot request
10must prove
Confirmed
The console requires a reason and typed month label when reopening the authorized latest closed month.
proved by ATS-ACC-CLS-011-05, TST-ACC-CLS-002
policyconsoleobserved
react-console:components/accounting/close/reopen-dialog.tsx:ReopenDialog

Scenarios

IdGivenWhenThenProvenance
01September is the latest closed month and its close recognized revenue.The controller requests reopening to account for a late invoice.Reversal completes, September opens with one reopen, and the close record links the correction reason.test
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#the latest closed period, its close having recognised revenue
02Both August and September are closed.Staff request reopening of August.Sequence validation refuses the action because September remains closed.test
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#refuses reopening August while September is closed, with 1.0’s sentence

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