Save product corrections against the version read

Purpose

An administrator opens a product and works from the version returned by that read.

How It Works

An administrator opens a product and works from the version returned by that read. Saving submits a replacement with the intended collections and optional values. Another writer’s intervening save causes a conflict instead of a silent overwrite. The console explains that conflict and offers a reload. Retired products require reactivation first. Update locks require an explicit change to the lock before replacement can proceed. Hidden console settings are resent from the loaded product. A failed save preserves the previous product and its collections. Confirmation configuration has its own omission behavior, so integrations need to distinguish replacement from an unchanged setting.

Relationships

This outcome uses create a product with a permanent identity.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

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

Outcomes: Corrections respect intervening changes.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D12services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R10

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

Permissions

Key	Checked at	Scope
`accounting.products.update`	api	tenant

Business Rules

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

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	Replacement requires the version originally read and rejects a stale version without persisting changes. proved by `ATS-ACC-PRD-004-01`, `ATS-ACC-PRD-004-11`, `TST-ACC-PRD-007`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	validation	api, service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 409 to a stale version
`02`must prove Proposed	Replacement clears omitted optional fields and replaces every owned collection, except an omitted confirmation setting retains its stored value. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D12 proved by `ATS-ACC-PRD-004-02`, `ATS-ACC-PRD-014-07`, `TST-ACC-PRD-039`, `TST-ACC-PRD-040`	policy	api, service	test services-accounting:modules/products/tests/integration/services/persistence/products.features.integration.spec.js#keeps the confirmation e-mail and its template
`03`must prove Proposed	Replacement rejects a body identity differing from the addressed product and refuses changes to kind or business unit. proved by `ATS-ACC-PRD-004-03`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	validation	api, service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 400 to a body whose id is not the path’s: an id never changes
`04`must prove Proposed	Retired products reject replacement until reactivated. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-004-04`, `ATS-ACC-PRD-005-09`, `ATS-ACC-PRD-007-10`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	lifecycle	service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 409 to replacing a retired product
`05`must prove Proposed	An update-locked product accepts replacement only when the request explicitly removes that lock or reduces it to delete-only; product editors may make that change. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11 proved by `ATS-ACC-PRD-004-05`, `ATS-ACC-PRD-004-10`, `TST-ACC-PRD-040`, `TST-ACC-PRD-044`, `TST-ACC-PRD-066`	permission	api, service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a locked product replaced without stating sys_locked, or with the same lock
`06`must prove Proposed	A failed replacement preserves the previous product, prices and components. proved by `ATS-ACC-PRD-002-15`, `ATS-ACC-PRD-004-06`, `TST-ACC-PRD-040`	invariant	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#leaves the old prices and components when a rule refuses the replacement
`07` Proposed	Product replacement holds the product lock throughout its transaction, serializing it with other product and accounting setup writes.	invariant	service	observed services-accounting:modules/products/services/persistence/products.ts:updateProduct
`08`must prove Proposed	Product replacement requires product update permission. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-004-07`, `TST-ACC-PRD-028`	permission	api	test services-accounting:modules/products/tests/e2e/products-security.e2e.spec.js#is refused replacing a product
`09`must prove Proposed	A replacement naming another workspace is rejected, while submitted pricing model, accounting summary and tax class are discarded as derived values. proved by `ATS-ACC-PRD-004-08`	validation	api	observed services-accounting:modules/products/aws/api/products-api-mapper.ts:toInput
`10`must prove Proposed	Console replacement resends loaded values for availability, portal visibility and settings whose controls are hidden. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R10 proved by `ATS-ACC-PRD-004-09`, `ATS-ACC-PRD-012-04`, `ATS-ACC-PRD-013-05`, `TST-ACC-PRD-006`	policy	console	observed react-console:lib/accounting-config/product-form.ts:formToWrite
`11` Proposed	A console save rejected for a newer version explains the conflict and offers Reload.	policy	console	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0114.spec.ts#ACT-ACC-0114

Scenarios

Id	Given	When	Then	Provenance
`01`	Two administrators read the same product version.	One saves a price and the other then saves a name.	The later save conflicts and offers a reload.	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0114.spec.ts#ACT-ACC-0114
`02`	An API client configured a ceiling, task instructions and quantity bands.	Finance changes the product name through the console.	Those stored settings survive the correction.	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0112.spec.ts#ACT-ACC-0112

Edge Cases

Id	Given	When	Then	Provenance
`03`	A product has an update-and-delete lock.	A replacement repeats the existing lock.	The request fails with lock-removal guidance.	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a locked product replaced without stating sys_locked, or with the same lock

Planning

Implementation

Save product corrections against the version read ​

Purpose ​

How It Works ​

Relationships ​