用途:这是 Saleor 无头电商平台(GraphQL API)的领域知识技能,聚焦 Configurator 中会接触到的核心实体,说明它们是什么、如何关联以及约束规则。适用于回答“Saleor 有哪些实体”“渠道、产品与变体如何关联”“slug 与 name 标识符有何区别”“Configurator 管理什么、什么是仅运行时”“什么是 ProductType、Channel”等问题。设计产品类型应改用 product-modeling,编写 YAML 配置应改用 configurator-schema。
主要实体:Channel(销售渠道,代表店面、市场或区域,各自拥有货币、国家、产品可见性与定价);Product Type(定义一组产品的结构,含产品级与变体级属性,以及配送和税务设置);Product 与 Variant(产品属于一个产品类型和一个分类,变体是可购买 SKU,含唯一 SKU、属性值、渠道定价与库存跟踪);Attribute(附加到产品类型的有类型字段,产品级属性跨变体共享,变体级属性生成独立 SKU);Category(层级树状分类,每个产品属于一个分类);Collection(可跨分类的策展式分组,产品可属于多个);Warehouse(库存位置,按变体跟踪库存,关联配送区域);Shipping Zone(按国家定位的地理配送区域,含多种配送方式)。
实体关系:Channel 关联产品与变体上架(可见性、定价、可用性)及结账/订单设置;ProductType 关联产品属性、变体属性与税务类;Product 关联产品类型、分类、集合与变体,变体再关联仓库与渠道上架;Category 为树状含子分类;ShippingZone 关联仓库。
标识符规则:Channel、Category、Collection、Product、Warehouse、Menu、Page 使用 slug;ProductType、PageType、Attribute、TaxClass、ShippingZone 使用 name。标识符不可变,更改标识符会创建新实体并可能使旧实体孤立;如需“重命名”,应删除旧实体再创建新实体。
配置与运行时:Configurator 管理产品结构与定价、分类与集合、属性与渠道、仓库与配送区域、税务类;订单、客户、结账、支付、Webhook 属于仅运行时。
常见错误:混淆 slug 与 name 实体;用改标识符来重命名;在产品类型存在前创建产品;不理解渠道范围(产品需有渠道上架才可见,各渠道定价独立);混淆 Category(层级、每产品一个、用于导航)与 Collection(扁平、每产品多个、用于营销)。
限制:资料未提供具体收费、价格、平台支持范围或效果数据。