HaHafeng
855d142fec
- 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
9.6 KiB
9.6 KiB
📖 如何测试 Phase 2 - 使用说明
Phase 2完成日期：2025-10-13
待测试内容：双模式智能问答系统（全文阅读 + 逐篇精读）
🎯 测试目标
验证以下功能：
- ✅ Python微服务（文档提取）
- ✅ 多格式文档支持（PDF/Docx/Txt）
- ✅ Token计数和智能管理
- ✅ 全文阅读模式（35-50篇文献综合分析）
- ✅ 逐篇精读模式（1-5篇深度分析）
- ✅ 文献切换和对话历史管理
📚 测试资料清单
我已经为你准备了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：初次验证（第一次测试）
目标：全面了解系统功能和稳定性
步骤：
- ✅ 运行环境检查
- ✅ 使用完整测试指南（90分钟）
- ✅ 记录所有发现的问题
- ✅ 按优先级修复问题
- ✅ 重新测试验证
预期产出：
- 完整的测试报告
- 问题清单（按优先级）
- 修复计划
阶段2：问题修复验证（修复后）
目标：验证问题是否修复
步骤：
- ✅ 运行环境检查
- ✅ 针对问题点重新测试
- ✅ 使用快速测试清单回归测试
预期产出：
- 问题修复确认
- 回归测试通过
阶段3：正式验收（准备上线）
目标：最终验收决策
步骤：
- ✅ 运行环境检查
- ✅ 使用完整测试指南再次测试
- ✅ 端到端场景测试
- ✅ 性能指标验证
- ✅ 最终验收决策
验收标准：
- 所有核心功能正常
- 无阻断性问题
- 性能指标达标
- 用户体验良好
🔧 常见场景处理
场景1：环境检查失败
现象：运行检查测试环境.bat后显示🔴
处理步骤：
- 查看哪些检查项标记为❌
- 按照提示安装缺失的软件
- 重新运行检查脚本
- 直到显示🟢才能继续测试
常见问题：
- Docker未启动 → 启动Docker Desktop
- Python未安装 → 安装Python 3.11+
- 虚拟环境缺失 →
cd extraction_service && .\install.bat
场景2：服务启动失败
现象：一键启动后某个服务报错
处理步骤：
- 查看报错的服务窗口
- 记录错误信息
- 查看测试指南"附录A：常见问题排查"
- 按照排查步骤解决
常见问题：
- 端口被占用 → 关闭占用程序或重启电脑
- 依赖未安装 → 运行
npm install或pip install - 数据库连接失败 → 检查Docker容器状态
场景3：功能测试失败
现象：某个功能不工作或报错
处理步骤：
- 在测试文档中记录具体问题
- 截图保存关键错误
- 记录复现步骤
- 查看浏览器Console（F12）的错误信息
- 提交问题清单
问题记录模板：
问题描述：____________
复现步骤：
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
⚠️ 如果有问题需要修复
**不要慌！**按照以下步骤处理：
-
问题分类
- 将问题分为：严重、中等、轻微
-
优先级排序
- 严重问题：立即修复
- 中等问题：尽快修复
- 轻微问题：可延后
-
修复计划
- 为每个问题分配修复时间
- 预估总修复时间
-
修复后验证
- 使用快速测试清单回归测试
- 确认问题已解决
📞 需要帮助？
测试过程中遇到问题
- 查看测试指南的"附录A：常见问题排查"
- 查看Console错误信息（F12）
- 记录详细的问题描述和截图
- 整理问题清单待Review
不确定如何判断测试结果
参考标准：
- ✅ 通过：功能正常工作，无错误
- ⚠️ 有条件通过：功能基本工作，有小问题但不影响主流程
- ❌ 不通过：功能无法工作或有严重错误
📚 相关文档索引
Phase 2开发文档
测试文档
- Phase2-测试指南.md - 完整版
- Phase2-快速测试清单.md - 快速版
开发计划文档
🎯 总结
测试工具选择
| 场景 | 推荐工具 | 耗时 |
|---|---|---|
| 首次测试 | 完整测试指南 | 90分钟 |
| 日常开发测试 | 快速测试清单 | 30分钟 |
| 问题修复后 | 快速测试清单 | 30分钟 |
| 正式验收 | 完整测试指南 | 90分钟 |
| 环境检查 | 环境检查脚本 | 1分钟 |
测试流程建议
第1次: 环境检查 → 完整测试 → 记录问题
第2次: 环境检查 → 快速测试 → 验证修复
第3次: 环境检查 → 完整测试 → 最终验收
准备好了吗？立即开始测试！ 🚀
- 运行
检查测试环境.bat - 运行
一键启动.bat - 打开
Phase2-快速测试清单.md或Phase2-测试指南.md - 开始测试！
祝测试顺利！ 🎉