# 升级后快速测试指南

## 🚀 快速开始

### 步骤 1：重新安装依赖

```bash
cd admin

# 删除旧依赖
rm -rf node_modules package-lock.json

# 安装新依赖
npm install
```

**预期结果：**
```
✅ 安装成功
✅ 没有错误
✅ package-lock.json 已生成
```

### 步骤 2：启动开发服务器

```bash
npm run dev
```

**预期结果：**
```
✅ 编译成功
✅ 没有错误
✅ 服务器启动在 http://localhost:xxxx
```

### 步骤 3：登录系统

1. 打开浏览器
2. 访问 `http://localhost:xxxx`
3. 登录医生账号

**预期结果：**
```
✅ 登录成功
✅ 进入系统首页
✅ 没有控制台错误
```

### 步骤 4：测试视频通话

1. 进入患者管理页面
2. 找到一个患者
3. 点击"视频通话"按钮

**预期结果：**
```
✅ 弹出通话窗口
✅ 显示"准备通话..."
✅ 点击"开始通话"后初始化成功
✅ 显示"等待对方接听..."
```

### 步骤 5：小程序端接听

1. 小程序端登录对应的患者
2. 等待来电
3. 点击"接听"

**预期结果：**
```
✅ 小程序收到来电
✅ 显示来电界面
✅ 点击接听后通话接通
✅ 双方视频和音频正常
```

## 📋 检查清单

### 编译检查
- [ ] `npm install` 成功
- [ ] `npm run dev` 成功
- [ ] 没有编译错误
- [ ] 没有类型错误

### 功能检查
- [ ] 登录成功
- [ ] 视频通话窗口正常打开
- [ ] 初始化成功
- [ ] 可以发起通话
- [ ] 小程序端可以接收来电
- [ ] 通话可以接通
- [ ] 视频显示正常
- [ ] 音频传输正常
- [ ] 可以正常挂断

### 控制台检查
- [ ] 没有红色错误
- [ ] 没有导入错误
- [ ] 状态回调正常
- [ ] userId 格式正确

## ⚠️ 常见问题

### 问题 1：安装失败

**症状：**
```
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
```

**解决：**
```bash
npm install --legacy-peer-deps
```

### 问题 2：编译错误

**症状：**
```
Cannot find module '@trtc/calls-uikit-vue'
```

**解决：**
```bash
# 1. 确认 package.json 中的包名正确
"@trtc/calls-uikit-vue": "^4.2.2"

# 2. 删除依赖重新安装
rm -rf node_modules package-lock.json
npm install
```

### 问题 3：运行时错误

**症状：**
```
TUICallKitServer is undefined
```

**解决：**
1. 检查导入语句：
   ```typescript
   import { TUICallKitServer } from '@trtc/calls-uikit-vue'
   ```
2. 重启开发服务器
3. 清除浏览器缓存

### 问题 4：通话失败

**症状：**
```
Error: 对方不在线 (60011)
```

**解决：**
1. 检查小程序端是否已登录
2. 检查 userId 格式是否一致
3. 查看详细日志

## 🔍 详细日志检查

### Web 端日志

**登录后：**
```javascript
WebRTC 环境检测: { isHttps: true, ... }
签名获取成功: { doctorUserId: "doctor_1", patientUserId: "patient_2", ... }
TUICallKit init 方法调用完成
初始化完成，显示通话界面
```

**发起通话后：**
```javascript
=== 发起一对一通话 ===
后端返回的 patientUserId: patient_2
最终使用的 targetUserId: patient_2
通话已发起，目标用户: patient_2
>>> 正在呼叫
```

**接通后：**
```javascript
>>> 通话已接通
```

### 小程序端日志

**登录后：**
```javascript
=== 页面已挂载 ===
=== 已设置详细日志级别 ===
获取签名成功: { userId: "patient_2", ... }
TUICallKit 初始化成功, userId: patient_2
=== TUICallKit 初始化完成，等待来电 ===
```

**收到来电后：**
```javascript
[tuikit engine wasm] onNewMessageReceived
=== 通话状态变化 === calling
=== 通话角色 === callee
=== 通话类型 === 2
```

## 🎯 成功标准

当你看到以下情况时，说明升级成功：

### Web 端
- ✅ 编译成功，没有错误
- ✅ 可以正常登录
- ✅ 可以打开通话窗口
- ✅ 可以初始化 TUICallKit
- ✅ 可以发起通话
- ✅ 状态回调正常

### 小程序端
- ✅ 可以正常登录
- ✅ 可以接收来电
- ✅ 状态监听正常
- ✅ 可以正常接听

### 互通测试
- ✅ Web → 小程序通话正常
- ✅ 小程序 → Web 通话正常
- ✅ 视频和音频都正常
- ✅ 通话稳定，不掉线

## 📞 需要帮助？

如果测试失败，请提供：

1. **安装日志**
   ```bash
   npm install > install.log 2>&1
   ```

2. **编译日志**
   - 完整的编译错误信息
   - 截图

3. **运行时日志**
   - 浏览器控制台日志
   - 小程序控制台日志

4. **错误信息**
   - 错误代码
   - 错误提示
   - 完整的错误堆栈

## 📚 相关文档

- **UIKIT_UPGRADE_COMPLETE.md** - 完整升级说明
- **WEB_UIKIT_UPGRADE_GUIDE.md** - Web 端升级指南
- **USERID_FORMAT_CHECK.md** - userId 格式检查
- **FINAL_TEST_CHECKLIST.md** - 完整测试清单

---

**最后更新：** 2024-03-04
**版本：** 1.0