用途:为使用 NestJS 与 Drizzle ORM 构建生产级服务端应用提供模式与示例,适合搭建 REST API 或 GraphQL 服务、配置 JWT 认证授权、执行数据库操作与迁移、编写测试以及以 TCP/Redis 传输创建微服务。
主要能力:涵盖 CRUD 模块(Controller→Service→Repository)、class-validator DTO 与 ValidationPipe 校验、JWT 与 Roles 守卫、Drizzle 事务、drizzle-kit 迁移,以及以 @nestjs/testing 和 mock 仓储编写的单元测试。还涉及 Swagger/OpenAPI 文档标注与微服务、GraphQL 的进阶说明。
使用方式:先安装依赖 npm i drizzle-orm pg && npm i -D drizzle-kit tsx;在 src/db/schema.ts 定义 Drizzle 表结构;将 Drizzle 客户端注入为 NestJS provider 形成 DatabaseService;按控制器、服务、仓储分层构建模块并加入 DTO 校验与守卫;测试使用 @nestjs/testing 配合 mock 仓储;迁移执行 npx drizzle-kit generate 核对 SQL 后再运行 npx drizzle-kit migrate。
限制与注意:必须使用 DTO 而非原始对象,事务应保持简短且避免嵌套,JWT 守卫需先于 Roles 守卫执行,数据库连接串与密钥不得硬编码,schema 变更后需先运行迁移再部署,循环依赖应谨慎使用 forwardRef() 并优先重构模块。更详细模式见 references/reference.md、references/drizzle-reference.md、references/workflow-optimization.md。