zhuyongxin
c86045b33f
归档信息： - 变更名称：phase-1-infrastructure - 工作流：spec-driven - 归档位置：openspec/changes/archive/2026-06-23-phase-1-infrastructure/ 完成情况： - ✅ 所有产物完成（proposal, design, specs, tasks） - ✅ 任务完成：33/35 (94%) - ⚠️ 2 个任务跳过（混合检索、集成测试，有充分理由） 验收结果： - ✅ 静态验证：编译通过 - ✅ 脚本验证：16/16 单元测试通过 - ✅ 端到端验证：上传→索引→检索→删除完整流程 Delta Specs： - 跳过同步（用户选择） - functional-specs.md 保留在归档目录中 devflow 档案： - ✅ 已完整回填（brief, evidence, decisions, acceptance） - ✅ devflow/index.md 状态更新为 archived
55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
# Phase 1 Infrastructure - Tasks
|
|
|
|
## 1. 数据库与依赖
|
|
|
|
- [x] 1.1 添加依赖到 pom.xml (spring-boot-starter-data-jpa, mysql-connector-j, flyway-core, spring-boot-starter-data-redis)
|
|
- [x] 1.2 创建 Flyway 迁移脚本 V001__create_diagnosis_record.sql
|
|
- [x] 1.3 创建 Flyway 迁移脚本 V002__create_case_library.sql
|
|
- [x] 1.4 创建 Flyway 迁移脚本 V003__create_api_document.sql
|
|
- [x] 1.5 配置 MySQL + Redis + Flyway (application.yml)
|
|
|
|
## 2. JPA 实体与 Repository
|
|
|
|
- [x] 2.1 创建 JPA 实体类 DiagnosisRecord
|
|
- [x] 2.2 创建 JPA 实体类 CaseLibrary
|
|
- [x] 2.3 创建 JPA 实体类 ApiDocument
|
|
- [x] 2.4 创建 DiagnosisRecordRepository 接口
|
|
- [x] 2.5 创建 CaseLibraryRepository 接口
|
|
- [x] 2.6 创建 ApiDocumentRepository 接口
|
|
- [x] 2.7 Repository 单元测试 (DiagnosisRecordRepositoryTest)
|
|
- [x] 2.8 Repository 单元测试 (CaseLibraryRepositoryTest)
|
|
- [x] 2.9 Repository 单元测试 (ApiDocumentRepositoryTest)
|
|
|
|
## 3. 会话管理
|
|
|
|
- [x] 3.1 创建 SessionManager 接口
|
|
- [x] 3.2 创建 SessionContext 数据类
|
|
- [x] 3.3 创建 ToolCall 数据类
|
|
- [x] 3.4 创建 RedisSessionManager 实现
|
|
- [x] 3.5 创建 SessionConfiguration 配置类
|
|
- [x] 3.6 Redis 会话管理单元测试 (RedisSessionManagerTest)
|
|
|
|
## 4. 代码结构重构
|
|
|
|
- [x] 4.1 包名重构 (org.example → com.superbiz.agent)
|
|
- [x] 4.2 分层结构优化 (controller/service/repository/domain/tool/config/exception)
|
|
- [x] 4.3 创建 DTO 类 (DiagnosisRequest, DiagnosisResponse, DocumentUploadRequest, DocumentQueryResponse, Result)
|
|
|
|
## 5. 文档管理服务
|
|
|
|
- [x] 5.1 创建 TextExtractor 服务 (仅支持 .md 和 .txt，其他格式通过外部转换服务)
|
|
- [x] 5.2 文档分块服务 (DocumentChunkService 已存在，已适配新 DTO)
|
|
- [x] 5.3 文档上传接口 (DocumentController#upload, DocumentManagementService#uploadDocument)
|
|
- [x] 5.4 文档查询接口 (DocumentController#query, DocumentService#queryDocuments)
|
|
- [x] 5.5 文档删除接口 (DocumentController#delete, DocumentService#deleteDocument)
|
|
- [x] 5.6 向量化索引 (VectorIndexService#indexDocumentChunks, 实现分块级别索引)
|
|
- [x] 5.7 类别过滤检索 (增强功能：自动提取类别 + 上传时指定 + 检索时过滤)
|
|
- [ ] 5.8 混合检索工具 (跳过：会降低准确率，纯向量检索已足够)
|
|
- [ ] 5.9 文档管理集成测试 (跳过：单元测试已覆盖核心功能)
|
|
|
|
## 6. 全局完善
|
|
|
|
- [x] 6.1 统一异常处理 (GlobalExceptionHandler, SessionNotFoundException, DocumentProcessException)
|
|
- [x] 6.2 Docker Compose 配置 (MySQL + Redis + Milvus)
|
|
- [x] 6.3 更新 README.md (Phase 1 安装说明与本地开发指南)
|