Ubiquitous Language & Domain Glossary

In Domain-Driven Design, the Ubiquitous Language serves as the non-negotiable linguistic foundation shared by domain experts, merchandisers, software architects, warehouse supervisors, and manufacturing engineers. A rigorous, unambiguous vocabulary eliminates semantic confusion, ensures business requirements translate directly into architectural models, and shields domain models from technical or colloquial dilution.

---

1. Domain Terminology Glossary

The core terminology of the PIM bounded context is categorized into functional architectural areas:

Catalog Entities & Identification

Term	Category	Authoritative Business Definition
Product (SPU)	Catalog Entity	The abstract merchandise concept (Standard Product Unit). It encapsulates shared brand identity, core marketing narrative, master taxonomy classification, shared media assets, and attribute family bindings before specific physical options are selected.
Product Variant (SKU)	Catalog Entity	The concrete, physically sellable and stockable item (Stock Keeping Unit). Represents a distinct physical configuration with unique option values, a dedicated barcode, gross weight, packaged dimensions, and inventory accounting.
Natural Business Key	Identity	A stable, universally recognized identifier (such as a SKU code or GTIN) used to link catalog items across external bounded contexts without relying on internal database foreign keys.
Barcode / GTIN	Identity	A standardized optical identifier (such as EAN-13, UPC-A, or GTIN-14) adhering to GS1 check-digit specifications, enabling rapid hardware scanning across warehouse guns and retail registers.
Brand	Entity	The proprietary trademark or commercial identity under which a product line is marketed and legally protected.

Variant Modeling & Matrix Dimensions

Term	Category	Authoritative Business Definition
Option Type	Variant Modeling	A discrete axis along which variants differ physically or functionally (such as Size, Color, Storage Capacity, or Operating Voltage).
Option Value	Variant Modeling	An approved, standardized choice within an Option Type axis (such as Medium or Large for Size; Midnight Blue or Matte Black for Color).
Variant Matrix	Variant Modeling	The mathematical Cartesian product of configured option types representing all allowable physical combinations for a configurable product.
Sparse Matrix	Variant Modeling	A curated subset of theoretical option combinations that a business actually plans, manufactures, or purchases, excluding unproduced permutations.
Option Axis Locking	Invariant Rule	A governance rule preventing the modification or removal of an option type from a product once child variants have been generated and commercially published.

Dynamic Attributes & Schema Modeling

Term	Category	Authoritative Business Definition
Attribute	Dynamic Schema	A strongly-typed descriptive property associated with a product or variant (such as Waterproof Rating, Fabric Composition, or Processor Speed).
Attribute Family	Dynamic Schema	A reusable template defining mandatory and optional attributes, data validation rules, and input groupings for a specific merchandise category.
Attribute Group	Dynamic Schema	A logical clustering of attributes used to organize editing interfaces and technical specifications (such as Dimensions & Weight, Electrical Specs, or Care Instructions).
Typed Value	Dynamic Schema	An attribute value adhering to an explicit structural schema (Text, Numeric, Boolean, Date, Unit Measurement, or Single/Multi Choice).
Unit Registry	Measurement	A centralized catalog of approved international units of measure (UOM) ensuring mathematical consistency across length, volume, weight, and temperature.

Classification & Multi-Tree Taxonomies

Term	Category	Authoritative Business Definition
Master Taxonomy	Classification	The canonical, single-parent category tree utilized for corporate financial reporting, executive rollups, and regulatory compliance.
Merchandising Tree	Classification	A dynamic, multi-parent category hierarchy optimized for digital customer journeys, seasonal promotions, and channel navigation menus.
Leaf Node	Classification	A terminal category containing no further subcategories. Products must be assigned directly to leaf nodes rather than parent classification nodes.
Single-Parent Rule	Invariant Rule	The structural constraint mandating that every product belongs to exactly one leaf node within the Master Taxonomy.

Syndication, Channels & Localization

Term	Category	Authoritative Business Definition
Sales Channel	Syndication	An external commercial touchpoint or marketplace (such as Web Storefront, B2B Portal, Retail POS, or Third-Party Marketplace) with unique catalog requirements.
Locale	Localization	An ISO language and region combination (such as en-US, ar-SA, or fr-FR) governing translations, numeric formatting, and regional compliance labels.
Fallback Cascade	Localization	The deterministic four-tier sequence resolving localized content when a specific channel-locale value is undefined.
Completeness Score	Quality Gate	A calculated percentage representing the completeness of mandatory attributes, translations, and digital assets for a specific sales channel.
Readiness Gate	Invariant Rule	An automated enforcement rule prohibiting the publication of a catalog item to a channel unless its completeness score reaches exactly 100%.

Engineering Recipes & Production (BOM)

Term	Category	Authoritative Business Definition
Bill of Materials (BOM)	Production	An authoritative formulation recipe specifying the raw materials, sub-assemblies, component quantities, and scrap allowances required to produce one finished unit.
BOM Component	Production	A single line item within a BOM defining a required raw material or sub-assembly SKU and its exact required consumption quantity.
Scrap Rate	Production	A calibrated percentage allowance accounting for unavoidable material loss during manufacturing, used to compute gross material requirements.
BOM Revision	Governance	An immutable, version-tagged iteration of a manufacturing recipe (such as Rev A or Rev B) locked upon formal engineering sign-off.
Engineering Change (ECN)	Governance	A formalized engineering workflow initiated to modify an existing recipe, requiring the instantiation of a new sequential BOM revision.

Lifecycle Governance & Sunsetting

Term	Category	Authoritative Business Definition
Lifecycle State	Governance	The discrete operational phase of a catalog item (such as Draft, In Enrichment, In Review, Published, Deprecated, or Archived).
Deprecation	Governance	The sell-down phase of a discontinued product where existing warehouse stock may be sold, but procurement reordering and manufacturing are permanently blocked.
Superseding SKU	Governance	An explicit pointer linking a deprecated item to its newer replacement model, ensuring seamless customer re-routing and search equity preservation.
Archival	Governance	The terminal, permanent read-only state entered only when physical stock reaches zero and all open commercial documents are fulfilled.
Audit Trail	Governance	An append-only, immutable record capturing the actor, microsecond timestamp, origin source, and before/after diff of every catalog mutation.

---

2. Cross-Context Linguistic Translations

In accordance with Learning Domain-Driven Design, terms frequently carry conflicting definitions across different bounded contexts. The table below resolves linguistic ambiguities between PIM and downstream systems:

flowchart LR
    subgraph PIM_Context["PIM Bounded Context"]
        P_PIM["Product = Abstract Marketing Shell (SPU)<br/>Variant = Sellable Item (SKU)"]
    end
    subgraph Downstream_Contexts["Downstream Bounded Contexts"]
        P_WMS["WMS: Stockable Package / Barcode"]
        P_OMS["OMS: Contractual Order Line Item"]
        P_MRP["MRP: Finished Assembly / BOM Parent"]
        P_POS["POS: Scannable UPC with Register Price"]
        P_FMS["FMS: Capital Asset / Cost Valuation Item"]
    end
    P_PIM -->|Translates to| P_WMS
    P_PIM -->|Translates to| P_OMS
    P_PIM -->|Translates to| P_MRP
    P_PIM -->|Translates to| P_POS
    P_PIM -->|Translates to| P_FMS

Term	PIM Definition	Neighboring Context	Neighboring Definition	Architectural Translation Mechanism
Product	High-level marketing container (SPU) holding brand and shared attributes.	Sales / OMS	A commercial line item with contracted pricing, tax rates, and delivery promises.	OMS maps order lines directly to PIM’s Variant (SKU), ignoring the parent SPU container.
Product	Configurable catalog entity.	Inventory / WMS	A physical package with storage dimensions, bin coordinates, and gross weight.	WMS translates PIM’s Variant (SKU) into a Warehouse Master Item, ignoring marketing descriptions.
Product	Commercial merchandise listing.	Manufacturing / MRP	An assembly routing or finished good defined by a Bill of Materials.	MRP maps the SKU to a Manufactured Assembly and binds its approved BOM recipe.
Item	Generic colloquial term discouraged in PIM core models.	Point of Sale (POS)	A scannable barcode record with a localized description and active register price.	POS consumes a lightweight POS Snapshot DTO pairing barcode, title, and tax class.
Category	Hierarchical grouping within Master Taxonomy or Merchandising Trees.	Accounting / FMS	A General Ledger cost center, asset class, or sales revenue tax bucket.	FMS maps PIM’s Master Category Code to an internal Tax & GL Posting Profile.
Price	Baseline catalog MSRP or manufacturer suggested list price.	Sales & Pricing	Dynamic contractual price after tier matrices, volume tiers, and coupons.	Pricing uses PIM’s list price as an initial baseline input before executing discount logic.
Bundle / Kit	Merchandising grouping of multiple SKUs sold together under one price.	Manufacturing (BOM)	An engineering formulation of components assembled into a new physical item.	Kits are picked together at dispatch; BOMs are assembled on factory lines prior to stock putaway.

---

3. Essential Conceptual Distinctions

Product (SPU) vs. Product Variant (SKU)

Comparison Dimension	Product (SPU)	Product Variant (SKU)
Entity Level	Abstract merchandise container.	Concrete physical execution.
Primary Identifier	Product Handle / Internal Product ID.	Natural SKU Code / Optical GTIN Barcode.
Inventory Presence	Non-stockable (cannot exist inside a warehouse bin).	Stockable (exact on-hand unit balance in WMS).
Operational Consumers	Marketing campaigns, web category cards, brand lookbooks.	Warehouse pickers, POS scanners, shipping manifests, BOM component lines.
Owned Attributes	Brand, master category, general description, shared photography.	Exact size, color, weight, package dimensions, barcode symbology.

Descriptive Attribute vs. Structural Option

Comparison Dimension	Descriptive Attribute	Structural Option
Operational Impact	Informative and specification-driven.	Structural and combinatorial.
Inventory Effect	Does not alter inventory counts or SKU identity.	Every unique option combination generates an independent SKU.
Value Cardinality	Typically single-value or multi-select list per product.	Constrained discrete choice set (e.g., Small, Medium, Large).
Typical Examples	Waterproof Rating (28,000 mm), Bluetooth Version (5.3).	Size (Large), Color (Navy), Memory (512 GB).

Master Taxonomy vs. Merchandising Category

Comparison Dimension	Master Taxonomy	Merchandising Category
Governance Authority	Executive finance, procurement, and regulatory compliance.	Marketing teams, commercial merchandisers, and campaign leads.
Structural Rule	Strict single-parent hierarchy; every product has one leaf node.	Dynamic multi-parent DAG; products may appear in multiple nodes.
Temporal Stability	Highly stable; modifications require executive governance review.	Fluid; restructured frequently for seasonal sales and marketing themes.
Downstream Impact	Determines default GL posting profiles and tax classifications.	Dictates digital storefront menus and marketplace discovery filters.

Product Kit / Commercial Bundle vs. Bill of Materials (BOM)

Comparison Dimension	Product Kit / Commercial Bundle	Bill of Materials (BOM)
Organizational Owner	Commercial Merchandising and Sales.	Industrial Engineering and Operations.
Execution Point	Warehouse packing station during sales order fulfillment.	Factory assembly work center or subcontracted manufacturing run.
Assembly Timing	Picked and packed on demand as individual finished items.	Manufactured in advance and received as a new finished good SKU.
Constituents	Finished, commercially sellable SKUs bundled for promotion.	Raw materials, sub-assemblies, bulk liquids, fasteners, and packaging.

Deprecated (Sell-Down) vs. Archived

Comparison Dimension	Deprecated (Sell-Down)	Archived
Commercial Status	Commercially phased out; clearing remaining inventory.	Terminally retired; commercially inactive.
Order Acceptance	Permitted exclusively until existing warehouse inventory hits zero.	Strictly prohibited; blocked on all quotes, orders, and registers.
Procurement Status	Inbound purchase orders and manufacturing work orders blocked.	Permanently closed; no operational transactions allowed.
Replacement Pointer	Features an active superseding_sku pointer to guide customers.	Historical read-only record preserved for legal and tax compliance.
Inventory Requirement	Physical stock balance is greater than zero.	Physical stock balance must equal exactly zero across all locations.