feat(phase1): 完成文档查询和删除接口

Task 5.4: 文档查询接口
- DocumentManagementService 新增查询方法:
  - queryDocumentById: 根据 docId 查询单个文档
  - queryDocumentsByStatus: 根据状态查询(分页)
  - queryDocumentsByFaultSource: 根据故障源查询
  - convertToResponse: 实体转 DTO 工具方法
- DocumentController 新增 RESTful 接口:
  - GET /api/documents/{docId}
  - GET /api/documents/status/{status}?page=0&size=20
  - GET /api/documents/faultSource/{faultSource}

Task 5.5: 文档删除接口
- DocumentManagementService 新增删除方法:
  - deleteDocument: 删除文档元数据
  - TODO: 向量索引删除待实现
- DocumentController 新增删除接口:
  - DELETE /api/documents/{docId}

功能特性:
- 统一异常处理:DocumentProcessException
- 统一响应格式:Result<T>
- 分页支持:Page/PageRequest
- 事务支持:@Transactional

编译验证:BUILD SUCCESS

Progress: 28/33 tasks completed (85%)
This commit is contained in:
zhuyongxin
2026-06-23 15:48:04 +08:00
parent f446290d0f
commit e76d4ce48f
3 changed files with 146 additions and 2 deletions
@@ -40,8 +40,8 @@
- [x] 5.1 创建 TextExtractor 服务 (仅支持 .md 和 .txt,其他格式通过外部转换服务)
- [x] 5.2 文档分块服务 (DocumentChunkService 已存在,已适配新 DTO)
- [x] 5.3 文档上传接口 (DocumentController#upload, DocumentManagementService#uploadDocument)
- [ ] 5.4 文档查询接口 (DocumentController#query, DocumentService#queryDocuments)
- [ ] 5.5 文档删除接口 (DocumentController#delete, DocumentService#deleteDocument)
- [x] 5.4 文档查询接口 (DocumentController#query, DocumentService#queryDocuments)
- [x] 5.5 文档删除接口 (DocumentController#delete, DocumentService#deleteDocument)
- [ ] 5.6 混合检索工具 (DocumentSearchTool: 精确匹配 + 语义检索 + RRF 融合)
- [ ] 5.7 文档管理集成测试 (DocumentIntegrationTest)