单体项目结构

二、层级调用流程（核心执行顺序）

前端请求 → Controller → DTO 接收参数 → Service 业务层 → Mapper 持久层 → MySQLService 层可调用：Redis 工具、OSS 工具、自定义工具、ThreadLocal 上下文、定时任务

三、每层职责详细说明

1. controller 控制层只做三件事：接收参数、调用 service、返回统一 Result，禁止写业务逻辑

2. service 业务层核心业务、事务、多表操作、缓存逻辑、数据组装；所有复杂逻辑放这里

3. mapper 持久层仅负责数据库操作，不处理业务

4. entity(PO)与数据库表完全映射，只存字段，不做传输

5. DTO前端传给后端的参数载体，做参数校验

6. VO后端返回给前端的数据载体，封装组装后数据，脱敏

7. config框架配置、拦截器、插件、第三方组件初始化

8. common全局公共代码：工具、异常、返回体、常量、上下文

四、包分层规范口诀

控制收参，服务写业务，Mapper 操作库；PO 映射表，DTO 收请求，VO 返前端；公共工具放 common，所有配置归 config。