ZYT/zyt
2
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity
Files
ab77f5488d773871fe8047775afda3e79a4e4fb3
zyt/CHECKLIST.md
T
Your Name ab77f5488d 新增功能
2026-03-04 15:32:30 +08:00

6.3 KiB
Raw Blame History

音视频通话功能 - 实施检查清单

📋 文件创建检查

前端文件

  • admin/src/components/video-call/index.vue - 视频通话组件
  • admin/src/api/tcm.ts - API 接口（已更新）
  • admin/src/views/tcm/diagnosis/index.vue - 诊断列表（已更新）
  • admin/package.json - 依赖配置（已更新）
  • admin/INSTALL.md - 安装说明
  • admin/README_VIDEO_CALL.md - 功能文档

后端文件

  • server/app/adminapi/controller/tcm/DiagnosisController.php - 控制器（已更新）
  • server/app/adminapi/logic/tcm/DiagnosisLogic.php - 业务逻辑（已更新）
  • server/app/common/model/tcm/CallRecord.php - 通话记录模型
  • server/config/project.php - 项目配置（已更新）
  • server/config/trtc.php - TRTC 配置文件
  • server/sql/tcm_call_record.sql - 数据库迁移文件
  • server/.env.trtc.example - 环境变量示例

文档文件

  • TRTC_SETUP_GUIDE.md - 完整配置指南
  • TEST_VIDEO_CALL.md - 测试指南
  • VIDEO_CALL_SUMMARY.md - 实现总结
  • README_音视频通话功能.md - 功能说明
  • CHECKLIST.md - 本检查清单

工具脚本

  • install_video_call.bat - Windows 安装脚本
  • install_video_call.sh - Linux/Mac 安装脚本

🔧 安装步骤检查

1. 前端安装

  • 进入 admin 目录
  • 执行 npm install @tencentcloud/call-uikit-vue
  • 验证 package.json 中包含该依赖
  • 执行 npm run build 构建项目

2. 后端配置

  • 复制 server/.env.trtc.example 到 server/.env
  • 填写 TRTC_SDK_APP_ID
  • 填写 TRTC_SECRET_KEY
  • 设置 TRTC_ENABLE=true

3. 数据库迁移

  • 执行 SQL 文件创建通话记录表
  • 验证表 la_tcm_call_record 已创建
  • 检查表结构是否正确

4. 权限配置

  • 在后台添加权限：tcm.diagnosis/video-call
  • 分配权限给相应角色
  • 验证权限控制生效

🧪 功能测试检查

基础功能测试

  • 登录后台管理系统
  • 进入中医诊单页面
  • 点击"视频通话"按钮
  • 对话框正常弹出
  • 显示"正在初始化通话..."

签名获取测试

  • 点击"开始通话"
  • 成功获取签名
  • 返回 sdkAppId、userId、userSig
  • 无错误信息

通话功能测试

  • 授权摄像头权限
  • 授权麦克风权限
  • TUICallKit 初始化成功
  • 显示本地视频画面
  • 可以正常发起通话

通话记录测试

  • 结束通话
  • 通话记录自动保存
  • 记录包含开始时间
  • 记录包含结束时间
  • 记录包含通话时长
  • 时长格式正确（X分X秒）

API 接口测试

  • getCallSignature 接口正常
  • startCall 接口正常
  • endCall 接口正常
  • getCallRecords 接口正常

🔍 代码审查检查

前端代码

  • 组件导入路径正确
  • API 接口路径正确
  • 类型定义完整
  • 错误处理完善
  • 用户提示友好

后端代码

  • 控制器方法完整
  • 参数验证严格
  • 错误处理完善
  • 日志记录充分
  • 安全性考虑周全

数据库设计

  • 表结构合理
  • 索引设置正确
  • 字段类型恰当
  • 注释清晰完整

📖 文档完整性检查

安装文档

  • 安装步骤清晰
  • 命令示例正确
  • 配置说明详细
  • 常见问题覆盖

API 文档

  • 接口地址正确
  • 请求参数完整
  • 响应格式清晰
  • 示例代码可用

测试文档

  • 测试用例完整
  • 测试步骤详细
  • 期望结果明确
  • 故障排查指南

🔒 安全性检查

配置安全

  • 密钥不在代码中硬编码
  • 使用环境变量管理配置
  • .env 文件在 .gitignore 中
  • 提供 .env.example 示例

接口安全

  • 需要 Token 验证
  • 参数验证完整
  • 权限控制严格
  • 防止 SQL 注入
  • 防止 XSS 攻击

数据安全

  • 敏感数据加密
  • 通话记录权限控制
  • 定期清理过期数据

🚀 性能优化检查

前端性能

  • 组件按需加载
  • 避免重复渲染
  • 合理使用缓存
  • 资源压缩优化

后端性能

  • 数据库查询优化
  • 索引使用合理
  • 缓存策略得当
  • 并发处理优化

💰 成本控制检查

使用监控

  • 设置用量告警
  • 定期查看账单
  • 监控异常调用
  • 记录使用统计

优化建议

  • 考虑使用语音通话
  • 设置通话时长限制
  • 优化视频编码参数
  • 定期清理录制文件

📱 兼容性检查

浏览器兼容

  • Chrome 测试通过
  • Edge 测试通过
  • Safari 测试通过
  • Firefox 测试通过

设备兼容

  • Windows PC 测试
  • Mac 测试
  • 移动设备测试（如需要）

网络环境

  • WiFi 环境测试
  • 4G 网络测试
  • 弱网环境测试

🎯 上线前检查

环境准备

  • 生产环境配置正确
  • HTTPS 证书配置
  • 域名解析正确
  • 防火墙规则配置

数据备份

  • 数据库备份
  • 配置文件备份
  • 代码版本标记

监控告警

  • 错误日志监控
  • 性能监控配置
  • 告警通知设置

文档准备

  • 用户使用手册
  • 运维文档
  • 应急预案

✅ 最终验收

功能验收

  • 所有功能正常运行
  • 无严重 Bug
  • 性能达标
  • 用户体验良好

文档验收

  • 文档完整准确
  • 示例代码可用
  • 注释清晰充分

安全验收

  • 通过安全测试
  • 无安全漏洞
  • 权限控制正确

性能验收

  • 响应时间达标
  • 并发处理正常
  • 资源占用合理

📝 备注

已知问题

  • 无

待优化项

  • 可考虑添加通话录制功能
  • 可考虑添加通话质量监控
  • 可考虑添加多人会议支持

后续计划

  • 患者端小程序集成
  • 通话统计报表
  • 通话质量分析

签字确认

  • 开发人员：__________ 日期：__________
  • 测试人员：__________ 日期：__________
  • 项目经理：__________ 日期：__________

检查完成日期: ____________

检查人: ____________

备注: ____________

Reference in New Issue View Git Blame Copy Permalink