SuperAPI AI 工具集

backend-dev-guidelines

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:这是一套面向 Node.js + Express + TypeScript 微服务的后端开发规范,用于约束生产级服务的代码写法,强调可预测、可观测与可维护。

主要能力:定义强制分层架构(routes → controllers → services → repositories → database),禁止跨层与跳层;路由只做转发,业务逻辑放在 service;所有控制器继承 BaseController,统一处理成功与错误响应;服务通过构造函数注入依赖,便于 mock 与测试;Prisma 访问封装在 repository 中,控制器不得直接使用;所有外部输入用 Zod 校验;配置统一从 unifiedConfig 读取,禁止直接使用 process.env;错误统一上报 Sentry,禁止 console.log 与静默失败;异步路由处理器需用 asyncErrorWrapper 包裹;要求 service 单元测试、路由集成测试与复杂查询的 repository 测试。

使用方式:技能在涉及路由、控制器、服务、仓储、Express 中间件、Prisma、Zod、Sentry、配置管理及后端重构或迁移时自动应用。实施前先用 BFRI 评估:BFRI =(架构契合 + 可测试性)−(复杂度 + 数据风险 + 运维风险),6–10 可推进,3–5 需补测试与监控,0–2 需重构或隔离,小于 0 需重新设计。目录结构、命名约定与检查清单均按资料规定执行。

适用场景:长期运行、有真实流量与风险的 Node.js 微服务。

限制:资料未提供安装命令、版本要求、许可与收费信息;具体实现细节以项目实际为准。