Rhythm 2.0 Specifications

Appearance

CAP-ACC-REC-015Investigate and resolve reconciliation concerns

Markdown

CAP-ACC-REC-015

Investigate and resolve reconciliation concerns

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-ACC-REC-05
Exercised by
FAS-ACC-REC-05-01, FAS-ACC-REC-05-02, FAS-ACC-REC-05-03, FAS-ACC-REC-05-04, FAS-ACC-REC-05-05
Key concepts
CON-ACC-REC-004
Actors
ACT-ACC-017, ACT-ACC-018, ACT-ACC-007, ACT-ACC-011
Journeys
JNY-ACC-REC-004
Related
CAP-ACC-REC-016, CAP-ACC-REC-017, CAP-ACC-REC-018
Proved by
ATS-ACC-REC-015

Implementation

Executable suites
TST-ACC-REC-024, TST-ACC-REC-040, TST-ACC-REC-041, TST-ACC-REC-042, TST-ACC-REC-043, TST-ACC-REC-061, TST-ACC-REC-066, TST-ACC-REC-079, TST-ACC-REC-095

KindCapabilityProduct areaAccountingModuleReconciliationRevision2

Read atservices-accounting f47cb263react-console baf6dae3

Investigate and resolve reconciliation concerns ​

Purpose ​

Finance staff need a continuing record of a problem and the work used to explain it.

How It Works ​

Rhythm or a staff member records a concern against its financial subjects. A preparer assigns investigation, updates active status and appends what they learn. Responsible people receive attention for an active blocker. Resolution closes a concern only when its applicable condition allows it. A missing settlement that is still overdue needs more investigation or policy acceptance rather than an unsupported resolution.

Relationships ​

Bank review and daily checks detect concerns, policy acceptance concludes understood risks and readiness associates blockers with their financial records.

The Formal Contract

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

Outcomes
Repeated detection does not duplicate an active concern.Missing settlement cannot receive an unsupported resolution.Responsibility holders receive required blocker attention.
Surfaces
consoleapi
Intent sources
services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D6 (architecture §3.4 U10)services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D9 (attention items for the holders of the reconciliation responsibility)services-accounting:docs/milestones/ACCT-M8-payout-reconciliation.md#Built (WP-B4: as_of on exception resolve)

Controls

27 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-006 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-DAT-001 TC-DAT-004 TC-LOG-002 TC-LOG-003 TC-LOG-004 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.reconciliation-exceptions.readapitenant
accounting.reconciliation-exceptions.updateapitenant
accounting.reconciliation-exceptions.updateconsoletenant

Business Rules

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

IdRuleKindEnforced atProvenance
01must prove
Confirmed
A manual problem records its unit, blocker or warning severity, title, description and one to fifty local subjects, optionally an amount, period anchor, owner and up to twenty steps, and receives a number.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D6 (architecture §3.4 U10)
proved by ATS-ACC-REC-015-01, ATS-ACC-REC-015-13, TST-ACC-REC-024, TST-ACC-REC-042, TST-ACC-REC-066
validationapi, service, databasetest
services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a subject the business unit does not have with 400 subject_not_found; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers 200 with the exception open, numbered, of kind manual; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers every subject with the console route that opens it; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers its steps, none done; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a body without a title with 400; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#raises a manual exception about its subjects, answering each subject’s navigation target; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exception-subjects.table.integration.spec.js#refuses the same subject twice for one exception
02must prove
Confirmed
Every exception subject supplies a navigation target for opening its record in the console.
proved by ATS-ACC-REC-015-01, ATS-ACC-REC-015-13, TST-ACC-REC-024, TST-ACC-REC-042, TST-ACC-REC-066
policyservicetest
services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers every subject with the console route that opens it; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers 200 with the exception open, numbered, of kind manual; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers its steps, none done; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a body without a title with 400; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a subject the business unit does not have with 400 subject_not_found; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#raises a manual exception about its subjects, answering each subject’s navigation target; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exception-subjects.table.integration.spec.js#refuses the same subject twice for one exception
03must prove
Confirmed
Detectors suppress an already open, investigating or accepted condition, reopen a resolved condition’s existing problem and clear open problems when their condition disappears.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D6 (architecture §3.4 U10: detectors with dedupe keys)
proved by ATS-ACC-REC-015-02, ATS-ACC-REC-015-12, ATS-ACC-REC-017-10, TST-ACC-REC-043, TST-ACC-REC-066
policyservice, databasetest
services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#reopens the key’s resolved exception, recording `exception.reopened`; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#raises nothing while the key’s exception is open; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#raises nothing while the key’s exception is accepted; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#raises nothing when the dedupe index already holds the key open (two detectors racing); services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#raises a new exception, numbered after the tenant’s highest, with its steps and its event; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#clears the open exceptions of a kind about a subject, recording `exception.auto-resolved`; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exceptions.table.integration.spec.js#refuses a second open exception with the dedupe key of an open one
04must prove
Confirmed
People can assign an owner and move between open and investigating at the current version, while resolved or accepted exceptions reject those edits and reopening belongs to detectors.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D6 (architecture §3.4 U10: not any status to any status)
proved by ATS-ACC-REC-015-03, ATS-ACC-REC-015-11, TST-ACC-REC-066, TST-ACC-REC-095
lifecycleservicetest
services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#refuses open as exception-reopen-by-detector-only; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#allows investigating; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#refuses investigating as exception-closed; services-accounting:modules/reconciliation/tests/unit/rules/transitions.spec.js#allows open; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#sets the owner and moves the exception to investigating, recording `exception.updated`; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#refuses a change at a version that is not the exception’s (409, `stale_version`); services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#refuses an owner or status change of a closed exception (409, `exception_closed`)
05must prove
Confirmed
Notes record their author, cannot be edited or deleted, allow four thousand characters each and stop at two hundred per exception.
proved by ATS-ACC-REC-015-04, TST-ACC-REC-024, TST-ACC-REC-040, TST-ACC-REC-066
validationservice, databasetest
services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#refuses the note after the 200th (409, `notes_limit`); services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a blank note with 400; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exception-notes.table.integration.spec.js#refuses a body of 4001 characters; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exception-notes.table.integration.spec.js#refuses even the owner an UPDATE, by the append-only trigger (RHF32); services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exception-notes.table.integration.spec.js#refuses the owner a DELETE outside a tenant purge, by the append-only trigger (RHF32)
06must prove
Confirmed
Checklist completion records the person and time and supports undo, with at most twenty steps.
proved by ATS-ACC-REC-015-05, TST-ACC-REC-024, TST-ACC-REC-041, TST-ACC-REC-066
lifecycleservice, databasetest
services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#marks a step done by the caller now, and undone again; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a position outside 1 to 20 with 400; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a step the exception does not have with 404; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exception-steps.table.integration.spec.js#refuses a done step without who did it and when
07must prove
Confirmed
Resolution requires written explanation and an open problem; an overdue exception fails while the item remains overdue and unclaimed on the supplied date or today.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D6 (architecture §3.4 U10: resolution text required)
proved by ATS-ACC-REC-003-07, ATS-ACC-REC-007-10, ATS-ACC-REC-015-06, TST-ACC-REC-024, TST-ACC-REC-066
validationservicetest
services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#refuses to resolve as of 2026-10-06, when the item is overdue then (409, `condition_still_holds`); services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#refuses to resolve an overdue-settlement exception while its item is still overdue and unclaimed (409, `condition_still_holds`); services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#resolves an overdue-settlement exception once its item is claimed, recording `exception.resolved`; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#resolves as of 2026-10-05, when the item is only late then, though it is overdue today; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#resolves an exception whose item was written off, as of a later date too (200); services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#refuses to resolve a closed exception (409, `exception_closed`); services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a body without a resolution with 400
08must prove
Confirmed
Open blockers publish required attention for the unit’s reconciliation responsibility, resolution or acceptance closes attention, and the hourly repair sweep republishes missing items and clears stale ones.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D9 (raising attention items for the holders of the reconciliation responsibility)
proved by ATS-ACC-REC-015-07, ATS-ACC-REC-015-14, ATS-ACC-REC-017-12, TST-ACC-REC-061, TST-ACC-REC-079
policyservicetest
services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-blocker-items.integration.spec.js#publishes one open item of the blocker with every element mapped; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-blocker-items.integration.spec.js#publishes nothing for a warning; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-blocker-items.integration.spec.js#resolves a person's resolution resolved; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-blocker-items.integration.spec.js#resolves a second user's approval of the acceptance accepted; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-blocker-items.integration.spec.js#keeps a blocker whose acceptance is only requested open; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-blocker-items.integration.spec.js#publishes the blocker whose item was lost; services-accounting:modules/reconciliation/tests/unit/attention/reconciliation-blockers.spec.js#resolves a blocker lowered to a warning severity_lowered
09must prove
Confirmed
Exception pages sort by descending number and support status, severity, kind, unit, owner and subject filters.
proved by ATS-ACC-REC-015-08, TST-ACC-REC-024, TST-ACC-REC-066
policyservicetest
services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#filters by severity and kind; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers 200 with the exceptions about a subject, newest first; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#pages by the cursor it answers, the last page answering none; services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#filters by status, severity, kind and subject type, newest number first
10must prove
Confirmed
Closed exceptions require a resolution and retain their original kind and condition key.
proved by ATS-ACC-REC-015-09, TST-ACC-REC-043
invariantdatabasetest
services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exceptions.table.integration.spec.js#refuses a resolved exception without its resolution; services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exceptions.table.integration.spec.js#refuses a change of kind (RHF01); services-accounting:modules/reconciliation/tests/integration/db/reconciliation-exceptions.table.integration.spec.js#refuses a change of dedupe_key (RHF01)
11must prove
Confirmed
Exception read governs inspection, update governs ordinary problem work and cross-workspace records are absent.
origin: services-accounting:docs/milestones/plans/ACCT-M8-plan.md#D10 (§2: permissions)
proved by ATS-ACC-REC-015-10, TST-ACC-REC-024
permissionapitest
services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a principal without accounting.reconciliation-exceptions.update with 403; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#lets a principal with the read keys alone list exceptions; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses a principal without accounting.reconciliation-exceptions.read with 403; services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses tenant A’s exception in tenant B with 404
12
Confirmed
The console lists active and resolved exceptions, changes investigation status, appends notes and submits a written resolution, but cannot create problems or update checklist steps.
policyconsoleobserved
react-console:components/accounting/reconciliation/exceptions-screen.tsx:ExceptionsScreen

Scenarios

IdGivenWhenThenProvenance
01A controller suspects a deposit needs investigation.Record and assign its concern, work the checklist and notes, then resolve.History preserves responsible work and closed status prevents further ordinary edits.test
services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#answers 200 with the exception open, numbered, of kind manual
02An overdue capture still has no settlement explanation.Attempt to resolve its exception.The missing-money condition prevents resolution.test
services-accounting:modules/reconciliation/tests/e2e/outstanding.e2e.spec.js#refuses an overdue-settlement exception whose item is still overdue with 409 condition_still_holds

Edge Cases

IdGivenWhenThenProvenance
03The item was only late on an earlier review day.Resolve using that earlier day.The earlier-day condition permits resolution despite today’s overdue state.test
services-accounting:modules/reconciliation/tests/integration/services/persistence/reconciliation-exceptions.integration.spec.js#resolves as of 2026-10-05, when the item is only late then, though it is overdue today

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