entity
Product Reference
Value object pointing at a product-marketplace product, variant, or MTO template. Not a catalog record.
EntityStatus: Implemented in api-v1Value Object
Purpose
A product reference is how design-management points at catalog records it does not own. Product browse, search, and vendor collections stay in product-marketplace.
productVariantId is the Product Marketplace catalog variant domain_id. It is not a Design product_variants row. Design product_variants is an Assigned Variant Projection (Airtable UI materialization, ADR-0082), not a Design aggregate. Collection items may link that projection row in Airtable for lookups; domain identity stays the catalog id.
This is a value object. It has no lifecycle and no persistence table of its own. Identity for duplicate detection is the composite key.
Invariants
- At least one of
productModelId,productVariantId, orproductMtoIdis required. equalscompareskeyvalues.
Domain Events
None.