SuperAPI AI 工具集

backend-patterns

编程与开发

查看项目

更新于 10-15 20:10

技能介绍

用途:为后端开发提供统一的代码规范与实现模式,帮助在项目中保持 API 路由、数据访问、验证和错误处理的一致性。

主要能力:

  1. API 路由结构:给出 Next.js 认证中间件(withAuth)与 Express.js(authenticate、validate 中间件)的路由示例。
  2. 统一响应格式:提供 apiSuccess、apiError 辅助函数及成功/失败 JSON 结构。
  3. 验证:使用 Zod 定义 schema,包括 createUserSchema、UUID、分页等公共 schema,以及 safeParse 用法。
  4. Repository 模式:以 user.repository.ts 为例展示 create、findById、findByEmail、update、delete 的实现。
  5. 错误处理:结合 try-catch 区分 ZodError、唯一约束冲突等并返回对应状态码。
  6. 检查清单与反模式:列出新建 API 路由时的检查项(认证、验证、统一响应、授权、日志),并指出缺少认证、缺少验证、吞掉错误等反模式。

使用方式:在新建 API 路由或实现 Repository 时参照该技能提供的模式;示例代码基于 Next.js 与 Express.js,数据库示例使用 Drizzle ORM。

适用场景:需要统一后端约定、快速套用常见模式的中小型项目。

限制:资料仅覆盖上述示例与技术栈,未提供安装命令、版本要求、收费信息或平台支持范围。