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
400 lines
8.3 KiB
Markdown
400 lines
8.3 KiB
Markdown
# 📦 Phase 2 测试工具包 - 快速索引
|
||
|
||
**创建日期**：2025-10-13
|
||
**Phase 2完成**：双模式智能问答系统（全文阅读 + 逐篇精读）
|
||
|
||
---
|
||
|
||
## 🎯 测试目标
|
||
|
||
验证以下核心功能：
|
||
- ✅ Python文档提取微服务（PDF/Docx/Txt）
|
||
- ✅ Token精确计数和智能管理
|
||
- ✅ 全文阅读模式（35-50篇综合分析）
|
||
- ✅ 逐篇精读模式（1-5篇深度分析）
|
||
- ✅ 文献切换和对话历史独立性
|
||
|
||
---
|
||
|
||
## 📚 测试工具（共5个）
|
||
|
||
### 1️⃣ 【入门必读】如何测试Phase2.md ⭐
|
||
**用途**：测试工具使用指南
|
||
**内容**：
|
||
- 测试策略建议
|
||
- 工具选择指南
|
||
- 常见场景处理
|
||
- 问题记录管理
|
||
|
||
**适合**：第一次测试前阅读
|
||
|
||
---
|
||
|
||
### 2️⃣ 【环境检查】检查测试环境.bat
|
||
**用途**：自动检查测试环境是否就绪
|
||
**耗时**：1分钟
|
||
|
||
**使用**：
|
||
```bash
|
||
# 双击运行
|
||
检查测试环境.bat
|
||
```
|
||
|
||
**输出**：
|
||
- 🟢 测试环境完全就绪
|
||
- 🟡 基本就绪，有小问题
|
||
- 🔴 有严重问题需要修复
|
||
|
||
---
|
||
|
||
### 3️⃣ 【快速测试】Phase2-快速测试清单.md ⭐⭐⭐
|
||
**用途**：30分钟快速验证核心功能
|
||
**耗时**：30分钟
|
||
|
||
**适合场景**：
|
||
- ✅ 日常开发测试
|
||
- ✅ 代码更新后验证
|
||
- ✅ 问题修复后回归测试
|
||
|
||
**测试内容**：
|
||
- Step 1: 启动服务（2分钟）
|
||
- Step 2: 准备数据（10分钟）
|
||
- Step 3: 核心功能测试（15分钟）
|
||
- 全文阅读模式（5分钟）
|
||
- 逐篇精读模式（10分钟）
|
||
- Step 4: 快速验收（3分钟）
|
||
|
||
---
|
||
|
||
### 4️⃣ 【完整测试】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分钟）
|
||
- 附录: 常见问题排查
|
||
|
||
---
|
||
|
||
### 5️⃣ 【服务启动】一键启动.bat
|
||
**用途**：自动启动所有服务
|
||
**耗时**：30秒启动 + 10秒等待
|
||
|
||
**启动内容**：
|
||
- PostgreSQL容器
|
||
- Redis容器
|
||
- Python微服务（8000端口）
|
||
- Backend服务（3001端口）
|
||
- Frontend服务（3000端口）
|
||
|
||
**使用**：
|
||
```bash
|
||
# 双击运行
|
||
一键启动.bat
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 快速开始（3步）
|
||
|
||
### 新手路线 🔰
|
||
|
||
```
|
||
第1步: 阅读入门必读
|
||
↓
|
||
第2步: 运行环境检查
|
||
↓
|
||
第3步: 打开快速测试清单
|
||
↓
|
||
开始测试！
|
||
```
|
||
|
||
**推荐文件顺序**：
|
||
1. `如何测试Phase2.md` - 先看使用说明
|
||
2. `检查测试环境.bat` - 检查环境
|
||
3. `Phase2-快速测试清单.md` - 开始快速测试
|
||
|
||
---
|
||
|
||
### 老手路线 ⚡
|
||
|
||
```
|
||
第1步: 运行环境检查
|
||
↓
|
||
第2步: 启动服务
|
||
↓
|
||
第3步: 直接开始测试
|
||
```
|
||
|
||
**文件顺序**：
|
||
1. `检查测试环境.bat`
|
||
2. `一键启动.bat`
|
||
3. `Phase2-快速测试清单.md` 或 `Phase2-测试指南.md`
|
||
|
||
---
|
||
|
||
## 📊 测试方案选择
|
||
|
||
### 情况1：第一次测试（首次验收）
|
||
|
||
**推荐**：完整测试指南（90分钟）
|
||
|
||
**原因**：
|
||
- 全面了解系统功能
|
||
- 发现所有潜在问题
|
||
- 为后续测试建立基准
|
||
|
||
**流程**：
|
||
```
|
||
环境检查 → 完整测试 → 记录问题 → 修复 → 快速测试验证
|
||
```
|
||
|
||
---
|
||
|
||
### 情况2：日常开发测试
|
||
|
||
**推荐**：快速测试清单（30分钟）
|
||
|
||
**原因**：
|
||
- 快速验证核心功能
|
||
- 节省时间
|
||
- 适合频繁测试
|
||
|
||
**流程**：
|
||
```
|
||
环境检查 → 快速测试 → 发现问题即停止修复
|
||
```
|
||
|
||
---
|
||
|
||
### 情况3：问题修复后验证
|
||
|
||
**推荐**：快速测试清单（30分钟）
|
||
|
||
**原因**：
|
||
- 针对性验证修复效果
|
||
- 回归测试核心功能
|
||
- 快速确认问题解决
|
||
|
||
**流程**：
|
||
```
|
||
环境检查 → 针对问题点测试 → 快速回归测试
|
||
```
|
||
|
||
---
|
||
|
||
### 情况4：正式验收/上线前
|
||
|
||
**推荐**：完整测试指南（90分钟）
|
||
|
||
**原因**：
|
||
- 最终质量保证
|
||
- 全面功能验证
|
||
- 性能指标确认
|
||
|
||
**流程**：
|
||
```
|
||
环境检查 → 完整测试 → 端到端场景 → 性能验证 → 最终决策
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 测试检查清单
|
||
|
||
### 测试前准备
|
||
- [ ] 阅读测试使用说明
|
||
- [ ] 运行环境检查脚本
|
||
- [ ] 确保环境显示🟢就绪
|
||
- [ ] 准备测试文档（7-10个）
|
||
- [ ] 预留足够测试时间
|
||
|
||
### 测试执行
|
||
- [ ] 启动所有服务
|
||
- [ ] 验证服务健康状态
|
||
- [ ] 准备知识库和文档
|
||
- [ ] 执行测试用例
|
||
- [ ] 记录测试结果
|
||
|
||
### 测试后处理
|
||
- [ ] 汇总测试结果
|
||
- [ ] 整理问题清单
|
||
- [ ] 按优先级排序问题
|
||
- [ ] 制定修复计划
|
||
- [ ] 做出验收决策
|
||
|
||
---
|
||
|
||
## 📝 测试结果记录
|
||
|
||
### 建议创建测试记录文件夹
|
||
|
||
```
|
||
AIclinicalresearch/
|
||
├── 测试记录/
|
||
│ ├── 2025-10-13-首次测试.md
|
||
│ ├── 2025-10-14-问题修复验证.md
|
||
│ ├── 2025-10-15-正式验收.md
|
||
│ └── 问题清单.md
|
||
```
|
||
|
||
### 测试记录模板
|
||
|
||
```markdown
|
||
# Phase 2 测试记录 - [日期]
|
||
|
||
## 测试信息
|
||
- 测试人员：______
|
||
- 测试时间：______
|
||
- 测试类型：快速测试 / 完整测试
|
||
- 测试耗时：______分钟
|
||
|
||
## 测试结果
|
||
- 全文阅读模式：✅ / ⚠️ / ❌
|
||
- 逐篇精读模式：✅ / ⚠️ / ❌
|
||
- 文献切换：✅ / ⚠️ / ❌
|
||
- 对话历史：✅ / ⚠️ / ❌
|
||
|
||
## 发现的问题
|
||
### 严重问题（🔴）
|
||
1. [描述]
|
||
|
||
### 中等问题（🟡）
|
||
1. [描述]
|
||
|
||
### 轻微问题（🟢）
|
||
1. [描述]
|
||
|
||
## 最终结论
|
||
✅ 通过 / ⚠️ 有条件通过 / ❌ 需返工
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 常见问题快速索引
|
||
|
||
### Q1: 环境检查失败怎么办？
|
||
**A**: 查看 `如何测试Phase2.md` → "场景1：环境检查失败"
|
||
|
||
### Q2: 服务启动后报错？
|
||
**A**: 查看 `Phase2-测试指南.md` → "附录A：常见问题排查"
|
||
|
||
### Q3: 文档一直"处理中"？
|
||
**A**: 查看 `Phase2-测试指南.md` → "附录A.2"
|
||
|
||
### Q4: 容量显示不准确？
|
||
**A**: 查看 `Phase2-测试指南.md` → "附录A.3"
|
||
|
||
### Q5: 文献选择器空白？
|
||
**A**: 查看 `Phase2-测试指南.md` → "附录A.4"
|
||
|
||
### Q6: 文献切换历史丢失？
|
||
**A**: 查看 `Phase2-测试指南.md` → "附录A.5"
|
||
|
||
---
|
||
|
||
## 📞 需要帮助？
|
||
|
||
### 测试过程中遇到问题
|
||
1. 先查看测试指南的"常见问题排查"
|
||
2. 查看浏览器Console错误（F12）
|
||
3. 记录详细问题和截图
|
||
4. 整理问题清单
|
||
|
||
### 不确定测试结果
|
||
**参考标准**：
|
||
- ✅ 功能正常，无错误 → 通过
|
||
- ⚠️ 基本正常，有小问题 → 有条件通过
|
||
- ❌ 无法工作，严重错误 → 不通过
|
||
|
||
---
|
||
|
||
## 🎊 测试完成后
|
||
|
||
### ✅ 如果验收通过
|
||
|
||
**恭喜！Phase 2验收通过！** 🎉
|
||
|
||
**下一步选择**：
|
||
|
||
#### 选项A：开发Phase 3（批处理模式）⭐ 推荐
|
||
- 时间：1-2天
|
||
- 内容：批量文献处理、结果汇总、导出
|
||
|
||
#### 选项B：开发里程碑2（11个智能体）
|
||
- 时间：2-3周
|
||
- 内容：开发其余11个专业智能体
|
||
|
||
---
|
||
|
||
### ⚠️ 如果有问题需要修复
|
||
|
||
**处理流程**：
|
||
1. 问题分类（严重/中等/轻微）
|
||
2. 优先级排序
|
||
3. 制定修复计划
|
||
4. 修复后用快速测试验证
|
||
5. 重新验收
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
### Phase 2开发文档
|
||
- [Phase2-最终技术方案.md](./docs/05-每日进度/Phase2-最终技术方案.md)
|
||
- [Phase2-完成报告.md](./docs/05-每日进度/Phase2-完成报告.md)
|
||
- [Phase2-最终总结.md](./docs/05-每日进度/Phase2-最终总结.md)
|
||
|
||
### 开发计划
|
||
- [开发里程碑.md](./docs/04-开发计划/开发里程碑.md)
|
||
|
||
---
|
||
|
||
## 🎯 工具包总结
|
||
|
||
| 文件 | 用途 | 耗时 | 优先级 |
|
||
|------|------|------|--------|
|
||
| 如何测试Phase2.md | 使用指南 | 5分钟阅读 | ⭐⭐⭐ |
|
||
| 检查测试环境.bat | 环境检查 | 1分钟 | ⭐⭐⭐ |
|
||
| Phase2-快速测试清单.md | 快速测试 | 30分钟 | ⭐⭐⭐ |
|
||
| Phase2-测试指南.md | 完整测试 | 90分钟 | ⭐⭐ |
|
||
| 一键启动.bat | 启动服务 | 1分钟 | ⭐⭐⭐ |
|
||
|
||
---
|
||
|
||
**准备好开始测试了吗？** 🚀
|
||
|
||
**推荐第一步**：
|
||
1. 打开 `如何测试Phase2.md` 了解全貌（5分钟）
|
||
2. 运行 `检查测试环境.bat` 验证环境（1分钟）
|
||
3. 运行 `一键启动.bat` 启动服务（1分钟）
|
||
4. 打开 `Phase2-快速测试清单.md` 开始测试（30分钟）
|
||
|
||
**总耗时**：约40分钟完成首次快速测试
|
||
|
||
---
|
||
|
||
**祝测试顺利！** 🎉
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|