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
parent 1992232fda
commit 855d142fec
32 changed files with 9125 additions and 113 deletions
--- a/如何测试Phase2.md
+++ b/如何测试Phase2.md
@@ -0,0 +1,438 @@
+# 📖 如何测试 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分钟
+
+**使用方法**：
+```bash
+# 双击运行
+检查测试环境.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分钟）
+```bash
+# 双击运行
+检查测试环境.bat
+```
+**看到"🟢 测试环境完全就绪"** → 进入Step 2  
+**看到"🔴 或 🟡"** → 按照提示修复问题
+
+---
+
+### Step 2: 启动服务（2分钟）
+```bash
+# 双击运行
+一键启动.bat
+```
+**等待**：30秒，看到3个窗口打开  
+**验证**：自动打开浏览器 http://localhost:3000
+
+---
+
+### Step 3: 选择测试方式（2分钟）
+
+#### 方式A：快速测试（30分钟）⭐ 推荐
+```bash
+# 打开文档
+Phase2-快速测试清单.md
+```
+**特点**：快速、核心功能验证
+
+#### 方式B：完整测试（90分钟）
+```bash
+# 打开文档
+Phase2-测试指南.md
+```
+**特点**：详细、全面、适合正式验收
+
+---
+
+## 📊 推荐测试流程
+
+### 🎯 首次测试（推荐完整测试）
+
+```mermaid
+graph LR
+    A[检查环境] --> B[启动服务]
+    B --> C[完整测试指南]
+    C --> D[记录问题]
+    D --> E{有严重问题?}
+    E -->|是| F[修复问题]
+    E -->|否| G[验收通过]
+    F --> A
+```
+
+**预计时间**：90-120分钟（含问题修复）
+
+---
+
+### 🔄 日常测试（推荐快速测试）
+
+```mermaid
+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
+```
+
+### 问题清单模板
+
+```markdown
+# 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开发文档
+- [Phase2-最终技术方案.md](./docs/05-每日进度/Phase2-最终技术方案.md)
+- [Phase2-完成报告.md](./docs/05-每日进度/Phase2-完成报告.md)
+- [Phase2-最终总结.md](./docs/05-每日进度/Phase2-最终总结.md)
+
+### 测试文档
+- [Phase2-测试指南.md](./Phase2-测试指南.md) - 完整版
+- [Phase2-快速测试清单.md](./Phase2-快速测试清单.md) - 快速版
+
+### 开发计划文档
+- [开发里程碑.md](./docs/04-开发计划/开发里程碑.md)
+
+---
+
+## 🎯 总结
+
+### 测试工具选择
+
+| 场景 | 推荐工具 | 耗时 |
+|------|---------|------|
+| 首次测试 | 完整测试指南 | 90分钟 |
+| 日常开发测试 | 快速测试清单 | 30分钟 |
+| 问题修复后 | 快速测试清单 | 30分钟 |
+| 正式验收 | 完整测试指南 | 90分钟 |
+| 环境检查 | 环境检查脚本 | 1分钟 |
+
+### 测试流程建议
+
+```
+第1次: 环境检查 → 完整测试 → 记录问题
+第2次: 环境检查 → 快速测试 → 验证修复
+第3次: 环境检查 → 完整测试 → 最终验收
+```
+
+---
+
+**准备好了吗？立即开始测试！** 🚀
+
+1. 运行 `检查测试环境.bat`
+2. 运行 `一键启动.bat`
+3. 打开 `Phase2-快速测试清单.md` 或 `Phase2-测试指南.md`
+4. 开始测试！
+
+**祝测试顺利！** 🎉
+
+
+
+
+
+
+
+
+