Skip to content

ATS-ACC-CLS-004Assess a month’s readiness to close: Capability Test Specification

Markdown

ATS-ACC-CLS-004

Assess a month’s readiness to close: Capability Test Specification

Markdown
  • DocumentProposed

KindAcceptance test setProduct areaAccountingModuleMonth-End ClosingRevision1

Read atservices-accounting f47cb263react-console baf6dae3

Coverage

  • Rule covered
  • Transition not-applicable
  • Validation gap: FND-ACC-CLS-060
  • Permission covered
  • Edge gap: FND-ACC-CLS-060
  • Failure covered
  • Boundary covered
  • Concurrency gap: FND-ACC-CLS-060
  • Invariant covered
  • Interaction covered

Test Scenarios

10 scenarios proving CAP-ACC-CLS-004; 9 bound to an existing test.

01 Compute verdicts without treating absence as successruleunittest
Proves
BR-CAP-ACC-CLS-004-02 BR-CAP-ACC-CLS-004-03 INV-DOM-ACC-CLS-002-01
Preconditions
Check lists cover requirements and all outcomes.
Steps
Calculate verdicts and counts.
Expected
Required blockers, pending results and errors prevent readiness; advisory concerns produce warnings; passing lists are ready.
Data
A requirement-by-outcome fixture matrix.
Bound to
services-accounting:modules/fiscal-close/tests/unit/readiness/readiness-verdict.spec.js#is not ready for a required check pending: missing evidence never passes
services-accounting:modules/fiscal-close/tests/unit/readiness/readiness-verdict.spec.js#is ready with warnings for an advisory check blocked, which never blocks
Source
services-accounting:modules/fiscal-close/tests/unit/readiness/readiness-verdict.spec.js#readiness: the verdict
02 Isolate a failed evaluatorruleapinegativetest
Proves
BR-CAP-ACC-CLS-004-04
Preconditions
One evaluator’s read fails.
Steps
Run evaluation through its savepoint.
Expected
Its check reports error with the applicable requirement and other reads remain usable.
Data
An evaluator failure fixture.
Bound to
services-accounting:modules/fiscal-close/tests/unit/readiness/other-checks.spec.js#is an error, never passed, keeping the requirement the tenant’s policy gives it
services-accounting:modules/fiscal-close/tests/integration/services/persistence/readiness-transactions.integration.spec.js#rolls an evaluator’s failure back to its savepoint and keeps the transaction usable
Source
services-accounting:modules/fiscal-close/tests/unit/readiness/other-checks.spec.js#is an error, never passed, keeping the requirement the tenant’s policy gives it
03 Append the year review checksfailureapitest
Proves
BR-CAP-ACC-CLS-004-05 BR-CAP-ACC-CLS-004-08 INV-DOM-ACC-CLS-002-02
Preconditions
A clean period and final-period year case are available.
Steps
Evaluate monthly and fiscal-year scopes.
Expected
Monthly checks remain ordered and year scope adds three checks and relevant effects.
Data
Period and year-end fixtures.
Bound to
services-accounting:modules/fiscal-close/tests/unit/readiness/readiness-verdict.spec.js#adds the year’s close, the next year’s generation and no closing entries for the last period
Source
services-accounting:modules/fiscal-close/tests/integration/services/readiness/evaluate-readiness.integration.spec.js#the fiscal year scope
04 Refuse writes during independent evaluationruleapinegativetest
Proves
BR-CAP-ACC-CLS-004-06 INV-DOM-ACC-CLS-002-05
Preconditions
Evaluation starts without a caller transaction.
Steps
Attempt a write through the evaluation transaction.
Expected
The transaction is read-only and refuses the write.
Data
A write attempt in the readiness transaction fixture.
Bound to
Source
services-accounting:modules/fiscal-close/tests/integration/services/persistence/readiness-transactions.integration.spec.js#refuses a write in it
05 Bound supporting records and preserve totalsinvariantunittest
Proves
BR-CAP-ACC-CLS-004-07 INV-DOM-ACC-CLS-002-03
Preconditions
A check has more than fifty supporting records.
Steps
Build the check response.
Expected
The item list is bounded and the total remains available.
Data
Oversized batch and transaction lists.
Bound to
Source
services-accounting:modules/fiscal-close/tests/unit/readiness/batches-posted.spec.js#keeps the first 50 items and the total beside them
06 Include the viewer’s action authorityboundaryapinegativetest
Proves
BR-CAP-ACC-CLS-004-09 INV-DOM-ACC-CLS-002-06
Preconditions
A clean period is viewed by a closer and a reader.
Steps
Evaluate each caller’s readiness.
Expected
The closer is ready while only the reader’s authority check blocks.
Data
Two permission profiles on one clean period.
Bound to
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#answers 200, ready, to a closer: the slice carries the close key the route evaluates
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#answers a reader not ready, blocked by close_authorization alone
Source
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#answers a reader not ready, blocked by close_authorization alone
07 Validate readiness boundaries and workspace scopepermissionapinegativetest
Proves
BR-CAP-ACC-CLS-004-10
Preconditions
Two workspaces each contain a period.
Steps
Request invalid periods and scopes, a foreign year and the second workspace’s own period.
Expected
Invalid requests fail and each workspace receives only its own information.
Data
Two workspace calendars and malformed requests.
Bound to
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#answers B its own September, never A’s (B’s open batch blocks it)
Source
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#the readiness
08 Reevaluate changed ledger and payment evidence before closinginteractionapiproposed
Proves
BR-CAP-ACC-CLS-004-02 BR-CAP-ACC-CLS-004-08 BR-CAP-ACC-CLS-004-11
Preconditions
An ended month has ledger work, a payment finding and a due schedule with incomplete accounts.
Steps
Review each supporting section; resolve those causes, reread readiness, then change ledger evidence before the job revalidates.
Expected
The overall review responds to each section, and execution uses its own evaluation rather than the earlier screen result.
Data
An ended month has ledger work, a payment finding and a due schedule with incomplete accounts.
Source
rhythm-v2-docs:specs/accounting/close/design/workflows/WF-ACC-CLS-005-evaluate-a-month-s-close-readiness.md#What It Does,services-accounting:modules/fiscal-close/tests/unit/readiness/readiness-verdict.spec.js#is not ready for a required check pending: missing evidence never passes,services-accounting:modules/fiscal-close/tests/unit/readiness/readiness-verdict.spec.js#lists a month’s close in order,services-accounting:docs/fiscal-close/README.md#3. Readiness checks (month-end)
09 Refuse readiness without read authoritypermissionapinegativetest
Proves
BR-CAP-ACC-CLS-004-10
Preconditions
A caller has application access but lacks fiscal-period read authority.
Steps
Request period readiness.
Expected
Access is denied before readiness is returned.
Data
A caller has application access but lacks fiscal-period read authority.
Bound to
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#refuses a principal without accounting.fiscal-periods.read with 403
Source
services-accounting:modules/fiscal-close/tests/e2e/fiscal-close-readiness.e2e.spec.js#refuses a principal without accounting.fiscal-periods.read with 403
10 Keep the readiness transaction usable after evaluator failurefailureapinegativetest
Proves
INV-DOM-ACC-CLS-002-02
Preconditions
A standalone readiness transaction has begun.
Steps
Run a failing database expression inside an evaluator savepoint, catch the failure and run another read in the outer transaction.
Expected
The evaluator fails, its savepoint rolls back and the next outer read succeeds.
Data
A standalone readiness transaction has begun.
Bound to
services-accounting:modules/fiscal-close/tests/integration/services/persistence/readiness-transactions.integration.spec.js#rolls an evaluator’s failure back to its savepoint and keeps the transaction usable
Source
services-accounting:modules/fiscal-close/tests/integration/services/persistence/readiness-transactions.integration.spec.js#rolls an evaluator’s failure back to its savepoint and keeps the transaction usable

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.