Files

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

8.3 KiB

Raw Blame History

📦 Phase 2 测试工具包 - 快速索引

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

🎯 测试目标

验证以下核心功能：

✅ Python文档提取微服务（PDF/Docx/Txt）
✅ Token精确计数和智能管理
✅ 全文阅读模式（35-50篇综合分析）
✅ 逐篇精读模式（1-5篇深度分析）
✅ 文献切换和对话历史独立性

📚 测试工具（共5个）

1️⃣ 【入门必读】如何测试Phase2.md ⭐

用途：测试工具使用指南
内容：

测试策略建议
工具选择指南
常见场景处理
问题记录管理

适合：第一次测试前阅读

2️⃣ 【环境检查】检查测试环境.bat

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

使用：

# 双击运行
检查测试环境.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端口）

使用：

# 双击运行
一键启动.bat

🚀 快速开始（3步）

新手路线 🔰

第1步: 阅读入门必读
  ↓
第2步: 运行环境检查
  ↓
第3步: 打开快速测试清单
  ↓
开始测试！

推荐文件顺序：

如何测试Phase2.md - 先看使用说明
检查测试环境.bat - 检查环境
Phase2-快速测试清单.md - 开始快速测试

老手路线 ⚡

第1步: 运行环境检查
  ↓
第2步: 启动服务
  ↓
第3步: 直接开始测试

文件顺序：

检查测试环境.bat
一键启动.bat
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

测试记录模板

# 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"

📞 需要帮助？

测试过程中遇到问题

先查看测试指南的"常见问题排查"
查看浏览器Console错误（F12）
记录详细问题和截图
整理问题清单

不确定测试结果

参考标准：

✅ 功能正常，无错误 → 通过
⚠️ 基本正常，有小问题 → 有条件通过
❌ 无法工作，严重错误 → 不通过

🎊 测试完成后

✅ 如果验收通过

恭喜！Phase 2验收通过！ 🎉

下一步选择：

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

时间：1-2天
内容：批量文献处理、结果汇总、导出

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

时间：2-3周
内容：开发其余11个专业智能体

⚠️ 如果有问题需要修复

处理流程：

问题分类（严重/中等/轻微）
优先级排序
制定修复计划
修复后用快速测试验证
重新验收

📚 相关文档

Phase 2开发文档

开发计划

开发里程碑.md

🎯 工具包总结

文件	用途	耗时	优先级
如何测试Phase2.md	使用指南	5分钟阅读	⭐⭐⭐
检查测试环境.bat	环境检查	1分钟	⭐⭐⭐
Phase2-快速测试清单.md	快速测试	30分钟	⭐⭐⭐
Phase2-测试指南.md	完整测试	90分钟	⭐⭐
一键启动.bat	启动服务	1分钟	⭐⭐⭐

准备好开始测试了吗？ 🚀

推荐第一步：

打开 如何测试Phase2.md 了解全貌（5分钟）
运行 检查测试环境.bat 验证环境（1分钟）
运行 一键启动.bat 启动服务（1分钟）
打开 Phase2-快速测试清单.md 开始测试（30分钟）

总耗时：约40分钟完成首次快速测试

祝测试顺利！ 🎉

8.3 KiB Raw Blame History Unescape Escape