Rhythm 2.0 Specifications

Appearance

CAP-ACC-CLS-012Recover an interrupted close or reopen

Markdown

CAP-ACC-CLS-012

Recover an interrupted close or reopen

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationInconsistent

Planning

Feature
FEAT-ACC-CLS-03
Exercised by
FAS-ACC-CLS-03-03, FAS-ACC-CLS-03-04, JNY-ACC-CLS-002
Key concepts
CON-ACC-CLS-003
Actors
ACT-ACC-015, ACT-ACC-016
Journeys
JNY-ACC-CLS-005
Depends on
CAP-ACC-CLS-008, CAP-ACC-CLS-011
Related
CAP-ACC-CLS-009, CAP-ACC-CLS-013
Open questions
OQ-ACC-CLS-003
Proved by
ATS-ACC-CLS-012

Implementation

Executable suites
TST-ACC-CLS-017, TST-ACC-CLS-021, TST-ACC-CLS-022, TST-ACC-CLS-023, TST-ACC-CLS-047

KindCapabilityProduct areaAccountingModuleMonth-End ClosingRevision1

Read atservices-accounting f47cb263react-console baf6dae3

Recover an interrupted close or reopen ​

Purpose ​

The closer determines whether stopped execution can resume, be cancelled or needs a fresh request.

How It Works ​

The controller reviews the failed step and its explanation on the run page. A run retaining the period can usually resume through Retry from This Step. The retry creates another job for the same run and keeps completed work. Cancellation is available only before effects make it unsafe. A close with recognized revenue must finish and then reopen to reverse that work. A reopen with reversed revenue must finish reopening. A close that failed during finalization without recognition releases its month automatically. That released run cannot resume, though cancellation can still record its abandonment. Readiness refusals also call for a fresh close after the cause is resolved. The product should correct cancellation wording so the promised effect matches the service.

Relationships ​

  • Close and reopen produce the runs recovered here.
  • Revenue recognition and reversal determine cancellation eligibility.
  • The run view provides the failure and recovery controls.

The Formal Contract

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

Outcomes
Committed work survives retry without duplicate revenue posting.The period remains protected until recovery safely releases it.
Surfaces
consoleapijob
Intent sources
services-accounting:docs/milestones/walkthroughs/ACCT-M4-handoff.md#A failed fiscal-close finalize releases the period (DEF-ACT-0819)

Controls

30 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-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

Permissions

KeyChecked atScope
accounting.fiscal-periods.readapitenant
accounting.fiscal-periods.closeservicetenant
accounting.fiscal-periods.reopenservicetenant

Business Rules

10 rules, 8 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.

IdRuleKindEnforced atProvenance
01must prove
Proposed
A failed run that retains its period leaves it closing or reopening until a permitted recovery action completes.
proved by ATS-ACC-CLS-012-01, ATS-ACC-CLS-012-07, TST-ACC-CLS-021, TST-ACC-CLS-022, TST-ACC-CLS-023
lifecycleservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#leaves the period reopening
02must prove
Proposed
A failed run retaining its period can resume through a new retry job that preserves committed steps.
origin: fiscal-close design L9 (Rhythm 1.0 CLOSE-9 and REOPEN-6 fixed)
proved by ATS-ACC-CLS-012-01, ATS-ACC-CLS-012-07, TST-ACC-CLS-021, TST-ACC-CLS-022, TST-ACC-CLS-023
lifecycleservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#finishes the reopen on retry
03must prove
Proposed
A readiness refusal or lock refusal leaves no retained period to retry and requires a fresh eligible request.
proved by ATS-ACC-CLS-012-02, TST-ACC-CLS-021
validationservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#refuses a retry: the period is no longer held
04must prove
Proposed
Finalization failure releases a close with no recognized revenue, while a close with committed recognition retains the period for retry.
origin: DEF-ACT-0819 (ACCT-M4 WP-K, 2026-10-21)
proved by ATS-ACC-CLS-012-02, ATS-ACC-CLS-015-05, TST-ACC-CLS-021
lifecycleservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#fails the run on finalize, not retryable, saying the period was given back (DEF-ACT-0819)
05must prove
Proposed
An eligible queued or failed cancellation returns a close to open or restores a reopen to closed with its earlier close details.
proved by ATS-ACC-CLS-012-03, ATS-ACC-CLS-012-04, ATS-ACC-CLS-012-08, TST-ACC-CLS-017, TST-ACC-CLS-021
lifecycleservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#leaves the period open with no run holding it (finalize had already given it back)
06must prove
Proposed
Cancellation is refused after a close recognized revenue or a reopen reversed it; the former requires retry then reopen, and the latter requires retry.
proved by ATS-ACC-CLS-012-03, ATS-ACC-CLS-012-07, TST-ACC-CLS-017, TST-ACC-CLS-021
validationservicetest
services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#refuses the cancel as run-not-cancellable, naming the way out
07must prove
Proposed
Only failed runs can be retried, and running or finished runs cannot be cancelled.
proved by ATS-ACC-CLS-012-03, ATS-ACC-CLS-012-08, ATS-ACC-CLS-012-09, TST-ACC-CLS-017, TST-ACC-CLS-021, TST-ACC-CLS-047
validationservicetest
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-runs.e2e.spec.js#refuses retrying a run that did not fail with 409
08must prove
Proposed
Retry and cancellation require the action grant corresponding to the run’s close or reopen kind.
proved by ATS-ACC-CLS-012-05, TST-ACC-CLS-017, TST-ACC-CLS-021
permissionservicetest
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-runs.e2e.spec.js#refuses a reader’s retry with 403: the handler requires the run’s kind’s key
09
Proposed
A cancellation event identifies the person and the period effect of their action.
policyserviceobserved
services-accounting:modules/fiscal-close/services/jobs/close-run-actions.ts:cancelCloseRun
10
Proposed
The console cancellation confirmation promises to reverse completed steps even when the service refuses cancellation after recognized revenue.
✗ The confirmation promises reversal despite cancellation being refused after recognition.
proved by ATS-ACC-CLS-012-06
policyconsoleobserved
react-console:components/accounting/close/close-run-view.tsx:CancelCloseDialog

Scenarios

IdGivenWhenThenProvenance
01A close failed after September’s revenue was recognized.The controller attempts cancellation and then retries.Cancellation explains the required recovery path; retry finishes without duplicate revenue posting.test
services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#a cancel after revenue was recognised
02A close with no recognition failed in finalization.The controller reads its run.The month is released to open and requires a fresh close rather than retry.test
services-accounting:modules/fiscal-close/tests/integration/services/jobs/close-job.integration.spec.js#lets a new close succeed and close the period
03A reopen failed after locking its period.The controller resumes the failed run.The remaining steps complete and release the month to open.test
services-accounting:modules/fiscal-close/tests/integration/services/jobs/reopen-job.integration.spec.js#finishes the reopen on retry

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