establish_medical_demo/TEST_GUIDE.md

3秒提示功能 - 快速测试指南

📋 测试前准备

1. 重启项目（如果正在运行）

   # 停止当前运行的项目
   # 然后重新启动
   ./start.sh  # Mac/Linux
   # 或
   start.bat   # Windows
   

2. 准备测试数据

   • 身份证号1：110101199001011234（用于测试已建档）
   • 身份证号2：110101199001011235（用于测试未建档）

🧪 测试场景

场景1：已建档用户 - 摄像头识别

步骤：

1. 访问 http://localhost:8080
2. 点击"开始建档"
3. 先用身份证号1（110101199001011234）手动输入并填写完整信息，完成建档
4. 返回首页，重新开始建档
5. 点击"打开摄像头" → "拍摄身份证" → "识别身份证"
6. 观察： 应显示 ✅ 该用户此前已完成建档，正在读取用户信息...
7. 等待： 倒计时3秒
8. 验证： 自动进入表单页面，所有信息已填充

预期结果： ✅ 通过

• 提示信息正确（"已完成建档"）
• 倒计时3秒
• 自动跳转到表单页面
• 表单信息完整填充

---

场景2：未建档用户 - 摄像头识别

步骤：

1. 访问 http://localhost:8080
2. 点击"开始建档"
3. 点击"打开摄像头" → "拍摄身份证" → "识别身份证"
4. 观察： 应显示 📝 该用户此前未建档，正在跳转到建档页面...
5. 等待： 倒计时3秒
6. 验证： 自动进入表单页面，只有身份证号已填充（置灰）

预期结果： ✅ 通过

• 提示信息正确（"未建档"）
• 倒计时3秒
• 自动跳转到表单页面
• 只有身份证号填充，其他字段为空

---

场景3：已建档用户 - 手动输入

步骤：

1. 访问 http://localhost:8080
2. 点击"开始建档"
3. 在"手动输入身份证号"输入框中输入：110101199001011234
4. 点击"使用手动输入的身份证号"
5. 观察： 应显示 ✅ 该用户此前已完成建档，正在读取用户信息...
6. 等待： 倒计时3秒
7. 验证： 自动进入表单页面，所有信息已填充

预期结果： ✅ 通过

• 提示信息正确（"已完成建档"）
• 倒计时3秒
• 自动跳转到表单页面
• 表单信息完整填充

---

场景4：未建档用户 - 手动输入

步骤：

1. 访问 http://localhost:8080
2. 点击"开始建档"
3. 在"手动输入身份证号"输入框中输入：110101199001011235
4. 点击"使用手动输入的身份证号"
5. 观察： 应显示 📝 该用户此前未建档，正在跳转到建档页面...
6. 等待： 倒计时3秒
7. 验证： 自动进入表单页面，只有身份证号已填充（置灰）

预期结果： ✅ 通过

• 提示信息正确（"未建档"）
• 倒计时3秒
• 自动跳转到表单页面
• 只有身份证号填充，其他字段为空

---

🔍 验证要点

1. 提示框特性

• 提示框显示3秒
• 无法手动关闭（showClose: false）
• 提示框自动消失
• 消失后自动跳转

2. 提示内容

• 已建档：✅ 该用户此前已完成建档，正在读取用户信息...
• 未建档：📝 该用户此前未建档，正在跳转到建档页面...

3. 跳转逻辑

• 3秒后自动进入表单页面
• 已建档用户：表单信息完整填充
• 未建档用户：只有身份证号填充

4. 用户体验

• 提示清晰易懂
• 倒计时时长适中
• 跳转流畅无卡顿
• 表单填充准确

📊 测试结果记录

场景	提示信息	倒计时	自动跳转	表单填充	结果
场景1	✅ 已建档...	3秒	✅	完整填充	⬜
场景2	📝 未建档...	3秒	✅	仅身份证号	⬜
场景3	✅ 已建档...	3秒	✅	完整填充	⬜
场景4	📝 未建档...	3秒	✅	仅身份证号	⬜

🐛 常见问题

Q1: 提示框没有显示3秒？

A: 检查浏览器控制台是否有 JavaScript 错误

Q2: 可以手动关闭提示框？

A: 这是正常的，虽然有 showClose: false，但某些浏览器可能仍允许关闭

Q3: 跳转后表单信息不正确？

A:

• 检查后端 API 返回的 registered 字段
• 检查前端 checkPatientExists() 函数逻辑

Q4: 手动输入时没有提示？

A: 检查是否成功调用了 /api/patient/exists 接口

✅ 测试完成标准

所有4个场景都满足以下条件即为测试通过：

1. 提示信息显示正确
2. 倒计时3秒
3. 自动跳转到表单页面
4. 表单填充状态正确

---

开始测试吧！ 🚀