新增功能

2026-03-04 15:32:30 +08:00
parent a07e844c47
commit ab77f5488d
2266 changed files with 177942 additions and 3444 deletions
@@ -0,0 +1,263 @@
+# 升级后快速测试指南
+
+## 🚀 快速开始
+
+### 步骤 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