Rhythm 2.0 Specifications

Appearance

CAP-ACC-BKS-017Set accounting policy shared by the workspace

Markdown

CAP-ACC-BKS-017

Set accounting policy shared by the workspace

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationPartially observed

Planning

Feature
FEAT-ACC-BKS-06
Exercised by
FAS-ACC-BKS-05-02, FAS-ACC-BKS-06-02
Key concepts
CON-ACC-BKS-006, CON-ACC-BKS-004
Actors
ACT-ACC-001, ACT-ACC-002
Related
CAP-ACC-BKS-015
Proved by
ATS-ACC-BKS-017

Implementation

Executable suites
TST-ACC-BKS-021, TST-ACC-BKS-027, TST-ACC-BKS-051, TST-ACC-BKS-052, TST-ACC-BKS-069, TST-ACC-BKS-098, TST-ACC-BKS-099

KindCapabilityProduct areaAccountingModuleBooks, Business Units and Chart of AccountsRevision1

Read atservices-accounting f47cb263react-console baf6dae3

Set accounting policy shared by the workspace ​

Purpose ​

Controllers configure policies that apply across the customer’s business units.

How It Works ​

The controller reviews the workspace’s accounting settings. These choices apply consistently across units rather than requiring separate configuration for each one. The initial read presents defaults before a settings record exists. Saving establishes or changes policy at the retrieved version. Transactions and posting use the choices in their own workflows. Reconciliation and close have related switches stored alongside them. Staff resolve a stale save before another replacement can proceed.

Relationships ​

Transactions, posting, reconciliation and close implement the behaviour selected by these settings.

The Formal Contract

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

Outcomes
Default policy applies before settings are first saved.Versioned workspace policy applies across business units.
Surfaces
consoleapi
Intent sources
services-accounting:docs/milestones/plans/ACCT-M1-plan.md#2. Scopeservices-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-9services-accounting:docs/architecture/accounting-2.0/02-decisions.md#M5-2

Controls

24 controls apply, from the corpus control catalogue.

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

Permissions

KeyChecked atScope
accounting.settings.readapitenant
accounting.settings.updateapitenant

Business Rules

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

IdRuleKindEnforced atProvenance
01must prove
Confirmed
Unsaved settings read at version zero with built-in statements, unapplied overpayments, no refund approval, period-based deferral truncation and no required service period; a first version-zero save creates them.
proved by ATS-ACC-BKS-017-01, ATS-ACC-BKS-017-06, TST-ACC-BKS-052, TST-ACC-BKS-098, TST-ACC-BKS-099
lifecycleservicetest
services-accounting:modules/books/tests/integration/services/persistence/settings.integration.spec.js#refuses a first save that is not at version 0
02
Confirmed
Overpayment handling defaults settlement’s unallocated remainder to unapplied payment money or an immediate credit when the request makes no choice.
origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-9
policyservicedocumented
services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-9
03must prove
Confirmed
Enabling refund approval holds a refund until a different person approves it; approval is disabled by default.
proved by ATS-ACC-BKS-017-02, TST-ACC-BKS-027
policyservicetest
react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0047.spec.ts#ACT-ACC-0047
04
Confirmed
Deferral truncation selects remaining-schedule reduction by whole period by default or by days after the credit memo’s effective date.
origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#M5-2
policyservicedocumented
services-accounting:docs/architecture/accounting-2.0/02-decisions.md#M5-2
05must prove
Confirmed
Requiring service periods refuses issuance of deferred lines without one; omitted service-period and truncation settings retain saved values, while an omitted statement choice restores the built-in.
proved by ATS-ACC-BKS-015-11, ATS-ACC-BKS-017-03, TST-ACC-BKS-021, TST-ACC-BKS-098
policyservicetest
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
06must prove
Confirmed
Reconciliation approval defaults on and close bank-verification defaults off; both are stored with settings but belong to their consuming modules’ change paths.
proved by ATS-ACC-BKS-017-04, TST-ACC-BKS-069
policydatabasetest
services-accounting:modules/books/tests/integration/db/reconciliation-configuration.table.integration.spec.js#requires a second person to finalize a reconciliation when the settings do not say
07must prove
Confirmed
Settings reads require read permission, replacements require update permission, and stale versions are refused.
proved by ATS-ACC-BKS-017-05, ATS-ACC-BKS-017-08, TST-ACC-BKS-021, TST-ACC-BKS-051, TST-ACC-BKS-052, TST-ACC-BKS-098
permissionapi, servicetest
services-accounting:modules/books/tests/e2e/document-templates-security.e2e.spec.js#is refused the settings’ save 403 permission_missing

Scenarios

IdGivenWhenThenProvenance
01Refund approval is enabled for the workspace.A clerk submits a refund request.The refund remains pending until another person approves it.test
react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0047.spec.ts#ACT-ACC-0047

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