zhuyongxin
|
5869fc775f
|
test: 修复测试并验证 Milvus 连接
- 修复 DocumentChunkServiceTest:getStartIndex/getEndIndex → getStartOffset/getEndOffset
- 新增 SimpleMilvusTest:验证 Milvus 集群连接状态
- Milvus 状态:✓ 正常运行(Status Code: 0)
测试结果:
- SimpleMilvusTest: 1/1 通过
- Milvus 集群可用,可以继续实施 Task 5.3-5.7
Host: in03-4a578da0f27ce9d.serverless.aws-eu-central-1.cloud.zilliz.com
Port: 443 (Zilliz Cloud Serverless)
|
2026-06-23 15:23:46 +08:00 |
|
zhuyongxin
|
ea77518880
|
feat(phase1): 完成文本提取和文档分块服务
Task 5.1: TextExtractor 服务
- 创建 TextExtractorService(仅支持 .md 和 .txt)
- 其他格式(.docx、.pdf)需通过外部转换服务先转为 Markdown
- 支持 UTF-8 编码的纯文本提取
- 提供文件格式验证方法
Task 5.2: 文档分块服务适配
- 修改 DocumentChunk DTO:添加 @Builder 支持
- 字段重命名:startIndex/endIndex → startOffset/endOffset
- 修复 DocumentChunkService 中的三处构造调用
- 使用 builder 模式替代构造函数
技术决策:
- 简化文本提取,只支持 Markdown 和纯文本
- 复杂格式转换由外部服务处理(分离关注点)
- 统一使用 Lombok @Builder 简化对象构建
编译验证:BUILD SUCCESS
Progress: 25/33 tasks completed (76%)
|
2026-06-23 15:15:10 +08:00 |
|
zhuyongxin
|
360e4febae
|
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%)
|
2026-06-23 15:02:38 +08:00 |
|
zhuyongxin
|
c3a232540a
|
refactor(phase1): 完成包名重构 (org.example → com.superbiz.agent)
Task 4.1: 包名统一重构
- 重命名 41 个 Java 文件的包名
- 更新所有 import 语句
- 恢复枚举类(FaultCategory、DiagnosisStatus、SourceType)
- 更新测试类的 import
重构范围:
- domain/entity: 3 个实体类
- domain/model: 2 个数据类
- domain/enums: 3 个枚举类
- repository: 3 个接口
- service/session: 2 个类(接口 + 实现)
- config: 9 个配置类
- controller: 2 个控制器
- agent/tool: 4 个工具类
- client: 1 个客户端
- Main.java: 主类
验证结果:
- 编译成功,无错误
- 所有测试通过 (27/27)
- ApiDocumentRepositoryTest: 7/7 ✅
- CaseLibraryRepositoryTest: 6/6 ✅
- DiagnosisRecordRepositoryTest: 6/6 ✅
- RedisSessionManagerTest: 8/8 ✅
Progress: 21/33 tasks completed (64%)
|
2026-06-23 14:56:04 +08:00 |
|
zhuyongxin
|
8bd758dbaf
|
docs(devflow): 补充 Phase 1 项目记忆文档
创建 Phase 1 基础设施搭建的完整 devflow 文档:
- brief.md: 项目背景、目标、范围、技术选型、关键决策
- decisions.md: 6 个架构决策记录 (ADR)
- ADR-001: Flyway 数据库版本管理
- ADR-002: 枚举类型存储为 VARCHAR
- ADR-003: Redis JSON 序列化
- ADR-004: Spring Data JPA 命名约定
- ADR-005: 会话 TTL 可配置
- ADR-006: 包名暂时混用
- evidence.md: 测试证据、性能指标、编译验证、数据库结构
- 27 个测试全部通过
- 性能指标达标
- 提交记录追踪
- acceptance.md: 验收标准、测试结果、遗留问题
- 20/33 任务完成
- 部分验收通过
更新全局文档:
- devflow/index.md: 新增 phase1-infrastructure 项目索引
- devflow/glossary/CONTEXT.md: 新增 8 个术语和 4 条业务规则
Progress: 20/33 tasks completed (61%)
|
2026-06-23 14:44:43 +08:00 |
|
zhuyongxin
|
48132d297d
|
feat(phase1): 完成 Repository 测试和 Redis 会话管理
Task 2: 完成 Repository 层测试
- 实现 CaseLibraryRepositoryTest (6 个测试)
- 实现 ApiDocumentRepositoryTest (7 个测试)
- 所有 Repository 测试通过 (19/19)
Task 3: 完成 Redis 会话管理
- 创建 SessionContext 和 ToolCall 数据类
- 创建 SessionManager 接口
- 实现 RedisSessionManager (基于 Redis 的会话管理)
- 创建 SessionConfiguration (Redis 序列化配置)
- 实现 RedisSessionManagerTest (8 个测试全部通过)
测试结果:
- ApiDocumentRepositoryTest: 7/7 通过
- CaseLibraryRepositoryTest: 6/6 通过
- DiagnosisRecordRepositoryTest: 6/6 通过
- RedisSessionManagerTest: 8/8 通过
- 总计: 27/27 测试通过
功能特性:
- 会话创建、查询、更新、删除
- 会话过期时间管理
- 工具调用记录追踪
- 会话状态管理
- 基于 Redis 的分布式会话存储
Progress: 20/33 tasks completed (61%)
|
2026-06-23 14:38:17 +08:00 |
|
zhuyongxin
|
1de1e98ef8
|
feat(phase1): 完成 JPA 实体类和 Repository 层实现
- 创建 3 个 JPA 实体类:DiagnosisRecord、CaseLibrary、ApiDocument
- 创建 3 个 Repository 接口,实现基础 CRUD 和自定义查询方法
- 实现 DiagnosisRecordRepository 单元测试(6 个测试全部通过)
- 修复 Hibernate schema 验证问题(枚举类型使用 VARCHAR)
- 更新 application.yml,添加完整的数据库和 Redis 配置
- 更新 OpenSpec tasks.md,标记已完成任务(12/33)
测试结果:
- DiagnosisRecordRepositoryTest: 6/6 通过
- 编译成功,无错误
Progress: 12/33 tasks completed
|
2026-06-23 14:30:35 +08:00 |
|
zhuyongxin
|
60be51f4a5
|
docs: 重构文档结构,分离学习笔记和 MVP 架构设计
**变更概述:**
- 将 MVP 架构设计文档独立到项目根目录 `mvp/`
- 整理 `docs/` 为纯学习和分析文档目录
- 按类型分类:learning(学习)、analysis(分析)、reports(报告)、guides(指南)
**目录结构:**
```
mvp/ # MVP 架构设计(独立)
├── README.md # 数据库设计总览
├── architecture/ # 架构文档
│ ├── agent-architecture-mvp.md
│ ├── implementation-plan.md
│ └── ...
└── tables/ # 数据表设计
docs/ # 学习和分析文档
├── learning/ # 学习笔记(00-08 编号)
├── analysis/ # 分析笔记 + 重构计划
├── reports/ # 临时报告
└── guides/ # 指南文档
```
**详细变更:**
- docs/README.md → mvp/README.md(数据库设计入口)
- docs/architecture/ → mvp/architecture/(架构设计)
- docs/tables/ → mvp/tables/(数据表设计)
- docs/学习笔记-*.md → docs/learning/07-*.md, 08-*.md
- docs/项目学习路径.md → docs/learning/00-*.md
- docs/功能分析报告.md → docs/analysis/
- docs/修复报告-*.md → docs/reports/
- docs/日志配置*.md → docs/guides/ 或 docs/reports/
- docs/design/ → docs/analysis/(问题分析和重构计划)
|
2026-06-23 14:14:51 +08:00 |
|
zhuyongxin
|
caef477cec
|
Merge branch 'emdash/lemon-shrimps-bake-7q6xl' into refactor/rag-chunking-strategy
# Conflicts:
# AGENTS.md
# CLAUDE.md
# src/main/resources/application.yml
|
2026-06-23 11:06:34 +08:00 |
|
zhuyongxin
|
a3d806ed68
|
chore: 添加 .claude/settings.local.json 到 .gitignore
|
2026-06-23 11:00:37 +08:00 |
|
zhuyongxin
|
3f15778b28
|
docs: 添加 Phase 1 完整实施计划和 OpenSpec
- 添加项目级 CLAUDE.md 和 AGENTS.md 配置
- 添加完整实施计划(docs/architecture/implementation-detail.md)
- 创建 OpenSpec phase-1-infrastructure:
- proposal.md: 需求和方案
- design.md: 架构设计
- specs/functional-specs.md: 功能规格
- tasks.md: 21 个任务清单
- decisions.md: grill 阶段决策记录
- .commit: 标记为 Committed OpenSpec
OpenSpec 已通过 sm-flow 完整流程(clarify → context → propose → grill → specify → audit → commit)
|
2026-06-23 10:58:11 +08:00 |
|
zhuyongxin
|
5ddb7a6d93
|
feat(phase1): 完成基础设施搭建初步工作
- 添加 JPA/Flyway/Redis 依赖到 pom.xml
- 创建 3 个 Flyway 迁移脚本(diagnosis_record/case_library/api_document)
- 创建枚举类(FaultCategory/DiagnosisStatus/SourceType)
- 配置 MySQL + Redis 连接(application.yml)
状态:数据库表脚本就绪,等待数据库创建后验证
|
2026-06-23 10:53:24 +08:00 |
|
zhuyongxin
|
429413fe64
|
docs: 完成 MVP 架构设计文档
- 数据库设计:3张核心表 (diagnosis_record/case_library/api_document)
- Agent架构:4 Agent协作 (Supervisor/Planner/Executor/Verifier)
- 意图识别:L0正则+L1小模型Agent分层
- RAG两层加载:L1预加载通用知识 + L2按需加载具体文档
- Skill体系:/diagnose-by-orderid 标准化诊断流程
- Harness控制:5 Gates + 中断机制
- 会话管理:Redis临时存储 + 扩展方案
- 闭环机制:用户反馈 → BadCase → 优化
- 实施规划:3阶段13天
|
2026-06-22 18:47:00 +08:00 |
|
aruo
|
ac08345369
|
commit
|
2026-05-31 21:45:14 +08:00 |
|
zhuyongxin
|
d4b5015beb
|
commit
|
2026-05-29 21:38:16 +08:00 |
|
zhuyongxin
|
80eada415d
|
commit
|
2026-04-30 11:19:46 +08:00 |
|
zhuyongxin
|
0671ad8bab
|
first commit
|
2026-04-30 11:16:12 +08:00 |
|