Locate products and inspect their configuration

Purpose

A reader narrows the catalogue by product kind, business unit, status or search text.

How It Works

A reader narrows the catalogue by product kind, business unit, status or search text. The API returns ordered pages and a cursor for continuing. The console uses the working unit as its starting context. Staff can deliberately choose all units or include inactive records. Each row helps distinguish a configured product from one still using default accounting. Opening a product shows its stored configuration. Full accounting information depends on a separate permission. A reader without edit authority can inspect the disabled editor. Portal filtering exists as a helper, although a live portal product route is still absent.

Relationships

The product record supplies the identity and configuration used by this outcome.

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: Readers can find and inspect relevant catalogue records.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R9services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R28

Controls

17 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-TEN-004 TC-LOG-004 TC-LOG-005 TC-PI-001 TC-PI-005

Permissions

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

Business Rules

8 rules, 4 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	Product pages sort by name and identity, default to fifty entries, allow limits up to two hundred and provide a continuation cursor when more entries exist. proved by `ATS-ACC-PRD-003-01`, `TST-ACC-PRD-030`, `TST-ACC-PRD-041`	validation	api, service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 400 to a limit above 200
`02` Proposed	Product queries combine kind, status and unit filters with case-insensitive name and identity searches that treat wildcard characters as text.	policy	api, service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#searches LIKE metacharacters literally
`03` Proposed	Product reads include prices, components, selling settings, an accounting summary or none, and the resolved tax class. proved by `ATS-ACC-PRD-003-05`, `ATS-ACC-PRD-018-09`, `ATS-ACC-PRD-019-03`	policy	service	test services-accounting:modules/products/tests/integration/services/persistence/products.queries.integration.spec.js#maps a product whole: every column, its prices, its components and its accounting summary
`04`must prove Proposed	A workspace cannot list or retrieve another workspace’s products. proved by `ATS-ACC-PRD-003-02`, `TST-ACC-PRD-013`, `TST-ACC-PRD-028`, `TST-ACC-PRD-031`	permission	service, database	test services-accounting:modules/products/tests/e2e/products-security.e2e.spec.js#answers tenant B 404 for tenant A’s product
`05`must prove Proposed	Product reads require product read permission, while full accounting setup reads require the separate product-accounting read permission. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-003-03`, `TST-ACC-PRD-028`	permission	api	test services-accounting:modules/products/tests/e2e/products-security.e2e.spec.js#reads the products
`06`must prove Proposed	Readers without product edit authority can inspect the product editor with its controls disabled. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11 proved by `ATS-ACC-PRD-003-04`, `TST-ACC-PRD-012`	permission	console	observed react-console:components/accounting-config/products/product-editor-page.tsx:ProductEditorPage
`07` Proposed	The console defaults to the working unit, keeps tab and unit selections in the address, pages twenty-five records, hides inactive and retired entries by default and identifies missing accounting setup. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R28	policy	console	observed react-console:components/accounting-config/products/products-page.tsx:ProductsList
`08` Proposed	The portal projection removes components, version, accounting summary, confirmation settings, purchase limits and task instructions, retaining only base-currency prices; no portal product route currently uses it.	policy	service	observed services-accounting:modules/products/services/rules/product-rules.ts:portalVisibleProduct

Scenarios

Id	Given	When	Then	Provenance
`01`	Thirty catalogue products span two units.	A reader selects one unit and searches for permit.	Matching names and identities in that unit appear in name order.	test services-accounting:modules/products/tests/integration/services/persistence/products.queries.integration.spec.js#combines the search with a filter
`02`	A product has no accounting setup.	Staff inspect its console row.	The accounting indicator explains that unit defaults apply.	observed react-console:components/accounting-config/products/products-page.tsx:AccountingCell

Planning

Implementation

Locate products and inspect their configuration ​

Purpose ​

How It Works ​

Relationships ​