--- id: JNY-ACC-BKS-001 title: Prepare a new chapter’s books feature: FEAT-ACC-BKS-01 product_area: accounting module: books revision: 1 status: draft product_intent: confirmed implementation_evidence: observed supersedes: - ACT-ACC-0001 - ACT-ACC-0008 - ACT-ACC-0009 - ACT-ACC-0011 - ACT-ACC-0018 source_sha: services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8 react-console: baf6dae382d6f41dce976c7f848667ccc37e076f actor: ACT-ACC-001 goal: Give the chapter the configuration it needs for invoice and posting work. capabilities: - CAP-ACC-BKS-001 - CAP-ACC-BKS-009 - CAP-ACC-BKS-005 - CAP-ACC-BKS-006 - CAP-ACC-BKS-007 - CAP-ACC-BKS-011 screens: - '/console/{tenantId}/configuration/accounting/businessUnits' - '/console/{tenantId}/configuration/accounting/fiscalYears' - '/console/{tenantId}/configuration/accounting/glAccounts' - '/console/{tenantId}/configuration/accounting/bankAccounts' - '/console/{tenantId}/configuration/accounting/paymentTerms' steps: - 'n': 1 surface: '/console/{tenantId}/configuration/accounting/businessUnits' action: >- Create the Pacific chapter in USD with a July fiscal start and complete settings. capability: CAP-ACC-BKS-001 expected: >- The name-derived unit identity is saved and the working-context choice appears immediately. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0001.spec.ts#ACT-ACC-0001 - 'n': 2 surface: '/console/{tenantId}/configuration/accounting/fiscalYears' action: Inspect the chapter’s fiscal years. capability: CAP-ACC-BKS-009 expected: >- The initial 2026–2027 and 2027–2028 years each contain twelve open periods. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0001.spec.ts#ACT-ACC-0001 - 'n': 3 surface: '/console/{tenantId}/configuration/accounting/glAccounts' action: >- Enter receivable, cash, deferral, revenue and tax payable accounts, including a lower-case code. capability: CAP-ACC-BKS-005 expected: Codes are normalized to upper case and duplicate local codes fail. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0009.spec.ts#ACT-ACC-0009 - 'n': 4 surface: '/console/{tenantId}/configuration/accounting/glAccounts' action: Use the missing-default notice to complete the assignment drawer. capability: CAP-ACC-BKS-006 expected: Every purpose returns its selection and the notice clears. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0008.spec.ts#ACT-ACC-0008 - 'n': 5 surface: '/console/{tenantId}/configuration/accounting/bankAccounts' action: >- Record the operating bank destination with its four-digit suffix and cash account. capability: CAP-ACC-BKS-007 expected: The list displays masked number information and the chosen GL destination. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0011.spec.ts#ACT-ACC-0011 - 'n': 6 surface: '/console/{tenantId}/configuration/accounting/paymentTerms' action: Create a thirty-day payment term. capability: CAP-ACC-BKS-011 expected: The saved term becomes available for invoice selection. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0018.spec.ts#ACT-ACC-0018 alternates: - from_step: 4 condition: An account from another unit is submitted as a default. path: The refusal identifies the mismatched units. outcome: The previous purpose selection remains. provenance: test source: >- services-accounting:modules/books/tests/e2e/default-gl-accounts.e2e.spec.js#answers 400 to another unit’s GL account, naming both units failures: - from_step: 5 condition: The supplied bank suffix contains five digits. path: Validation identifies the invalid suffix. outcome: No bank record is saved. provenance: test source: >- services-accounting:modules/books/tests/e2e/bank-accounts.e2e.spec.js#answers 400 to an account_number_last4 of five digits rules_in_play: - BR-CAP-ACC-BKS-001-01 - BR-CAP-ACC-BKS-001-03 - BR-CAP-ACC-BKS-001-08 - BR-CAP-ACC-BKS-005-01 - BR-CAP-ACC-BKS-006-02 - BR-CAP-ACC-BKS-006-07 - BR-CAP-ACC-BKS-007-01 - BR-CAP-ACC-BKS-007-02 - BR-CAP-ACC-BKS-011-01 assertions: - id: AS-JNY-ACC-BKS-001-01 statement: >- The saved chapter includes its initial calendar and appears among working-unit choices. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0001.spec.ts#ACT-ACC-0001 - id: AS-JNY-ACC-BKS-001-02 statement: All assigned purposes use active accounts belonging to the chapter. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0008.spec.ts#ACT-ACC-0008 - id: AS-JNY-ACC-BKS-001-03 statement: Reading the bank destination and term confirms the submitted values. provenance: test source: >- react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0011.spec.ts#ACT-ACC-0011 e2e_policy: required e2e_reason: >- The outcome depends on connected configuration screens and a refreshed working context. evidence: - >- Verified source file: react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0001.spec.ts - >- Verified source file: react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0008.spec.ts - >- Verified source file: react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0009.spec.ts - >- Verified source file: react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0011.spec.ts - >- Verified source file: react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0018.spec.ts - >- Verified source file: services-accounting:modules/books/tests/e2e/bank-accounts.e2e.spec.js - >- Verified source file: services-accounting:modules/books/tests/e2e/default-gl-accounts.e2e.spec.js proved_by: [] --- # Prepare a new chapter’s books ## Story The controller opens a set of books for the Pacific chapter, checks its initial calendar and enters the chart. From the chart they complete posting defaults, then record the deposit destination and payment terms. They finish by reading the saved configuration so the chapter can proceed with financial work.