用途:Configurator Schema 说明 Saleor 店铺配置文件的规范。店铺配置集中在一个 config.yml 文件中,每个区块以声明式 YAML 定义一类实体(渠道、产品、分类等),由 Configurator 同步到 Saleor 实例。适合在编写、阅读或校验 config.yml,以及排查校验失败时参考;若涉及产品类型设计或属性选择,应改用 product-modeling。
主要能力:给出顶层结构,包括 shop、channels、productAttributes、contentAttributes、productTypes、modelTypes、pageTypes、categories、collections、products、models、taxClasses、shippingZones、warehouses、menus。说明实体标识规则:channels、categories、collections、products、warehouses、menus、models 用 slug;productTypes、modelTypes/pageTypes、taxClasses、shippingZones 用 name。修改 slug 或 name 会创建新实体而非更新原实体。列出属性输入类型:DROPDOWN、MULTISELECT、SWATCH、BOOLEAN、PLAIN_TEXT、RICH_TEXT、NUMERIC、DATE、DATE_TIME、FILE、REFERENCE。
使用方式:按实体类型填写必填字段,如渠道需 name、slug、currencyCode;跨实体引用需与已定义名称一致,如产品的 productType 必须匹配 productTypes 中的名称。校验规则包括必填字段、标识唯一、引用有效、货币为 ISO 4217、国家为 ISO 3166-1 alpha-2。依赖层级为:L0 独立(shop、channels、productTypes、pageTypes、taxClasses、shippingZones);L1 依赖 L0(categories、warehouses、attributes);L2 依赖 L1(collections、pages);L3 依赖 L2(products、menus)。Configurator 会自动处理部署顺序。
限制与注意:资料未提供具体安装命令、收费或平台信息。常见错误包括用改 slug/name 的方式重命名、同类型内 slug 重复、引用不存在的 productType、缺少必填字段。建议使用有意义的 slug、命名一致、为复杂区块加注释并用 git 版本控制。完整 schema 与示例见 references/schema.md 和 references/examples.md。