Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4794640f5dba7dda753023834a9f804c369a2e61
AIclinicalresearch/如何测试Phase2.md
HaHafeng 855d142fec chore: add remaining test docs, scripts and temp files 
- Add Git commit preparation checklist
- Add Phase testing guides and issue tracking
- Add utility scripts (env setup, test data initialization)
- Add temp migration SQL files (for reference)
- Update startup scripts and README
- Remove obsolete scripts
2025-11-16 15:44:55 +08:00

9.6 KiB
Raw Blame History

📖 如何测试 Phase 2 - 使用说明

Phase 2完成日期：2025-10-13
待测试内容：双模式智能问答系统（全文阅读 + 逐篇精读）

🎯 测试目标

验证以下功能：

  1. ✅ Python微服务（文档提取）
  2. ✅ 多格式文档支持（PDF/Docx/Txt）
  3. ✅ Token计数和智能管理
  4. ✅ 全文阅读模式（35-50篇文献综合分析）
  5. ✅ 逐篇精读模式（1-5篇深度分析）
  6. ✅ 文献切换和对话历史管理

📚 测试资料清单

我已经为你准备了4个测试工具：

1. 🔍 环境检查脚本（推荐第一步）

文件：检查测试环境.bat
用途：自动检查测试环境是否就绪
耗时：1分钟

使用方法：

# 双击运行
检查测试环境.bat

输出示例：

✅ 通过: 8/10
⚠️  警告: 2/10
❌ 失败: 0/10

🟢 状态: 测试环境完全就绪！

2. ⚡ 快速测试清单（推荐日常使用）

文件：Phase2-快速测试清单.md
用途：30分钟快速验证核心功能
耗时：30分钟
适合场景：

  • 代码更新后的快速验证
  • 日常开发测试
  • 问题修复后的回归测试

内容结构：

✅ 启动服务（2分钟）
✅ 准备数据（10分钟）
✅ 核心测试（15分钟）
   - 全文阅读模式（5分钟）
   - 逐篇精读模式（10分钟）
✅ 快速验收（3分钟）

3. 📋 完整测试指南（推荐正式验收）

文件：Phase2-测试指南.md
用途：90分钟完整功能验证
耗时：60-90分钟
适合场景：

  • Phase 2正式验收
  • 上线前的完整测试
  • 详细的功能测试

内容结构：

Part 1: 环境准备（10分钟）
Part 2: 服务启动（5分钟）
Part 3: 知识库准备（15-20分钟）
Part 4: 全文阅读模式（15分钟）
   - 8个详细测试用例
Part 5: 逐篇精读模式（20分钟）
   - 8个详细测试用例
Part 6: 端到端场景（15分钟）
   - 3个真实用户场景
Part 7: 问题记录（5分钟）
附录: 常见问题排查

4. 🚀 一键启动脚本（服务启动）

文件：一键启动.bat
用途：自动启动所有服务
耗时：30秒启动，10秒等待

启动内容：

  • PostgreSQL容器
  • Redis容器
  • Python微服务（端口8000）
  • Backend服务（端口3001）
  • Frontend服务（端口3000）

🏃 快速开始（5分钟上手）

Step 1: 检查环境（1分钟）

# 双击运行
检查测试环境.bat

看到"🟢 测试环境完全就绪" → 进入Step 2
看到"🔴 或 🟡" → 按照提示修复问题

Step 2: 启动服务（2分钟）

# 双击运行
一键启动.bat

等待：30秒，看到3个窗口打开
验证：自动打开浏览器 http://localhost:3000

Step 3: 选择测试方式（2分钟）

方式A：快速测试（30分钟）⭐ 推荐

# 打开文档
Phase2-快速测试清单.md

特点：快速、核心功能验证

方式B：完整测试（90分钟）

# 打开文档
Phase2-测试指南.md

特点：详细、全面、适合正式验收

📊 推荐测试流程

🎯 首次测试（推荐完整测试）

graph LR
    A[检查环境] --> B[启动服务]
    B --> C[完整测试指南]
    C --> D[记录问题]
    D --> E{有严重问题?}
    E -->|是| F[修复问题]
    E -->|否| G[验收通过]
    F --> A

预计时间：90-120分钟（含问题修复）

🔄 日常测试（推荐快速测试）

graph LR
    A[检查环境] --> B[启动服务]
    B --> C[快速测试清单]
    C --> D{测试通过?}
    D -->|是| E[继续开发]
    D -->|否| F[快速修复]
    F --> C

预计时间：30分钟

🎯 测试策略建议

阶段1：初次验证（第一次测试）

目标：全面了解系统功能和稳定性

步骤：

  1. ✅ 运行环境检查
  2. ✅ 使用完整测试指南（90分钟）
  3. ✅ 记录所有发现的问题
  4. ✅ 按优先级修复问题
  5. ✅ 重新测试验证

预期产出：

  • 完整的测试报告
  • 问题清单（按优先级）
  • 修复计划

阶段2：问题修复验证（修复后）

目标：验证问题是否修复

步骤：

  1. ✅ 运行环境检查
  2. ✅ 针对问题点重新测试
  3. ✅ 使用快速测试清单回归测试

预期产出：

  • 问题修复确认
  • 回归测试通过

阶段3：正式验收（准备上线）

目标：最终验收决策

步骤：

  1. ✅ 运行环境检查
  2. ✅ 使用完整测试指南再次测试
  3. ✅ 端到端场景测试
  4. ✅ 性能指标验证
  5. ✅ 最终验收决策

验收标准：

  • 所有核心功能正常
  • 无阻断性问题
  • 性能指标达标
  • 用户体验良好

🔧 常见场景处理

场景1：环境检查失败

现象：运行检查测试环境.bat后显示🔴

处理步骤：

  1. 查看哪些检查项标记为❌
  2. 按照提示安装缺失的软件
  3. 重新运行检查脚本
  4. 直到显示🟢才能继续测试

常见问题：

  • Docker未启动 → 启动Docker Desktop
  • Python未安装 → 安装Python 3.11+
  • 虚拟环境缺失 → cd extraction_service && .\install.bat

场景2：服务启动失败

现象：一键启动后某个服务报错

处理步骤：

  1. 查看报错的服务窗口
  2. 记录错误信息
  3. 查看测试指南"附录A：常见问题排查"
  4. 按照排查步骤解决

常见问题：

  • 端口被占用 → 关闭占用程序或重启电脑
  • 依赖未安装 → 运行npm install或pip install
  • 数据库连接失败 → 检查Docker容器状态

场景3：功能测试失败

现象：某个功能不工作或报错

处理步骤：

  1. 在测试文档中记录具体问题
  2. 截图保存关键错误
  3. 记录复现步骤
  4. 查看浏览器Console（F12）的错误信息
  5. 提交问题清单

问题记录模板：

问题描述：____________
复现步骤：
  1. ____________
  2. ____________
预期结果：____________
实际结果：____________
截图：[附件]
Console错误：____________

📝 测试记录管理

建议的文档结构

创建一个测试记录文件夹：

AIclinicalresearch/
├── 测试记录/
│   ├── 2025-10-13-首次测试.md
│   ├── 2025-10-14-问题修复验证.md
│   ├── 2025-10-15-正式验收.md
│   └── 问题清单.md

问题清单模板

# Phase 2 问题清单

## 🔴 严重问题（阻断性）
1. [问题描述] - [状态：待修复/已修复] - [负责人]

## 🟡 中等问题（影响使用）
1. [问题描述] - [状态：待修复/已修复] - [负责人]

## 🟢 轻微问题（不影响主流程）
1. [问题描述] - [状态：待修复/已修复] - [负责人]

🎊 测试完成后

✅ 如果验收通过

恭喜！Phase 2验收通过！ 🎉

下一步选择：

选项A：开发Phase 3（批处理模式）⭐ 推荐

  • 时间：1-2天
  • 价值：完善知识库功能闭环
  • 任务：批量文献处理、结果汇总、导出功能

选项B：开发里程碑2（11个智能体）

  • 时间：2-3周
  • 价值：产品功能完整度大幅提升
  • 任务：开发其余11个专业智能体

建议：先完成Phase 3（1-2天），再进入里程碑2

⚠️ 如果有问题需要修复

**不要慌！**按照以下步骤处理：

  1. 问题分类

    • 将问题分为：严重、中等、轻微

  2. 优先级排序

    • 严重问题：立即修复
    • 中等问题：尽快修复
    • 轻微问题：可延后

  3. 修复计划

    • 为每个问题分配修复时间
    • 预估总修复时间

  4. 修复后验证

    • 使用快速测试清单回归测试
    • 确认问题已解决

📞 需要帮助？

测试过程中遇到问题

  1. 查看测试指南的"附录A：常见问题排查"
  2. 查看Console错误信息（F12）
  3. 记录详细的问题描述和截图
  4. 整理问题清单待Review

不确定如何判断测试结果

参考标准：

  • ✅ 通过：功能正常工作，无错误
  • ⚠️ 有条件通过：功能基本工作，有小问题但不影响主流程
  • ❌ 不通过：功能无法工作或有严重错误

📚 相关文档索引

Phase 2开发文档

测试文档

开发计划文档

🎯 总结

测试工具选择

场景 推荐工具 耗时
首次测试 完整测试指南 90分钟
日常开发测试 快速测试清单 30分钟
问题修复后 快速测试清单 30分钟
正式验收 完整测试指南 90分钟
环境检查 环境检查脚本 1分钟

测试流程建议

第1次: 环境检查 → 完整测试 → 记录问题
第2次: 环境检查 → 快速测试 → 验证修复
第3次: 环境检查 → 完整测试 → 最终验收

准备好了吗？立即开始测试！ 🚀

  1. 运行 检查测试环境.bat
  2. 运行 一键启动.bat
  3. 打开 Phase2-快速测试清单.md 或 Phase2-测试指南.md
  4. 开始测试！

祝测试顺利！ 🎉

Reference in New Issue View Git Blame Copy Permalink