springboot-init

目录

1. 技术栈配置 | 2. 项目结构 | 3. 编码规范 | 4. 统一响应/异常
2. 权限/工具/命名 | 6. 执行工作流 | 7. 禁止事项 | 8. 代码模板

0. 技术栈配置

1. 项目结构与分层

1.1 核心分层

• manager: 仅当涉及“跨模块协调”或“第三方集成（OSS/短信）”时启用，避免直接耦合。
• common/config: 存放 BaseResponse, GlobalExceptionHandler, MybatisPlusConfig 等。

1.2 数据流向 (Strict)

• DTO (Request): Controller 输入专用。
• VO: Controller 输出专用。严禁将 Entity 直接返回前端。
• Entity: 与数据库表一一对应，仅在 Service/Mapper 层流通。

2. 编码规范

2.1 Controller & Service

• 返回类型：强制使用 BaseResponse<T>。
• 参数校验：多参数封装为对象，使用 @RequestBody + Validation。
• Service：业务逻辑收敛于此。MP 风格：extends ServiceImpl<Mapper, Entity> implements Service。

2.2 Model (Entity/DTO/VO)

• 强制实现：Serializable 并声明 serialVersionUID。
• Java 17+：优先使用 record 定义 DTO/VO。
• MP 注解：@TableName, @TableId(type = IdType.ASSIGN_ID), @TableLogic。

3. 统一响应与异常

• ResultUtils: 提供 success(data), error(errorCode, msg)。
• BusinessException: 业务逻辑错误必须抛出此异常，由 GlobalExceptionHandler 统一捕获。
• ErrorCode: 维护全局状态码（如 40000 参数错误、40100 未登录）。

4. 访问控制 & 工具库

4.1 认证方案

• Sa-Token: 拦截器校验 StpUtil.checkLogin() 或 @SaCheckRole。
• Spring Security: SecurityFilterChain 配置及 @PreAuthorize。

4.2 工具类推荐 (Hutool)

• StrUtil.isBlank, BeanUtil.copyProperties, JSONUtil.toJsonStr, SecureUtil.md5。

5. 命名规范

6. 执行工作流 (Actionable Workflows)

6.1 项目初始化

1. 确认配置：识别 company, project, jdk 等变量。
2. 生成骨架：创建目录树，生成 pom.xml, application.yml (见 templates)。
3. 注入基础类：生成 common, exception, utils, config 包内容。

6.2 模块新增

1. 建模：创建 Entity -> Mapper -> Service。
2. 业务端点：定义 Request/VO (Record) -> Controller 逻辑。
3. 接口文档：补充 Swagger 注解。

7. 禁止事项

1. 禁止 在 Controller 编写任何业务逻辑。
2. 禁止 Entity 跨过 Service 直接暴露给 Controller。
3. 禁止 未经统一异常处理直接抛出原始 Exception。
4. 禁止 硬编码角色或权限字符串。

8. 代码模板

参考 references/code-templates.md，包含： BaseResponse, ErrorCode, BusinessException, GlobalExceptionHandler, ResultUtils, ThrowUtils, MybatisPlusConfig, JsonConfig, OpenApiConfig。