feat(phase1): 完成分层结构优化和 DTO 创建

Task 4.2: 分层结构优化
- 创建 exception 包
  - SessionNotFoundException: 会话未找到异常
  - DocumentProcessException: 文档处理异常
- 已有分层结构验证
  - controller: 控制器层 ✅
  - service: 业务逻辑层 ✅
  - repository: 数据访问层 ✅
  - domain: 领域模型层 (entity/model/enums) ✅
  - config: 配置层 ✅
  - tool: 工具类 ✅

Task 4.3: 创建 DTO 类
- DiagnosisRequest: 诊断请求 DTO (10 个字段)
- DiagnosisResponse: 诊断响应 DTO (12 个字段 + 内部类)
- DocumentUploadRequest: 文档上传请求 DTO (7 个字段)
- DocumentQueryResponse: 文档查询响应 DTO (11 个字段 + 内部类)
- Result<T>: 统一响应结果 DTO (泛型包装)

功能特性:
- 异常类支持自定义错误信息和原因链
- DTO 使用 Lombok 简化代码
- Result 提供静态工厂方法(success/error)
- DocumentUploadRequest 支持 MultipartFile
- Response DTO 支持嵌套数据结构

编译验证:BUILD SUCCESS

Progress: 23/33 tasks completed (70%)
This commit is contained in:
zhuyongxin
2026-06-23 15:02:38 +08:00
parent c3a232540a
commit 360e4febae
8 changed files with 425 additions and 2 deletions
@@ -0,0 +1,52 @@
package com.superbiz.agent.dto;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.springframework.web.multipart.MultipartFile;
/**
* 文档上传请求 DTO
*/
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class DocumentUploadRequest {
/**
* 上传的文件
*/
private MultipartFile file;
/**
* 故障类别(默认 EXTERNAL_API)
*/
private String faultCategory;
/**
* 故障源(省份/服务名)
*/
private String faultSource;
/**
* 接口名称
*/
private String apiName;
/**
* 文档版本
*/
private String version;
/**
* 分块大小(默认 500)
*/
private Integer chunkSize;
/**
* 重叠大小(默认 50)
*/
private Integer chunkOverlap;
}