Rhythm 2.0 Specifications

Appearance

ATS-ACC-BKS-015Select templates for business documents: Capability Test Specification

Markdown

ATS-ACC-BKS-015

Select templates for business documents: Capability Test Specification

Markdown
  • DocumentProposed
  • Product intentProposed

Planning

Proves capability
CAP-ACC-BKS-015

Design

Executed by
TST-ACC-BKS-020, TST-ACC-BKS-021, TST-ACC-BKS-051, TST-ACC-BKS-052, TST-ACC-BKS-082, TST-ACC-BKS-165

KindAcceptance test setProduct areaAccountingModuleBooks, Business Units and Chart of AccountsRevision2

Read atservices-accounting f47cb263react-console baf6dae3

Select templates for business documents: Capability Test Specification ​

Coverage ​

  • Resolve explicit and configured choices.
  • Reject unusable explicit choices.
  • Require a usable download format.
  • Validate stored selections.
  • Show and protect template users.
  • Reject unusable explicit choices.
  • Clear a unit’s custom content choice.

The structured coverage map distinguishes specified examples from remaining findings. Proposed examples require executable proof before qualification.

  • Release content only after removing its assignment.
  • Statement choice and settings omission change usage together.

Related-capability and workflow references identify the seams each scenario exercises. The lifecycle coverage record retains transitions that still need individual proof.

Binding Review ​

The pinned service and browser assertions support the registered bindings. Original test references remain beside each scenario so partial evidence and unresolved conformance remain reviewable.

Coverage

  • Rule covered
  • Transition covered
  • Validation covered
  • Permission covered
  • Edge gap: FND-ACC-BKS-076
  • Failure covered
  • Boundary covered
  • Concurrency covered
  • Invariant covered
  • Interaction covered

Test Scenarios

11 scenarios proving CAP-ACC-BKS-015; 8 bound to an existing test.

01 Resolve explicit and configured choicesruleunittest
Proves
BR-CAP-ACC-BKS-015-01
Preconditions
Unit templates and a workspace statement default exist.
Steps
Resolve every kind with explicit, configured and empty choices.
Expected
Resolution follows the explicit, configured and applicable built-in order.
Data
The setup needs no extra fixture records.
Bound to
Source
services-accounting:modules/books/tests/unit/document-templates/resolution.spec.js#uses the tenant template named, over the business unit’s
02 Reject unusable explicit choicesfailureunitnegativetest
Proves
BR-CAP-ACC-BKS-015-02 BR-CAP-ACC-BKS-015-06 INV-DOM-ACC-BKS-004-06
Preconditions
Missing, inactive and wrong-kind templates are supplied.
Steps
Resolve them explicitly and resolve an inactive configured fallback.
Expected
Explicit failures are refused; the inactive fallback is passed over for built-in content.
Data
The setup needs no extra fixture records.
Bound to
Source
services-accounting:modules/books/tests/unit/document-templates/resolution.spec.js#refuses an inactive template named explicitly, in Rhythm 1.0’s words
03 Require a usable download formatfailureunitnegativetest
Proves
BR-CAP-ACC-BKS-015-03
Preconditions
QuickBooks Online and Other units have no download template.
Steps
Resolve their downloads and a download with no unit.
Expected
Each unresolved-format request fails.
Data
The setup needs no extra fixture records.
Bound to
Source
services-accounting:modules/books/tests/unit/document-templates/resolution.spec.js#refuses a download for a QuickBooks Online unit, whose entries Rhythm 1.0 pushed through its API
04 Validate stored selectionsvalidationapinegativetest
Proves
BR-CAP-ACC-BKS-015-04 INV-DOM-ACC-BKS-001-07
Preconditions
Templates include different kinds, inactive records, a foreign-workspace record and built-ins.
Steps
Choose them for unit documents and the statement default.
Expected
Only matching active local customer templates are accepted, with invalid fields identified.
Data
The setup needs no extra fixture records.
Bound to
Source
services-accounting:modules/books/tests/e2e/document-templates.e2e.spec.js#answers 400 to a business unit naming a template of another kind
05 Show and protect template usersinvariantapinegativetest
Proves
BR-CAP-ACC-BKS-015-05 INV-DOM-ACC-BKS-004-05
Preconditions
Two units and statement settings refer to templates.
Steps
Read usage and attempt deletion and deactivation.
Expected
Users appear in reads and referenced templates cannot be removed or disabled.
Data
The setup needs no extra fixture records.
Bound to
Source
services-accounting:modules/books/tests/e2e/document-templates.e2e.spec.js#lists each template with who uses it: the unit by id and name, the settings
06 Clear a unit’s custom content choicetransitionapitest
Proves
BR-CAP-ACC-BKS-015-07
Preconditions
The unit names an invoice template.
Steps
Replace the unit while omitting that choice.
Expected
Built-in selection is restored and the freed template becomes removable.
Data
The setup needs no extra fixture records.
Bound to
Source
services-accounting:modules/books/tests/integration/services/persistence/document-templates.integration.spec.js#returns a unit to the built-in when a replacement leaves its reference out
07 Release content only after removing its assignmentinteractionbrowsernegativetest
Proves
AS-JNY-ACC-BKS-004-03
Preconditions
The chapter uses a customer invoice template.
Steps
Delete and deactivate it, clear the choice, then delete it.
Expected
Usage blocks both initial attempts; removing usage permits deletion.
Data
The setup needs no extra fixture records.
Bound to
Source
react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0026.spec.ts#ACT-ACC-0026
08 Exercise the grants for select templates for business documentspermissionapinegativeproposed
Proves
BR-CAP-ACC-BKS-016-01
Preconditions
An application-authorized reader and administrator share the run-owned setup. A third principal lacks the relevant resource grant.
Steps
Read the relevant configuration as the reader, attempt each supported mutation, then repeat with the matching administrator grants. Repeat the reads without their resource grants.
Expected
The permission outcomes match the cited authorization rule, and refused mutations leave every configured value unchanged.
Data
Run-owned records for the stated setup; retain the initial values for comparison.
Source
services-accounting:modules/books/tests/e2e/configuration-security.e2e.spec.js#is refused the create 403 permission_missing
09 No configured content at resolutionboundaryapinegativeproposed
Proves
BR-CAP-ACC-BKS-015-01
Preconditions
An isolated workspace has records needed for both eligible and ineligible examples.
Steps
Resolve each document kind with no explicit or configured customer choice; include each supported software-package download.
Expected
Each result follows the referenced resolution rule or its documented no-format refusal.
Data
Run-owned records for the stated setup; retain the initial values for comparison.
Source
services-accounting:modules/books/tests/unit/document-templates/resolution.spec.js#uses the unit’s invoice template
10 Refuse the second replacement of a shared read versionconcurrencyapinegativeproposed
Proves
BR-CAP-ACC-BKS-016-05
Preconditions
Two administrators read the same version of the relevant mutable record. Each prepares a different otherwise valid replacement.
Steps
Release both replacement requests from a barrier. Read the record again and retry the losing payload at its original version.
Expected
One replacement commits, the other is stale, and repeating the stale request preserves the winning values.
Data
Run-owned records for the stated setup; retain the initial values for comparison.
Source
services-accounting:modules/books/tests/e2e/payment-terms.e2e.spec.js#answers 400 naming is_active to a replacement that leaves it out
11 Statement choice and settings omission change usage togetherinteractionbrowsertest
Proves
BR-CAP-ACC-BKS-015-05 BR-CAP-ACC-BKS-017-05
Preconditions
Run-owned records satisfy the preconditions of the referenced capability proofs.
Steps
Choose a statement default, omit that choice during a settings replacement, inspect template usage and delete the released template.
Expected
The replacement restores built-in selection and releases the old content for removal.
Data
Run-owned records for the stated setup; retain the initial values for comparison.
Bound to
Source
services-accounting:modules/books/tests/e2e/document-templates.e2e.spec.js#answers 409 to deleting the business unit’s template, naming the unit,services-accounting:modules/books/tests/integration/services/persistence/settings.integration.spec.js#keeps both when a later save leaves them out, and puts them back to their defaults when sent

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