企业官网建设流程全解析

后端模式（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/中实际的项目结构调整所有路径和模块名称。