product-modeling

用途：在 Saleor 中设计商品目录结构，决定商品类型、属性、变体、分类与集合的划分。核心流程为：属性定义可复用字段，商品类型把属性组装为模板（productAttributes 同商品共用，variantAttributes 生成 SKU 组合），商品是类型的实例，变体是可购买 SKU。关键建模决策是区分商品级与变体级属性：所有变体相同值（品牌、材质、描述、筛选用途）放商品级；生成独立可购项、影响价格或需独立库存（尺寸、颜色、存储）放变体级。属性类型按决策树选择：预定义选项多选为 MULTISELECT，颜色/图案为 SWATCH，是否类为 BOOLEAN，单项为 DROPDOWN，带单位数字为 NUMERIC，日期为 DATE/DATE_TIME，长格式文本为 RICH_TEXT，文件为 FILE，引用其他实体为 REFERENCE，其余为 PLAIN_TEXT。变体需先计算 SKU 爆炸：SKU 数=各维度取值相乘；1-10 可管理，11-50 中等，51-100 偏高，100+ 建议简化，把非可购买属性上移到商品级。分类为层级树、一商品属一类，适合导航、筛选与 SEO；集合为扁平列表、一商品可属多集合，适合促销与策展；分类树建议不超过 3 层。模型（页面/页面类型）用于品牌等共享实体，结构（菜单）组装导航。设计新商品类型流程：列特性、按框架归类、选属性类型、算 SKU 数、写 YAML、用 --plan 部署校验。常见错误：变体维度过大、把非库存字段放变体级、把应随尺寸变化的字段放商品级、商品类型过多、跳过变体规划。该技能不负责 YAML 语法与 CLI 命令，相关需求应使用 configurator-schema 与 configurator-cli。