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
This commit is contained in:
238
Phase2-快速测试清单.md
Normal file
238
Phase2-快速测试清单.md
Normal file
@@ -0,0 +1,238 @@
|
||||
# ⚡ Phase 2 快速测试清单（30分钟版）
|
||||
|
||||
**目标**：快速验证Phase 2核心功能是否正常工作
|
||||
**适用场景**：开发后的快速验收
|
||||
**详细版本**：[Phase2-测试指南.md](./Phase2-测试指南.md)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 立即开始（3步）
|
||||
|
||||
### Step 1: 启动服务（2分钟）
|
||||
|
||||
```bash
|
||||
cd D:\MyCursor\AIclinicalresearch
|
||||
.\一键启动.bat
|
||||
```
|
||||
|
||||
**等待**：30秒，看到3个窗口打开
|
||||
**验证**：自动打开 http://localhost:3000
|
||||
|
||||
---
|
||||
|
||||
### Step 2: 准备测试数据（10分钟）
|
||||
|
||||
1. **访问知识库**：http://localhost:3000/knowledge
|
||||
|
||||
2. **创建知识库**
|
||||
- 名称：`快速测试库`
|
||||
- 点击确定
|
||||
|
||||
3. **上传5个文档**
|
||||
- 2个PDF（1个中文、1个英文）
|
||||
- 1个Docx
|
||||
- 2个Txt
|
||||
|
||||
4. **等待处理**：每个约30秒
|
||||
- ✅ 确认全部显示"已就绪"
|
||||
|
||||
---
|
||||
|
||||
### Step 3: 核心功能测试（15分钟）
|
||||
|
||||
#### ✅ 测试A：全文阅读模式（5分钟）
|
||||
|
||||
1. 访问：http://localhost:3000/chat
|
||||
2. 选择：`知识库模式` → `快速测试库` → `全文阅读`
|
||||
3. **验证**：看到容量指示器（5/50篇，XXK/980K）
|
||||
4. **提问**："请总结这些文献的主要内容"
|
||||
5. **验证**：
|
||||
- [ ] AI能提到多篇文献
|
||||
- [ ] 有引用标记`[来源1]`等
|
||||
- [ ] 点击引用能跳转
|
||||
|
||||
---
|
||||
|
||||
#### ✅ 测试B：逐篇精读模式（10分钟）
|
||||
|
||||
1. 切换模式：`逐篇精读`
|
||||
2. **验证**：弹出文献选择器
|
||||
3. 选择3篇文献 → 确认
|
||||
4. **验证**：看到文献切换器（3个标签）
|
||||
|
||||
**精读测试**：
|
||||
```
|
||||
问题1: 这篇文献的主要内容是什么？
|
||||
问题2（追问）: 研究方法是什么？
|
||||
```
|
||||
- [ ] 回答详细准确
|
||||
- [ ] 记住上下文
|
||||
|
||||
**切换测试**：
|
||||
- 切换到第2篇文献
|
||||
- [ ] 对话历史清空（新文献）
|
||||
- 再切回第1篇
|
||||
- [ ] 能看到之前的对话历史
|
||||
|
||||
---
|
||||
|
||||
## ✅ 快速验收清单
|
||||
|
||||
### 核心功能（10项）
|
||||
|
||||
- [ ] 1. Python微服务正常启动（8000端口）
|
||||
- [ ] 2. Backend正常启动（3001端口）
|
||||
- [ ] 3. Frontend正常访问（3000端口）
|
||||
- [ ] 4. 文档上传成功
|
||||
- [ ] 5. 文档处理完成（显示已就绪）
|
||||
- [ ] 6. 容量指示器显示正确
|
||||
- [ ] 7. 全文阅读模式可用
|
||||
- [ ] 8. 文献选择器弹出
|
||||
- [ ] 9. 逐篇精读模式可用
|
||||
- [ ] 10. 文献切换正常
|
||||
|
||||
### 关键指标（5项）
|
||||
|
||||
- [ ] AI回答包含多篇文献（全文模式）
|
||||
- [ ] 有清晰的引用标记
|
||||
- [ ] 逐篇精读回答详细
|
||||
- [ ] 对话历史正确保存
|
||||
- [ ] 文献切换流畅（<1秒）
|
||||
|
||||
---
|
||||
|
||||
## 🐛 快速问题排查
|
||||
|
||||
### 问题1：服务启动失败
|
||||
|
||||
**检查**：
|
||||
```bash
|
||||
# 检查Docker
|
||||
docker ps
|
||||
|
||||
# 检查端口占用
|
||||
netstat -ano | findstr "3000"
|
||||
netstat -ano | findstr "3001"
|
||||
netstat -ano | findstr "8000"
|
||||
```
|
||||
|
||||
**解决**：
|
||||
- 重启Docker Desktop
|
||||
- 关闭占用端口的进程
|
||||
- 手动启动各服务
|
||||
|
||||
---
|
||||
|
||||
### 问题2：文档一直"处理中"
|
||||
|
||||
**检查**：
|
||||
```bash
|
||||
# 检查Python微服务
|
||||
http://localhost:8000/api/health
|
||||
|
||||
# 应该返回：
|
||||
{
|
||||
"status": "healthy",
|
||||
"nougat_available": true,
|
||||
"pymupdf_version": "1.23.8"
|
||||
}
|
||||
```
|
||||
|
||||
**解决**：
|
||||
- 重启Python微服务
|
||||
- 检查extraction_service日志
|
||||
- 删除文档重新上传
|
||||
|
||||
---
|
||||
|
||||
### 问题3：容量显示不对
|
||||
|
||||
**解决**：
|
||||
- 刷新页面
|
||||
- 检查Backend API：
|
||||
```bash
|
||||
http://localhost:3001/api/v1/knowledge-bases/{kbId}/document-selection
|
||||
```
|
||||
- 查看返回数据是否正确
|
||||
|
||||
---
|
||||
|
||||
### 问题4：文献选择器空白
|
||||
|
||||
**检查**：
|
||||
- F12打开Console，查看错误
|
||||
- 确认知识库中有"已就绪"的文档
|
||||
- 刷新页面重试
|
||||
|
||||
---
|
||||
|
||||
### 问题5：文献切换历史丢失
|
||||
|
||||
**临时解决**：
|
||||
- 刷新页面
|
||||
- 重新进入精读模式
|
||||
|
||||
**永久解决**：
|
||||
- 查看Console错误
|
||||
- 检查React状态管理
|
||||
|
||||
---
|
||||
|
||||
## 📊 测试结果记录
|
||||
|
||||
### 服务状态
|
||||
- Python微服务：✅ 正常 / ❌ 异常
|
||||
- Backend：✅ 正常 / ❌ 异常
|
||||
- Frontend：✅ 正常 / ❌ 异常
|
||||
|
||||
### 功能测试
|
||||
- 全文阅读模式：✅ 通过 / ⚠️ 有问题 / ❌ 失败
|
||||
- 逐篇精读模式：✅ 通过 / ⚠️ 有问题 / ❌ 失败
|
||||
|
||||
### 发现的问题
|
||||
1. _____________________________________________
|
||||
2. _____________________________________________
|
||||
3. _____________________________________________
|
||||
|
||||
### 最终结论
|
||||
- [ ] ✅ **验收通过** - 可以进入下一阶段
|
||||
- [ ] ⚠️ **有条件通过** - 修复小问题后可继续
|
||||
- [ ] ❌ **需要返工** - 有重大问题需要修复
|
||||
|
||||
---
|
||||
|
||||
## 🎯 下一步
|
||||
|
||||
### 如果验收通过 ✅
|
||||
1. **选择开发方向**：
|
||||
- 方向A：Phase 3（批处理模式，1-2天）
|
||||
- 方向B：里程碑2（11个智能体，2-3周）
|
||||
|
||||
2. **准备工作**：
|
||||
- 备份当前代码
|
||||
- 创建新分支
|
||||
- 更新任务清单
|
||||
|
||||
### 如果有问题需要修复 ⚠️
|
||||
1. 记录所有问题到 `Phase2-问题清单.md`
|
||||
2. 按优先级排序
|
||||
3. 逐个修复并重新测试
|
||||
|
||||
---
|
||||
|
||||
**测试时间**：______
|
||||
**测试人员**：______
|
||||
**测试结果**：✅ / ⚠️ / ❌
|
||||
|
||||
---
|
||||
|
||||
**需要详细测试？** 查看 [Phase2-测试指南.md](./Phase2-测试指南.md)（90分钟完整版）
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user