后端与接口
在构建 Saleor 电商店面时,如何正确使用其…
适用于任何基于 Saleor 电商平台构建店面的前端项目,框架无关,用于查询商品、实现结账、处理多渠道与权限问题。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在构建 Saleor 电商店面时,如何正特定
解决思路
- 按优先级参考四类规则:API(CRITICAL,前缀 api-)、Products(HIGH,前缀 products-)、Checkout(HIGH,前缀 checkout-)、Channels(MEDIUM,前缀 channels-)。
- 遵循 api-data-model:注意可空字段、定价结构,以及自动的店面过滤行为。
- 遵循 api-permissions:区分 token 类型、处理权限错误,并采用两层查询模式(two-tier query pattern)。
- 遵循 api-graphql-patterns:使用按渠道作用域的查询、处理变体属性、过滤,并配置 codegen。
- 遵循 api-investigation:通过类型定义与源码来调查 Saleor API 的实际行为。
- 遵循 products-variants:理解变体模型、选择型与非选择型属性、定价,以及对应的 UX 模式。
- 遵循 checkout-lifecycle:管理会话生命周期、处理常见错误,并调试支付问题。
- 遵循 channels-purchasability:处理库存可用模式(legacy 与 direct,3.23+ 的 useLegacyShippingZoneStockAvailability)、区分可购买性与可配送性、理解履约三角(fulfillment triangle)、使用模式感知清单、按渠道作用域查询,以及库存 webhook。
- 阅读 rules/ 目录下的单个规则文件(如 rules/api-data-model.md、rules/products-variants.md)获取详细说明与代码示例;每个规则文件包含重要性说明、正确与错误代码示例,以及应避免的反模式。
- 如需完整展开所有规则的指南,阅读 AGENTS.md。
适用边界 · 注意事项
- 不适用于非 Saleor 的电商平台或自建电商后端。
- 不适用于与 Saleor 店面无关的通用前端开发任务。