用途:为使用 TypeScript 构建可扩展 Node.js 后端应用提供核心模式,强调清晰架构、错误处理与可测试性。
主要能力:
- 分层架构:Route → Controller → Service → Repository → Database,目录示例含 api/routes、api/controllers、api/services、api/repositories、middleware、types、config、utils。
- 异步与错误处理:async/await 基础与控制器模式,Promise.all 并行操作,asyncHandler 包装异步路由,自定义错误类 AppError、NotFoundError、ValidationError。
- 类型模式:请求/响应类型、ApiResponse<T>、IUserService 等服务层接口。
- 配置管理:用 zod 校验环境变量(envSchema),以及统一 config 对象聚合 server、database、auth 等配置。
- 依赖注入:组合根模式与简单 Service Container 注册/获取服务。
- 最佳实践:始终用 async/await 而非 Promise 链,保持分层分离,全面类型标注,避免 any。
适用场景:构建 Node.js 后端服务、实现异步流程、错误处理与日志、配置管理、后端代码测试、分层业务系统。
使用方式与限制:资料未提供安装命令或调用步骤,仅给出架构与代码模式示例、目录结构与最佳实践;如需更多模式可参考 async-and-errors.md、testing-guide.md、architecture-patterns.md。具体版本、平台与收费标准暂未提供。