saleor-storefront

Saleor Storefront 是一套面向 Saleor 电商平台的前端店面开发规则集，属于 saleor/saleor-docs 文档项目，用于指导开发者在该平台上构建店面。资料说明其与框架无关，无论使用 Next.js、Remix、Nuxt 还是自定义技术栈，相关规则均适用。\n\n用途：在查询 Saleor GraphQL API 获取商品、分类或集合时；构建带变体选择的商品详情页时；实现结账与支付流程时；处理多渠道、多币种配置时；排查“商品不可购买”或权限错误时；使用 Saleor 3.23+ 库存可用模式（useLegacyShippingZoneStockAvailability）时；通过源码调查 Saleor API 行为时，均可参考该指南。\n\n主要能力按优先级分为四类。API（关键）包括：api-data-model（可空字段、定价结构、店面自动过滤）、api-permissions（令牌类型、权限错误、两级查询模式）、api-graphql-patterns（频道范围查询、变体属性、过滤、codegen）、api-investigation（如何通过类型与源码调查 API 行为）。商品（高）包括 products-variants（变体模型、选择与非选择属性、定价、UX 模式）。结账（高）包括 checkout-lifecycle（会话生命周期、常见错误、支付问题调试）。频道（中）包括 channels-purchasability（3.23+ 旧版与直接库存可用模式、可购买性与可配送性、履约三角、模式感知清单、频道范围查询、库存 webhook）。\n\n使用方式：资料建议阅读各规则文件（如 rules/api-data-model.md、rules/products-variants.md）获取详细说明和代码示例；每个规则文件包含为何重要的简要解释、正确与错误代码示例以及应避免的反模式；完整合辑见 AGENTS.md。\n\n适用场景：适合正在或计划基于 Saleor 构建店面的开发者，尤其是需要处理 GraphQL 数据建模、权限、结账支付、多渠道多币种以及库存可用性判断的前端项目。\n\n限制：资料未提供具体安装命令、依赖配置、收费或价格信息、平台支持范围以及逐步操作教程；以上内容暂未提供。