后端模式NestJS模块架构尖叫架构每个业务模块都是一个包含其自身模块、控制器和服务的目录src/{feature}/ {feature}.module.ts # NestJS module {feature}.controller.ts # REST routes {feature}-crud.service.ts # Business logic constants.ts # Module constants __tests__/ # Unit tests规则DTO 使用验证装饰通过全局管道ZodValidationPipe 或 class-validator进行验证。动态/不可建模的请求体在控制器中接收为unknown在服务中转换为最具体的接口——绝不使用any。在拆分大型服务时每个新服务只注入它自己的依赖项。服务从共享包注入数据库服务而不是直接注入生成的客户端。角色检查直接使用共享包中的枚举值。使用nestjs/swagger装饰器来记录公开的端点文档。错误处理全局异常过滤器捕获所有未处理的异常。处理数据库错误唯一约束、未找到、外键、关系冲突。输入的业务错误与代码一致的消息。常见情况下的标准 HTTP 异常。自动记录 500 的错误及堆栈跟踪。生成规则仅当在依赖项中检测到nestjs/core时才使用此模板。根据src/中实际的项目结构调整所有路径和模块名称。