Present the store’s available products

Purpose

Shoppers receive the catalog presentation and prices appropriate to their store and identity.

How It Works

A shopper opens a store list or an individual product page. Commerce filters candidates using store, listing, product and eligibility information. The result combines listing text with the requested price and availability presentation. Anonymous browsing includes public-price information and notices about what signing in may change. Signed-in browsing uses the buyer’s own context. Console inspection additionally explains excluded candidates to staff. Unknown or closed stores and excluded pages return the supported absence response. The product should prove the eventual live portal journey before treating API and mock evidence as browser delivery.

Relationships

The configure a store’s offered assortment capability supplies related configuration or assessment used in this work.

The prepare and publish product presentations capability supplies related configuration or assessment used in this work.

The calculate and explain a buyer’s item price capability supplies related configuration or assessment used in this work.

The organize product shelves capability supplies related configuration or assessment used in this work.

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: Shoppers see exclusively what is for sale to them.Authenticated buyers receive their applicable pricing and visitors receive public amounts with sign-in guidance.
Surfaces: portalapi
Intent sources: services-commerce:docs/milestones/COMM-M1-set-up-what-you-sell.md#D8services-commerce:docs/milestones/COMM-M1-set-up-what-you-sell.md#D10

Controls

21 controls apply, from the corpus control catalogue.

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

Permissions

Key	Checked at	Scope
`commerce.storefront.read`	api	tenant

Business Rules

10 rules, 7 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	A visible store item requires an active store, an admitted category, a published listing or direct-page unlisted listing, and an active Accounting product currently on sale and visible to the portal. origin: COMM-M1 D8 (docs/milestones/COMM-M1-set-up-what-you-sell.md) no proof recorded yet	policy	service	test services-commerce:modules/catalog/tests/unit/storefront/storefront-visibility.spec.js#removes a product not yet on sale, and one whose sale has ended (the end exclusive)
`02`must prove Proposed	Signed-in buyers lose products their purchase eligibility refuses; anonymous visitors retain those products with a notice that signing in may change availability. no proof recorded yet	policy	service	test services-commerce:modules/catalog/tests/integration/services/storefront/storefront-listings.integration.spec.js#is not evaluated for eligibility: a bound product is shown, flagged that signing in may change its availability
`03`must prove Proposed	Visitors receive Standard pricing alongside only publicly displayed audience prices and a notice that authentication may change pricing. origin: COMM-M1 D10 (docs/milestones/COMM-M1-set-up-what-you-sell.md) no proof recorded yet	policy	service	test services-commerce:modules/catalog/tests/e2e/storefront.e2e.spec.js#shows the audiences marked for public display beside the Standard price (D10): the Members price 2000, with its audience
`04`must prove Proposed	Storefront pricing uses the signed-in buyer’s own identity. no proof recorded yet	policy	service	test services-commerce:modules/catalog/tests/e2e/storefront.e2e.spec.js#prices a portal member as themselves (the recorded member: the member price, nothing signing in could change)
`05` Proposed	Absent an explicit sort, storefront lists use configured merchandising order with featured items first; search matches names and headlines and pages contain at most sixty items.	policy	service	test services-commerce:modules/catalog/tests/integration/services/storefront/storefront-listings.queries.integration.spec.js#answers the published listings that sell now, featured first then in sort order, under the rule `all`
`06` Proposed	Currency prohibition leaves a product visible with an unavailable-in-currency indication.	policy	service	test services-commerce:modules/catalog/tests/integration/services/storefront/storefront-listings.integration.spec.js#sees a prohibited currency as unavailable_in_currency, the listing kept
`07`must prove Proposed	Availability uses descriptive words and displays units on hand only when the listing enables a remaining count. no proof recorded yet	calculation	service	test services-commerce:modules/catalog/tests/unit/storefront/storefront-availability.spec.js#shows the units on hand when the listing shows its remaining count
`08`must prove Proposed	Inactive stores return empty lists, unknown stores are not found, and draft or out-of-assortment products have no storefront page. no proof recorded yet	policy	service	test services-commerce:modules/catalog/tests/integration/services/storefront/storefront-listings.integration.spec.js#opens an unlisted product by its page, and is answered 404 for a draft and for a product another store does not sell
`09` Proposed	Console readers receive removal reasons for excluded listings and a diagnostic product page rather than an unexplained not-found result.	policy	service	test services-commerce:modules/catalog/tests/integration/services/storefront/storefront-listings.integration.spec.js#is told, per listing a rule removed, which rule
`10`must prove Proposed	Public storefront requests need no authentication, use the addressed workspace alone, refuse unavailable workspaces and ignore supplied signed context. no proof recorded yet	permission	api	test services-commerce:modules/catalog/tests/e2e/catalog-security.e2e.spec.js#ignores a signed context it is handed: no diagnosis, the public prices

Scenarios

Id	Given	When	Then	Provenance
`01`	Style Guide is published in an active store with Standard and public Member prices	Browse without authentication	Its presentation includes both prices and the notice that signing in may change pricing	test services-commerce:modules/catalog/tests/e2e/storefront.e2e.spec.js#shows the audiences marked for public display beside the Standard price (D10): the Members price 2000, with its audience
`02`	The dinner requires a membership binding	Browse as a signed-in contact who fails the rule	The product is excluded without a shopper-facing diagnostic trace	test services-commerce:modules/catalog/tests/integration/services/storefront/storefront-listings.integration.spec.js#who is not a member loses the dinner to the binding, with no trace on the page

Planning

Present the store’s available products ​

Purpose ​

How It Works ​

Relationships ​