Skip to main content
Product catalogue and product detail workflows. Products are the sellable catalogue records exposed to storefront clients and managed through authorized back-office workflows.

Data model concepts

A product may be associated with identifiers such as SKU, name, description, price, status, category, brand, media, tax classification, and inventory records. The exact fields and relations are defined by the v6 entities and migrations. Product variants/attributes may be implemented separately or through enabled extensions; do not assume a variant structure without checking the target code.

Common workflows

  • Browse and retrieve product details.
  • Search/filter and paginate catalogue results.
  • Create or update products through authorized management APIs.
  • Associate media, categories, attributes, and inventory.
  • Publish/unpublish or otherwise change catalogue visibility.

Integration guidance

Treat prices and availability returned by the server as authoritative. Do not calculate checkout totals solely in the browser. Escape rendered descriptions, validate SKU uniqueness according to the database constraints, and avoid exposing unpublished products to unauthorized callers.

Verify

Trace product controllers to services and entities. Check joins, tenant filters, visibility rules, price calculations, and any add-on dependencies before documenting concrete request examples.