[分享] 一款基于 NestJS 的 DDD 脚手架，开箱即用，助你快手上手

[jarryli]

一款基于 NestJS 的 DDD 脚手架，开箱即用，供需要的人参考

一个基于 NestJS 10 + TypeORM 的领域驱动设计（ DDD ） Node.js 脚手架，内置双数据库、领域事件、统一响应、Swagger 文档与 Docker 一键启动示例。

这是什么

nestjs-ddd 是一个面向 Node.js / TypeScript 的 DDD 工程脚手架，帮你用几分钟时间搭好一个符合 DDD 分层规范的后端服务。

项目内置 用户（ User ） 和 订单（ Order ） 两个示例聚合，用户库走 MySQL 、订单库走 PostgreSQL ，包含 15 个 REST 接口、领域事件发布与监听、Swagger 文档、Docker Compose 一键启动。

功能与 gin-ddd / springboot4ddd 对齐，便于对比不同语言栈在 DDD 工程中的落地差异。

• 项目目录：practice-projects/nestjs-ddd/
• 源码地址：https://github.com/microwind/design-patterns
• 开发指南：NestJS-DDD-Development-Guide.md

层	关注点	约束
接口层	HTTP 协议适配（ VO / 路由 / 过滤器）	不写业务逻辑
应用层	用例编排、事务、DTO / Command	只依赖领域层
领域层	业务规则、聚合、领域事件、仓储接口	零框架依赖
基础设施层	TypeORM 、消息、邮件等技术实现	向上实现领域接口

一句话：MVC 按技术切，DDD 按业务切。业务越复杂，DDD 的价值越明显。

为什么 Node.js 也要用 DDD ？

有人会觉得：Node.js 是不是写写脚本、BFF 就够了，没必要用 DDD ？

结论很简单：用不用 DDD 和语言无关，和业务复杂度有关。

• 小项目：NestJS 默认的 Module / Controller / Service 三件套就够用，没必要上 DDD 。
• 中大型项目（模块超过 10 个、接口超过 50 个、业务规则密集），很容易出现：
  • Service 越写越臃肿，一个方法里掺杂参数校验、业务规则、事务、事件、ORM 细节；
  • 对象退化成只有 getter/setter 的"贫血模型"，业务散落在各个 Service ；
  • 新来的人看不懂代码结构在表达什么业务。
• 这时候用 DDD 就能把代码按业务语义重新切清楚：
  • 聚合根 持有业务规则，不再被 Service 侵蚀；
  • 应用服务 只负责编排和事务，职责非常薄；
  • 仓储接口 + 依赖倒置 让领域层完全独立于数据库/框架。
• TypeScript + NestJS 特别适合落地 DDD：强类型表达值对象/聚合，装饰器 + DI 天然契合依赖倒置，几乎不用造轮子。

本仓库专注于设计模式与架构

https://github.com/microwind/design-patterns