add

mis-spec/references/mvc_dir.md

@@ -7,7 +7,6 @@ com/example/project/
 │
 ├── controller/                    # 控制器层（接收请求）
 │   ├── UserController.java
-│   ├── ProductController.java
 │   └── ...
 │
 ├── service/                       # 业务逻辑层
@@ -17,19 +16,15 @@ com/example/project/
 │   └── ...
 │
 ├── mapper/                        # 数据访问层（MyBatis Mapper）
-│   ├── UserMapper.java
 │   ├── ProductMapper.java
 │   └── ...
 │
 ├── domain/                        # 领域层（聚合所有数据对象）
 │   ├── entity/                    # 实体类（与数据库表对应）
-│   │   ├── User.java
 │   │   ├── Product.java
 │   │   └── ...
 │   │
 │   ├── dto/                       # 数据传输对象（输入参数）
-│   │   ├── UserLoginDTO.java
-│   │   ├── UserRegisterDTO.java
 │   │   ├── ProductQueryDTO.java
 │   │   └── ...
 │   │
@@ -40,36 +35,18 @@ com/example/project/
 │       └── ...
 │
 ├── config/                        # 配置类
-│   ├── WebConfig.java
 │   ├── DataSourceConfig.java
-│   ├── SecurityConfig.java
 │   └── ...
 │
-├── exception/                     # 异常处理
+├── utils/                          # 工具类
-│   ├── GlobalExceptionHandler.java
-│   ├── BusinessException.java
-│   └── ...
-│
-├── interceptor/                   # 拦截器
-│   ├── LoginInterceptor.java
-│   ├── LogInterceptor.java
-│   └── ...
-│
-├── aspect/                        # AOP切面（可选）
-│   ├── LogAspect.java
-│   └── ...
-│
-├── util/                          # 工具类
-│   ├── JwtUtil.java
 │   ├── DateUtil.java
 │   └── ...
 │
-├── constant/                      # 常量类
+├── constants/                      # 常量类
 │   ├── StatusCode.java
 │   └── ...
 │
 ├── enums/                         # 枚举类
-│   ├── UserRoleEnum.java
 │   ├── ResultCodeEnum.java
 │   └── ...
 │
@@ -80,19 +57,16 @@ com/example/project/
 
 | 包名 | 职责 | 关键注解 | 典型类名示例 |
 |------|------|----------|-------------|
-| **controller** | 接收HTTP请求，参数校验，调用Service层，返回VO给前端 | `@RestController`<br>`@RequestMapping`<br>`@Validated` | `UserController.java`<br>`ProductController.java` |
+| **controller** | 接收HTTP请求，参数校验，调用Service层，返回VO给前端 | `@RestController`<br>`@RequestMapping`<br>`@Validated` | `UserController.java` |
 | **service** | 业务逻辑处理，事务管理，调用Mapper层，组装数据 | `@Service`<br>`@Transactional` | `UserService.java`（接口）<br>`UserServiceImpl.java`（实现） |
-| **mapper** | 数据库CRUD操作，SQL映射，与数据库交互 | `@Mapper`<br>`@Repository`<br>`@Select`/`@Insert`等 | `UserMapper.java`<br>`ProductMapper.java` |
+| **mapper** | 数据库CRUD操作，SQL映射，与数据库交互 | `@Mapper`<br>`@Repository`| `UserMapper.java` |
-| **domain/entity** | 数据库表映射实体，与表结构一一对应 | `@TableName`（MyBatis-Plus）<br>`@Entity`（JPA）<br>`@Id`<br>`@Column` | `User.java`<br>`Product.java`<br>`Order.java` |
+| **domain/entity** | 数据库表映射实体，与表结构一一对应 | `@TableName`（MyBatis-Plus）| `User.java` |
-| **domain/dto** | 接口输入参数对象，用于接收前端请求数据，可添加校验注解 | `@Data`<br>`@NotBlank`/`@NotNull`等校验注解 | `UserLoginDTO.java`<br>`UserRegisterDTO.java`<br>`ProductQueryDTO.java` |
+| **domain/dto** | 接口输入参数对象，用于接收前端请求数据，可添加校验注解 | `@Data`<br>`@NotBlank`/`@NotNull`等校验注解 | `ProductQueryDTO.java` |
-| **domain/vo** | 接口输出结果对象，用于返回前端展示数据，过滤敏感字段 | `@Data`<br>无业务注解 | `UserVO.java`<br>`ProductVO.java`<br>`PageVO.java` |
+| **domain/vo** | 接口输出结果对象，用于返回前端展示数据，过滤敏感字段 | `@Data`<br>无业务注解 |`ProductVO.java` |
-| **config** | 配置类，用于配置数据源、拦截器、跨域、Swagger等 | `@Configuration`<br>`@Bean`<br>`@EnableWebMvc` | `WebConfig.java`<br>`DataSourceConfig.java`<br>`SecurityConfig.java`<br>`SwaggerConfig.java` |
+| **config** | 配置类 | `@Configuration`<br>`@Bean` | `DataSourceConfig.java`|
-| **exception** | 全局异常处理，自定义业务异常类 | `@ControllerAdvice`<br>`@ExceptionHandler`<br>`@ResponseBody` | `GlobalExceptionHandler.java`<br>`BusinessException.java`<br>`ParamException.java` |
+| **utils** | 通用工具类，提供各种辅助方法 | 无注解 | `DateUtil.java` |
-| **interceptor** | 请求拦截器，用于登录验证、权限检查、日志记录、性能监控 | `@Component`<br>实现 `HandlerInterceptor` | `LoginInterceptor.java`<br>`LogInterceptor.java`<br>`AuthInterceptor.java` |
+| **constants** | 常量定义，统一管理常量值 | 无注解 | `Constants.java` |
-| **aspect** | AOP切面，用于日志记录、权限控制、性能统计、缓存处理 | `@Aspect`<br>`@Around`<br>`@Before`<br>`@After` | `LogAspect.java`<br>`PermissionAspect.java`<br>`TimeAspect.java` |
+| **enums** | 枚举类型定义，管理固定状态码、类型等 | `@Enum` |`ResultCodeEnum.java` |
-| **util** | 通用工具类，提供各种辅助方法 | 无注解 | `JwtUtil.java`<br>`DateUtil.java`<br>`PasswordUtil.java`<br>`FileUtil.java` |
-| **constant** | 常量定义，统一管理常量值 | 无注解 | `StatusCode.java`<br>`RedisKey.java`<br>`Constant.java` |
-| **enums** | 枚举类型定义，管理固定状态码、类型等 | `@Enum` | `UserRoleEnum.java`<br>`ResultCodeEnum.java`<br>`OrderStatusEnum.java` |
 | **Application** | 项目启动类，Spring Boot应用入口 | `@SpringBootApplication`<br>`@MapperScan` | `Application.java` |
 
 ## 各层调用关系图