HaHafeng
f01981bf78
核心功能： - 新增AICodeService（550行）：AI代码生成核心服务 - 新增AIController（257行）：4个API端点 - 新增dc_tool_c_ai_history表：存储对话历史 - 实现自我修正机制：最多3次智能重试 - 集成LLMFactory：复用通用能力层 - 10个Few-shot示例：覆盖Level 1-4场景 技术优化： - 修复NaN序列化问题（Python端转None） - 修复数据传递问题（从Session获取真实数据） - 优化System Prompt（明确环境信息） - 调整Few-shot示例（移除import语句） 测试结果： - 通过率：9/11（81.8%） 达到MVP标准 - 成功场景：缺失值处理、编码、分箱、BMI、筛选、填补、统计、分类 - 待优化：数值清洗、智能去重（已记录技术债务TD-C-006） API端点： - POST /api/v1/dc/tool-c/ai/generate（生成代码） - POST /api/v1/dc/tool-c/ai/execute（执行代码） - POST /api/v1/dc/tool-c/ai/process（生成并执行，一步到位） - GET /api/v1/dc/tool-c/ai/history/:sessionId（对话历史） 文档更新： - 新增Day 3开发完成总结（770行） - 新增复杂场景优化技术债务（TD-C-006） - 更新工具C当前状态文档 - 更新技术债务清单 影响范围： - backend/src/modules/dc/tool-c/*（新增2个文件，更新1个文件） - backend/scripts/create-tool-c-ai-history-table.mjs（新增） - backend/prisma/schema.prisma（新增DcToolCAiHistory模型） - extraction_service/services/dc_executor.py（NaN序列化修复） - docs/03-业务模块/DC-数据清洗整理/*（5份文档更新） Breaking Changes: 无 总代码行数：+950行 Refs: #Tool-C-Day3
340 lines
9.5 KiB
Markdown
340 lines
9.5 KiB
Markdown
# Tool B 浏览器测试计划
|
||
|
||
**日期**: 2025-12-03
|
||
**测试人员**: 开发团队
|
||
**测试范围**: Tool B（病历结构化机器人）完整流程
|
||
**测试环境**:
|
||
- 前端: http://localhost:5173
|
||
- 后端: http://localhost:3000
|
||
|
||
---
|
||
|
||
## 📋 测试清单
|
||
|
||
### 一、前置条件
|
||
- [ ] 前端服务已启动（`npm run dev` in frontend-v2）
|
||
- [ ] 后端服务已启动（`npm run dev` in backend）
|
||
- [ ] 数据库已启动（PostgreSQL）
|
||
- [ ] 浏览器已打开（推荐Chrome/Edge）
|
||
|
||
---
|
||
|
||
### 二、Step 1：文件上传与健康检查
|
||
|
||
#### 测试点1.1：页面访问
|
||
- [ ] 访问 `http://localhost:5173/data-cleaning/tool-b`
|
||
- [ ] 页面能正常加载
|
||
- [ ] 顶部显示"病历结构化机器人"
|
||
- [ ] 步骤指示器显示"1. 选列与体检"高亮
|
||
- [ ] 双模型标识显示（DeepSeek-V3 & Qwen-Max）
|
||
|
||
#### 测试点1.2：文件上传
|
||
- [ ] 看到虚线边框的上传区域
|
||
- [ ] 点击能触发文件选择对话框
|
||
- [ ] 选择Excel文件后能显示文件信息
|
||
- 文件名显示正确
|
||
- 文件大小显示
|
||
- 行数显示
|
||
- [ ] "更换文件"按钮可用
|
||
|
||
#### 测试点1.3：列选择
|
||
- [ ] 下拉框显示3个选项：
|
||
- 出院小结 (Summary_Text)
|
||
- 病理报告 (Pathology)
|
||
- 错误示范：病人ID列
|
||
- [ ] 选择列后触发健康检查
|
||
|
||
#### 测试点1.4：健康检查
|
||
- [ ] 选择"病理报告"
|
||
- 显示Loading状态（旋转图标）
|
||
- 1秒后显示绿色成功卡片
|
||
- 显示"健康度优秀，预计消耗约 450.0k Token"
|
||
- 显示统计信息（平均字符、空值率、预计Token）
|
||
- [ ] 选择"病人ID列"
|
||
- 显示红色警告卡片
|
||
- 显示"空值率过高（85.0%），该列不适合提取"
|
||
- "下一步"按钮禁用
|
||
|
||
#### 测试点1.5：导航
|
||
- [ ] 健康检查通过后，"下一步"按钮可用
|
||
- [ ] 点击"下一步"进入Step 2
|
||
|
||
**预期结果**: 所有功能正常，UI流畅，无控制台错误
|
||
|
||
---
|
||
|
||
### 三、Step 2：智能模板配置
|
||
|
||
#### 测试点2.1：页面状态
|
||
- [ ] 步骤指示器显示"2. 智能模版"高亮
|
||
- [ ] Step 1指示器显示为完成状态（绿色勾）
|
||
- [ ] 页面显示紫色背景的配置区域
|
||
|
||
#### 测试点2.2：疾病类型选择
|
||
- [ ] 下拉框默认选中"肺癌 (Lung Cancer)"
|
||
- [ ] 切换到"糖尿病 (Diabetes)"
|
||
- [ ] 切换到"高血压 (Hypertension)"
|
||
- [ ] 切换后字段列表更新
|
||
|
||
#### 测试点2.3：报告类型选择
|
||
- [ ] 下拉框默认选中"病理报告 (Pathology)"
|
||
- [ ] 切换到"入院记录 (Admission Note)"
|
||
- [ ] 切换后字段列表更新
|
||
|
||
#### 测试点2.4：字段列表
|
||
- [ ] 左侧显示字段列表
|
||
- [ ] 肺癌病理报告显示5个字段：
|
||
- 病理类型
|
||
- 分化程度
|
||
- 肿瘤大小
|
||
- 淋巴结转移
|
||
- 免疫组化
|
||
- [ ] 每个字段显示名称和描述
|
||
- [ ] 字段可以编辑（点击输入框修改）
|
||
|
||
#### 测试点2.5：字段操作
|
||
- [ ] 点击"添加字段"按钮
|
||
- 新增一行"新字段 / 描述..."
|
||
- 可以编辑新字段
|
||
- [ ] 点击删除按钮（垃圾桶图标）
|
||
- 字段被删除
|
||
- [ ] 删除所有字段
|
||
- 显示"请选择模板或添加字段"
|
||
- "开始提取"按钮禁用
|
||
|
||
#### 测试点2.6：Prompt预览
|
||
- [ ] 右侧显示深色代码编辑器
|
||
- [ ] 显示"System Prompt Preview"标题
|
||
- [ ] Prompt内容实时更新（根据字段变化）
|
||
- [ ] 代码高亮显示（紫色/蓝色/绿色）
|
||
- [ ] 显示JSON格式的字段定义
|
||
|
||
#### 测试点2.7：导航
|
||
- [ ] 点击"上一步"返回Step 1
|
||
- [ ] 点击"开始提取"进入Step 3
|
||
|
||
**预期结果**: 模板配置流畅，Prompt实时预览，无错误
|
||
|
||
---
|
||
|
||
### 四、Step 3：双盲提取进度
|
||
|
||
#### 测试点3.1：页面状态
|
||
- [ ] 步骤指示器显示"3. 双盲提取"高亮
|
||
- [ ] Step 1和2显示为完成状态
|
||
- [ ] 页面居中显示进度动画
|
||
|
||
#### 测试点3.2：动画效果
|
||
- [ ] 显示旋转的圆环（紫色边框）
|
||
- [ ] 内部显示2个圆点（蓝色和橙色）
|
||
- [ ] 圆点有弹跳动画
|
||
- [ ] 标题显示"双盲提取交叉验证中..."
|
||
|
||
#### 测试点3.3：进度条
|
||
- [ ] 进度条从0%开始
|
||
- [ ] 进度条平滑增长
|
||
- [ ] 进度条达到100%
|
||
|
||
#### 测试点3.4：日志输出
|
||
- [ ] 显示日志面板（slate背景）
|
||
- [ ] 日志按时间顺序输出：
|
||
- "初始化双模型引擎 (DeepSeek-V3 & Qwen-Max)..."
|
||
- "PII 脱敏完成..."
|
||
- "DeepSeek: 提取进度 XX%"
|
||
- "Qwen: 提取进度 XX%"
|
||
- "正在进行交叉验证 (Cross-Validation)..."
|
||
- [ ] 日志有时间戳
|
||
- [ ] 日志有光标闪烁
|
||
|
||
#### 测试点3.5：自动跳转
|
||
- [ ] 进度达到100%后等待0.8秒
|
||
- [ ] 自动跳转到Step 4
|
||
|
||
**预期结果**: 进度动画流畅，日志输出正常，自动跳转
|
||
|
||
---
|
||
|
||
### 五、Step 4：冲突验证工作台（核心功能）
|
||
|
||
#### 测试点4.1：页面状态
|
||
- [ ] 步骤指示器显示"4. 交叉验证"高亮
|
||
- [ ] 顶部显示双模型标识（DeepSeek蓝色 / Qwen橙色）
|
||
- [ ] 显示统计信息
|
||
- 总数据: 3
|
||
- X 条冲突待裁决（应该是2条）
|
||
|
||
#### 测试点4.2：工具栏
|
||
- [ ] 显示"导出当前结果"按钮
|
||
- [ ] 显示"完成并入库"按钮
|
||
- [ ] 冲突计数实时更新
|
||
- [ ] 当所有冲突解决后，显示"所有冲突已解决"（绿色）
|
||
|
||
#### 测试点4.3：数据网格
|
||
- [ ] 显示表格布局
|
||
- [ ] 表头包含：# / 原文摘要 / 病理类型 / 分化程度 / 肿瘤大小 / 淋巴结转移 / 免疫组化 / 状态
|
||
- [ ] 显示3行数据
|
||
- [ ] 行号显示正确（1, 2, 3）
|
||
|
||
#### 测试点4.4：数据行1（有冲突）
|
||
- [ ] 原文摘要显示"病理诊断：(右肺上叶)浸润性腺癌..."
|
||
- [ ] 病理类型：显示单一值"浸润性腺癌"（一致）
|
||
- [ ] 分化程度：显示2个按钮
|
||
- DS按钮："未提及"（蓝色边框）
|
||
- QW按钮："中分化"（橙色边框）
|
||
- 背景为橙色（冲突标识）
|
||
- [ ] 肿瘤大小：显示2个按钮（冲突）
|
||
- [ ] 淋巴结转移：显示2个按钮（冲突）
|
||
- [ ] 免疫组化：显示2个按钮（冲突）
|
||
- [ ] 状态：显示"待裁决"（橙色徽章，pulse动画）
|
||
|
||
#### 测试点4.5：数据行2（无冲突）
|
||
- [ ] 原文摘要显示"送检(左肺下叶)组织..."
|
||
- [ ] 所有字段显示单一值（绿色勾）
|
||
- [ ] 状态：显示"通过"（绿色徽章）
|
||
|
||
#### 测试点4.6：数据行3（有冲突）
|
||
- [ ] 原文摘要显示"右肺中叶穿刺活检..."
|
||
- [ ] 免疫组化字段有冲突
|
||
- [ ] 状态：显示"待裁决"
|
||
|
||
#### 测试点4.7：冲突采纳
|
||
- [ ] 点击行1的"分化程度" DS按钮
|
||
- 单元格变为已解决状态
|
||
- 显示"未提及"（无冲突按钮）
|
||
- 悬停显示重置按钮
|
||
- [ ] 点击行1的"肿瘤大小" QW按钮
|
||
- 单元格变为已解决状态
|
||
- 显示"3.2*2.5*2.0cm"
|
||
- [ ] 依次解决所有冲突
|
||
- 冲突计数减少
|
||
- 行状态变为"通过"
|
||
- 所有冲突解决后显示"所有冲突已解决"
|
||
|
||
#### 测试点4.8：侧边栏
|
||
- [ ] 点击任意行
|
||
- 右侧滑出侧边栏
|
||
- 侧边栏显示"病历原文详情"
|
||
- 显示Row ID
|
||
- 显示完整原文（非摘要）
|
||
- [ ] 原文显示格式正确（字体、行距）
|
||
- [ ] 底部显示"快速导航"标签
|
||
- 冲突字段显示橙色
|
||
- 已解决字段显示白色
|
||
- [ ] 点击X按钮关闭侧边栏
|
||
- 侧边栏滑出
|
||
- [ ] 点击表格其他行
|
||
- 侧边栏内容更新
|
||
|
||
#### 测试点4.9：交互体验
|
||
- [ ] 鼠标悬停行高亮（bg-slate-50）
|
||
- [ ] 选中行高亮（bg-purple-50/50）
|
||
- [ ] 冲突按钮hover效果（边框加深）
|
||
- [ ] 表格可滚动
|
||
- [ ] 侧边栏动画流畅（300ms transition）
|
||
|
||
#### 测试点4.10：导航
|
||
- [ ] 点击"完成并入库"进入Step 5
|
||
|
||
**预期结果**: 验证工作台功能完整，交互流畅，冲突裁决正常
|
||
|
||
---
|
||
|
||
### 六、Step 5：结果展示
|
||
|
||
#### 测试点5.1：页面状态
|
||
- [ ] 步骤指示器显示"5. 完成"高亮
|
||
- [ ] 所有步骤显示为完成状态
|
||
- [ ] 页面居中显示
|
||
|
||
#### 测试点5.2：成功图标
|
||
- [ ] 显示绿色圆形背景
|
||
- [ ] 内部显示绿色勾图标
|
||
- [ ] 标题显示"结构化处理完成"
|
||
|
||
#### 测试点5.3：统计信息
|
||
- [ ] 显示处理总结文案
|
||
- "双模型交叉验证已完成"
|
||
- "人工裁决修正了 X 条冲突数据"
|
||
- "最终数据集包含 3 条高质量记录"
|
||
|
||
#### 测试点5.4：统计卡片
|
||
- [ ] 左侧卡片：隐私安全
|
||
- 显示盾牌图标
|
||
- 显示"PII 已脱敏"
|
||
- [ ] 右侧卡片：Token 消耗
|
||
- 显示闪电图标
|
||
- 显示"~450k Tokens"
|
||
|
||
#### 测试点5.5：操作按钮
|
||
- [ ] "下载结果 Excel"按钮
|
||
- 白色背景，灰色边框
|
||
- Hover效果正常
|
||
- [ ] "去编辑器清洗"按钮
|
||
- 绿色背景
|
||
- 有阴影
|
||
- Hover效果正常
|
||
|
||
**预期结果**: 结果页显示正常，统计准确，按钮可用
|
||
|
||
---
|
||
|
||
## 🐛 Bug追踪
|
||
|
||
### 发现的问题
|
||
| # | 严重性 | 位置 | 描述 | 状态 |
|
||
|---|--------|------|------|------|
|
||
| 1 | | | | ⏳ |
|
||
| 2 | | | | ⏳ |
|
||
| 3 | | | | ⏳ |
|
||
|
||
---
|
||
|
||
## 📊 测试结果
|
||
|
||
### 功能完整性
|
||
- [ ] Step 1: 文件上传与健康检查 - ___%
|
||
- [ ] Step 2: 智能模板配置 - ___%
|
||
- [ ] Step 3: 双盲提取进度 - ___%
|
||
- [ ] Step 4: 冲突验证工作台 - ___%
|
||
- [ ] Step 5: 结果展示 - ___%
|
||
|
||
### 综合评分
|
||
- **功能完整性**: ___/100
|
||
- **UI美观度**: ___/100
|
||
- **交互流畅度**: ___/100
|
||
- **代码质量**: ___/100
|
||
|
||
### 最终结论
|
||
- [ ] ✅ 通过 - 可以提交Git
|
||
- [ ] ⚠️ 通过但有小问题 - 记录问题后提交
|
||
- [ ] ❌ 不通过 - 需要修复后重测
|
||
|
||
---
|
||
|
||
## 📝 测试记录
|
||
|
||
### 测试环境
|
||
- 浏览器: _______________
|
||
- 操作系统: _______________
|
||
- 前端版本: _______________
|
||
- 后端版本: _______________
|
||
- 测试日期: 2025-12-03
|
||
- 测试人员: _______________
|
||
|
||
### 测试备注
|
||
```
|
||
（请在这里记录测试过程中的任何发现、建议或问题）
|
||
|
||
|
||
|
||
|
||
```
|
||
|
||
---
|
||
|
||
**测试完成后，请更新此文档并标记所有测试点的完成状态！**
|
||
|
||
|
||
|
||
|