entity

Variant Parameter

L3 junction linking a ProductVariant to selected ParameterValue records for one ParameterKey (renamed from parameter_assignments).

EntityStatus: Implemented in api-v1

Purpose

Variant parameters are the level-3 junction (O4 rename of legacy parameter_assignments / variant_parameters Airtable table). They record which canonical values a concrete product variant carries for each key. Stock option universes derive from the set of variant parameters across all variants of a model (ADR-0008).

This junction genuinely belongs to product-marketplace. The keys and values it points at do not — ParameterKey and ParameterValue are owned by BIM Ontology.

VariantParameter is a value object colocated with the ProductVariant aggregate in product-variant/ProductVariant.ts rather than in a directory of its own, which is why the source link points there. In the domain model it carries no identity of its own — only the key reference and the selected values; the identity belongs to the Airtable junction row.

The scraped parameter graph adapter is the sole writer of PM variant_parameters records during bulk scrape persistence.

Invariants

  • Must contain at least one parameter value per key binding.
  • References canonical keys and values by synced PM mirror record IDs after taxonomy sync.
  • Legacy ParameterAssignment type alias is deprecated; use VariantParameter.
  • ForCreatingScrapedParameterGraph
  • ForLinkingVariantParameters
  • ForStoringPendingParameterLinks
  • ForManagingProductVariants

OpenAPI Operations

No dedicated REST endpoint; written during scrape persistence. See Parameter Graph Persistence.

ADRs