Skip to content

JNY-ACC-CLS-005A controller recovers an interrupted close

Markdown

JNY-ACC-CLS-005

A controller recovers an interrupted close

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationInconsistent

KindJourneyProduct areaAccountingModuleMonth-End ClosingRevision1End-to-endOptional

Read atreact-console baf6dae3services-accounting f47cb263

The Formal Contract

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

Goal
Determine the permitted recovery action and finish a retained close.
Screens
/console/{tenantId}/accounting/close/runs/{runId}

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/accounting/close/runs/{runId}Inspect a close that failed after recognizing revenue.CAP-ACC-CLS-013The failed step and retained closing state are visible with recovery controls.documented
2closeFiscalPeriodAttempt an ordinary posting and another close while the period is retained.CAP-ACC-CLS-003Both are refused by the protected period or held-run boundary.documented
3cancelFiscalCloseRunRequest cancellation after reviewing its confirmation.CAP-ACC-CLS-012The service refuses because recognition committed and explains retry followed by reopen.test
4retryFiscalCloseRunResume the failed run after resolving its cause.CAP-ACC-CLS-012Execution completes without a duplicate revenue posting.test
5/console/{tenantId}/accounting/close/runs/{runId}Refresh the run page during resumed execution.CAP-ACC-CLS-013The selected run is restored and its progress remains available.observed

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate1Finalization failed without committed recognition.The failure releases the month and retry is refused.Staff can submit a new close after resolving the cause.test
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)
alternate3Cancellation is still eligible before recognition or reversal.The controller cancels the queued or failed request.The period is released and the cancellation remains in history.test
failure3The confirmation promises reversal of finished work.The controller confirms, but the service rejects cancellation after recognition.The refusal supplies recovery guidance after the misleading confirmation.observed

Assertions

IdStatementProvenance
01A failed close retaining its month prevents ordinary postings and competing closes.documented
02Retry completes the retained close without duplicate recognition.test
services-accounting:modules/fiscal-close/tests/integration/services/jobs/revenue-recognition.integration.spec.js#posts August's batch once, under the run's key: the failed attempt left nothing
03The service refuses cancellation after recognition while the confirmation still promises reversal.observed

End-to-end policy: optional: Recovery depends on fault injection unavailable to the current browser journey; integration evidence covers the executable recovery paths.

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.