Understand the available product kinds

Purpose

Finance starts with the catalogue’s product kinds.

How It Works

Finance starts with the catalogue’s product kinds. Each kind tells staff which pricing and selling choices make sense. The shared register also identifies which application owns a domain product. Accounting’s list limits its tabs to the three kinds finance manages directly. Staff choose the appropriate tab before creating a product. Legacy Products remain available for reference but have no console creation action. Inactive domain kinds remain visible through the API register. Product read authority is needed to inspect this register.

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: Product kinds guide appropriate configuration.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R8services-accounting:docs/migrations/accounting-modernization/products-shared/README.md#D-1

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

Permissions

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

Business Rules

8 rules, 6 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	All workspaces share a release-managed register of product kinds that application callers cannot modify. proved by `ATS-ACC-PRD-001-01`, `TST-ACC-PRD-031`	invariant	database	test services-accounting:modules/products/tests/integration/db/products.table.integration.spec.js#refuses the application role an INSERT
`02`must prove Proposed	Accounting kinds appear first: Accounting Products use fixed prices and support bundles, Donation Products take the giver’s amount, and Legacy Products use fixed prices but are never sold. ✓ Legacy Products remain visible as a kind even though they are unsellable.✗ A workspace cannot register an additional Accounting kind for itself. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-001-02`, `TST-ACC-PRD-030`, `TST-ACC-PRD-038`	policy	database, service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers the three Accounting types first, in display order, with their labels and legacy types
`03`must prove Proposed	The register identifies Membership, Commerce and Events kinds by owner and extension record, with membership add-ons and Events kinds inactive. origin: services-accounting:docs/migrations/accounting-modernization/products-shared/README.md#D-1 proved by `ATS-ACC-PRD-001-02`, `ATS-ACC-PRD-001-06`, `TST-ACC-PRD-030`, `TST-ACC-PRD-038`	policy	database	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers the domains’ types after them, each with its owning service and extension table, the Events ones inactive
`04` Proposed	A kind declares its pricing model and whether its products support selling, shipping, inventory, deferral, installments and bundles.	policy	database	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers each type’s pricing model and capabilities
`05`must prove Proposed	Registry reads return every kind in display order with a count and fail if the register exceeds two hundred entries. proved by `ATS-ACC-PRD-001-05`	policy	service	observed services-accounting:modules/products/services/persistence/product-types.ts:listProductTypes
`06`must prove Proposed	Access to the product-kind register requires product read permission. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-001-03`, `TST-ACC-PRD-028`	permission	api	test services-accounting:modules/products/tests/e2e/products-security.e2e.spec.js#reads the product type registry
`07`must prove Proposed	The Accounting Products page provides tabs only for Accounting Products, Donation Products and Legacy Products. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R8 proved by `ATS-ACC-PRD-001-04`, `TST-ACC-PRD-021`	policy	console	observed react-console:components/accounting-config/products/use-products.ts:accountingProductTypesOf
`08` Proposed	The console creates active Accounting-owned kinds except Legacy Products, which require API creation.	policy	console	observed react-console:components/accounting-config/products/use-products.ts:isCreatedHere

Scenarios

Id	Given	When	Then	Provenance
`01`	The workspace catalogue is empty.	A controller visits Products.	The page offers Accounting, Donation and Legacy tabs and explains that legacy items are not sold.	observed react-console:components/accounting-config/products/products-page.tsx:ProductsList
`02`	Membership kinds are available and Events kinds remain inactive.	A caller requests the kind register.	Packages and chapter dues appear active, while Events entries appear inactive.	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers the domains’ types after them, each with its owning service and extension table, the Events ones inactive

Planning

Implementation

Understand the available product kinds ​

Purpose ​

How It Works ​

Relationships ​