# 单鼠姿态检测WebRTC项目部署检查清单

## 📋 部署前检查

### 1. 环境要求检查
- [ ] Python 3.11+ 已安装
- [ ] pip 工具可用
- [ ] 虚拟环境已创建 (推荐)
- [ ] 网络连接正常 (用于下载依赖)

### 2. 文件完整性检查
- [ ] `models/kunin-mice-pose.v0.1.5n.pt` - 模型文件 (~11MB)
- [ ] `requirements_gradio_webrtc.txt` - 依赖文件
- [ ] `start_gradio_webrtc.py` - 服务启动器
- [ ] `gradio_webrtc_server.py` - Gradio服务器
- [ ] `gradio_webrtc_api.py` - FastAPI服务器
- [ ] `test_gradio_webrtc_client.py` - 测试客户端
- [ ] `check_model.py` - 模型检查脚本
- [ ] `API对接文档.md` - API文档
- [ ] `README.md` - 项目主文档

### 3. 快速部署
```bash
# 进入项目目录
cd single_mouse_webrtc_project

# 运行自动部署脚本
./deploy.sh

# 或手动步骤:
# 1. 安装依赖
pip install -r requirements_gradio_webrtc.txt

# 2. 检查模型
python check_model.py

# 3. 启动服务
python start_gradio_webrtc.py
```

## 🧪 功能测试清单

### 1. 基础服务测试
- [ ] Gradio界面可访问: http://localhost:7860
- [ ] API服务可访问: http://localhost:8765
- [ ] API文档可访问: http://localhost:8765/docs
- [ ] 状态接口正常: `GET /api/status`

### 2. 模型功能测试
```bash
# 运行完整测试套件
python test_gradio_webrtc_client.py
```

测试项目：
- [ ] API状态检查通过
- [ ] 单帧处理功能正常
- [ ] WebSocket连接正常
- [ ] 批量处理功能正常
- [ ] 摄像头流测试通过

### 3. 性能指标验证
- [ ] CPU模式: 6-15 FPS
- [ ] GPU模式: 30+ FPS (如果可用)
- [ ] 内存使用: < 2GB
- [ ] 响应延迟: < 100ms

## 🔧 故障排除检查

### 1. 常见问题检查
- [ ] 端口7860和8765未被占用
- [ ] Python版本兼容 (3.11+)
- [ ] 所有依赖正确安装
- [ ] 模型文件完整且可读取

### 2. 错误处理验证
- [ ] 无效图像输入处理正常
- [ ] 网络中断恢复正常
- [ ] 高并发连接稳定
- [ ] 内存泄漏检查

## 📊 集成准备检查

### 1. API兼容性
- [ ] WebSocket协议标准兼容
- [ ] REST API规范符合要求
- [ ] JSON数据格式正确
- [ ] Base64图像编码正常

### 2. 前端集成准备
- [ ] CORS配置正确
- [ ] 错误码定义明确
- [ ] 响应格式统一
- [ ] 文档示例可用

### 3. 性能优化配置
- [ ] 图像压缩参数合理
- [ ] 置信度阈值调优
- [ ] 批处理大小优化
- [ ] 连接池配置

## 🚀 生产部署检查

### 1. 安全性检查
- [ ] 服务端口访问控制
- [ ] 输入数据验证
- [ ] 错误信息过滤
- [ ] 日志记录配置

### 2. 监控配置
- [ ] 服务健康检查
- [ ] 性能指标监控
- [ ] 错误日志收集
- [ ] 资源使用监控

### 3. 备份与恢复
- [ ] 模型文件备份
- [ ] 配置文件备份
- [ ] 服务重启脚本
- [ ] 故障恢复流程

## ✅ 部署完成确认

### 最终验证步骤
1. [ ] 运行自动化测试全部通过
2. [ ] 与前端团队对接测试成功
3. [ ] 性能指标达到预期
4. [ ] 文档交付完整
5. [ ] 监控系统配置完成

### 交付清单
- [ ] 完整项目代码包
- [ ] 详细API对接文档
- [ ] 部署和运维指南
- [ ] 测试报告
- [ ] 性能基准数据

---

**检查完成日期**: _____________  
**检查人员**: _____________  
**签名确认**: _____________