SuperAPI AI 工具集

backend-dev-guidelines

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:为 Node.js/Express/TypeScript 应用提供后端开发规范,统一项目结构与各层职责。

主要能力:定义分层架构与请求流:Client → Routes → Controllers → Services → Repositories → Database;给出 src 目录结构(routes、controllers、services、repositories、middleware、validators、types、utils、config)。各层职责:路由定义端点、挂中间件并转发控制器;控制器处理 HTTP 请求响应、提取校验输入、调用服务;服务承载业务逻辑、编排操作与事务;仓储负责数据库操作、查询构建与数据映射(示例使用 Prisma)。

中间件与校验:提供错误处理中间件(区分 AppError 与内部错误,避免暴露内部信息)、基于 Zod 的校验中间件、JWT 认证中间件。错误处理定义 AppError 及 NotFoundError、ValidationError、UnauthorizedError 等子类。

测试:给出服务层单元测试(jest.mock 仓储)与路由集成测试(supertest)示例。

资源文件:database-patterns.md、authentication.md、error-handling.md、testing.md。

限制:资料未提供安装命令、版本要求、收费与平台信息;示例依赖 Express、TypeScript、Prisma、Zod、Jest、supertest,具体配置暂未提供。