用途:为 commercetools 构建面向客户的店铺前台,提供从共享 BFF 基础到 B2C、B2B 各界面功能的框架中立生产模式。每条模式以“决策 + commercetools 精确代码”表述,前端框架负责提供文件布局、渲染与路由原语、Cookie 读写绑定等实现细节。
主要能力:核心层涵盖 commercetools SDK 单例、服务端会话、BFF 边界、客户认证、购物车、搜索与分面、数据加载、结账页、商品详情、购物清单、多国家/货币/语言配置、性能与图片配置;可选核心功能含周期性价格与周期性订单。B2C 层含商品列表、PDP、客户认证、结账、导航、UI 组件、变体配置、心愿单,以及超级用户、BOPIS、捆绑商品、促销等可选功能。B2B 层含会话与业务单元、商品列表与 PDP、as-associate 购物车、结账与报价、客户认证、RBAC 权限、报价与审批流、仪表盘、采购清单,以及超级用户、周期性价格与订单等可选功能。
使用方式:按顺序选择技术栈适配器(如 Next.js 16 App Router、Nuxt 4),实现共享基础,再按需加载 B2C 或 B2B 界面及可选功能。首次使用须先运行文档搜索脚本:node "<this skill's directory>/scripts/docs-search.mjs" --query "<key terms>" --app-name "<host app>" --model "<current-model>",可选传入 --commercetools-project-key 与 --commercetools-region。需要 GraphQL 或 REST 模式上下文时,分别运行 scripts/graphql-schemata.mjs 与 scripts/openApi-schemata.mjs,均需 --resource-name、--app-name、--model 参数。
限制:假设存在服务端层(SSR/服务端组件/独立 BFF),BFF 模式不可协商,浏览器不得直接调用 commercetools,密钥不得进入客户端包。会话由服务端管理,客户端仅持不透明引用。B2B 所有写操作须经 apiRoot.asAssociate().*,登录须用 apiRoot.login().post()。具体框架版本门槛、部署命令与完整代码示例见对应栈适配器文档。