SuperAPI AI 工具集

vendure-graphql-writing

写作与研究

查看项目

更新于 10-16 02:31

技能介绍

用途:指导在 Vendure 中按官方模式创建 GraphQL schema 扩展与解析器,为插件增加自定义类型、查询、变更和字段解析器。

主要能力:涵盖 Admin/Shop 双 API schema 定义(gql 模板字面量)、解析器编写(@Resolver、@Ctx 传递 RequestContext、@Allow 权限、@Transaction)、服务注入、字段解析器、分页(PaginatedList)、InputMaybe 处理、错误处理(UserInputError、ForbiddenError)以及权限组合(Public、Authenticated、Owner、具体权限)。

必要用法:先定义 schema,再分别创建 Admin 与 Shop 解析器,最后在插件中通过 adminApiExtensions 与 shopApiExtensions 注册 schema 与 resolvers。禁止缺少 @Ctx()、不用 @Resolver()、绕过 @Allow()、混用 Shop 与 Admin 类型、返回未包装的原始实体等。

适用场景:需要为 Vendure 插件扩展商品类型、客户订单等 GraphQL 接口时。限制:仅插件结构、实体定义或代码评审应改用对应技能;更新可选字段时必须同时判断 undefined 与 null,避免 null 穿透;类型不匹配时需重新生成类型。