---
id: ADR-ACC-BKS-001
title: Shared configuration with explicit writing responsibilities
product_area: accounting
module: books
revision: 1
status: proposed
design_intent: proposed
source_sha:
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
decision: >-
  Books maintains configuration and supplies shared records and helpers. Close
  maintains period standing, Reconciliation maintains settlement fields, and
  maintenance performs provisioning and erasure.
constrains:
  - DOM-ACC-BKS-001
  - DOM-ACC-BKS-002
  - DOM-ACC-BKS-003
  - DOM-ACC-BKS-004
  - DOM-ACC-BKS-006
  - SVC-ACC-BKS-books
  - SVC-ACC-BKS-maintenance
  - RESP-ACC
origin: >-
  services-accounting docs/architecture/accounting-2.0/03-module-structure.md §4
  (module dependencies); FND-ACC-BKS-038
alternatives:
  - option: Require a separate query or read facade.
    why_not: >-
      This is a proposed alternative. Adopting it would require preserving the
      transactional reads on which posting depends and changing the existing
      consumers.
  - option: Replicate configuration into each consuming module.
    why_not: >-
      No configuration change stream currently supports replication. A delayed
      copy could retain an unavailable destination.
consequences:
  - >-
    Committed changes become available according to each reader’s isolation and
    read timing.
  - >-
    Consumers depend on the shared schema and helpers; these reads are not
    separate service operations.
  - Declared restricting references protect records that other modules use.
supersedes: []
evidence:
  - >-
    services-accounting at f47cb263:
    docs/architecture/accounting-2.0/03-module-structure.md §4
  - >-
    services-accounting at f47cb263: imports of modules/books/** from
    modules/batches, billing, fiscal-close, products, reconciliation and
    transactions
---

# Shared configuration with explicit writing responsibilities

## Context

Posting, document production and settlement need the same accounting setup. Accounting consumers read the shared database and import configuration helpers within their own transactions.

## Decision

Books maintains configuration and supplies shared records and helpers. Close maintains period standing, Reconciliation maintains settlement fields, and maintenance performs provisioning and erasure.

## Alternatives Considered

Require a separate query or read facade. This is a proposed alternative. Adopting it would require preserving the transactional reads on which posting depends and changing the existing consumers.

Replicate configuration into each consuming module. No configuration change stream currently supports replication. A delayed copy could retain an unavailable destination.

## Consequences

Committed changes become available according to each reader’s isolation and read timing.

Consumers depend on the shared schema and helpers; these reads are not separate service operations.

Declared restricting references protect records that other modules use.