用途:backend-patterns 是一份后端代码规范与模式集合,用于在编写后端代码时参照统一的实现约定。使用时机包括:新建 API 路由、实现 Repository、设计校验、实现错误处理,以及确认后端最佳实践。
主要能力与内容:
- API 路由结构:给出 Next.js 与 Express.js 的认证模式示例,如 withAuth 中间件包裹 GET/POST,Express 使用 authenticate 与 validate 中间件。
- 统一响应格式:提供 apiSuccess 与 apiError 函数,成功响应含 success、data、timestamp;错误响应含 success、error、code、timestamp,可设置状态码。
- 校验:使用 Zod 定义 schema(如邮箱、名称、角色枚举),以 safeParse 处理结果;并提供 UUID 与分页等通用 schema。
- Repository 模式:给出基于 Drizzle ORM 的基本结构,包含 create、findById、findByEmail、update、delete 等方法示例。
- 错误处理:在路由中 try-catch,区分 ZodError(400)、唯一约束冲突(409)与内部错误(500),并输出日志。
- 检查清单:新建 API 路由时确认认证中间件、请求校验、统一响应、错误处理、授权检查与日志输出。
- 反模式:指出无认证、无校验、吞掉错误等问题写法。
使用方式:在相应开发场景中参照该技能中的模式与示例代码编写后端逻辑。
限制:资料未提供安装命令、平台支持范围、收费信息或实际运行效果;示例以 Next.js、Express.js 与 Drizzle ORM 为主,是否适用于其他技术栈暂未提供。