---
id: TST-COM-CAT-021
title: Product Listings Verification
kind: integration
product_area: commerce
module: catalog
revision: 1
status: draft
product_intent: proposed
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
repository: services-commerce
files:
  - modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js
implements:
  - ATS-COM-CAT-006-01
  - ATS-COM-CAT-006-05
  - ATS-COM-CAT-006-06
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 2
isolation: 'Suite-owned workspace keys and database fixtures, removed by its cleanup hooks.'
binding_evidence:
  - scenario: ATS-COM-CAT-006-01
    source: >-
      services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js#refuses
      a second listing of the product (400) and another listing under the taken slug (400)
  - scenario: ATS-COM-CAT-006-05
    source: >-
      services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js#refuses
      files on a product that is not digital merchandise (none, or physical), and a product that
      goes with itself (400)
  - scenario: ATS-COM-CAT-006-06
    source: >-
      services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js#keeps
      an unchanged picture with its id (no copy), replaces the other (the old one detached), and
      refuses a stale version
  - scenario: ATS-COM-CAT-006-06
    source: >-
      services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js#refuses
      a gallery picture written past the pipeline (a reference the save never prepared)
evidence:
  - >-
    services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js
  - >-
    services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js#Real:
    PostgreSQL, the persistence service, the asset binding over the real `commerce.managed_assets`,
    the execution context under `rhythm_commerce_app`.
  - >-
    services-commerce:modules/catalog/tests/integration/services/persistence/product-listings.integration.spec.js#Doubled:
    S3, by the in-memory storage double.
execution_constraints:
  - No execution is performed in this documentation back-fill.
verification_boundary: >-
  Bindings identify the existing assertions contributing to each scenario; several suites can
  jointly cover a compound scenario.
---

# Product Listings Verification

## Verification Boundary

The suite calls the persistence, database or composed service layer against the integration database. It verifies committed rows and the refusals asserted by its cases.

## What This Suite Proves

The product listings assertions contribute to the scenarios listed in the register. Each binding retains its exact source test anchor so a reviewer can distinguish an individual contribution from the complete scenario.

## What It Does Not Prove

The register records source inspection only. It establishes no run result, delivery qualification or Product approval.

## Real Dependencies and Test Doubles

PostgreSQL and the services called by the suite are real. External service ports, file storage and queues may use the fixtures declared by the suite and its support helpers.

## Must Not Be Doubled

Keep the asserted database constraints, transactions, service functions and execution contexts real. For API suites, preserve the dispatcher and permission enforcement.