# 部署与评估检查清单

## 上线前

- [ ] 执行 `business.delivery_media_snapshot_feedback.sql`
- [ ] 训练并部署 `models/storefront_int8.onnx`、`models/handover_int8.onnx`、`version.json`
- [ ] 推理机安装 ffmpeg，且能访问 Java 构造的 `video_url`（FTP HTTP 前缀）
- [ ] `application-pro.yml` 中 `snapshot.infer.fail-open-mock: false`
- [ ] `GET /health` 返回 `status=ok` 且两个 ONNX loaded=true

## 性能目标（10 分钟视频，CPU）

| 指标 | POC 目标 |
|------|----------|
| 单条 analyze 耗时 | < 10 分钟 |
| 门头 MAE | < 8s |
| 交付 MAE | < 8s |
| 顺序正确率 | > 95% |

压测命令：

```powershell
cd server/snapshot_infer
py tools/benchmark_cpu.py "http://your-ftp-host/collection_media/xxx.mp4" --sample-fps 0.5
```

## 故障排查

| 现象 | 处理 |
|------|------|
| health degraded | 检查 ONNX 文件是否在 SNAPSHOT_MODEL_DIR |
| analyze 超时 | 增大 Java `read-timeout-ms`；降低 `sample-fps` |
| ASR 慢 | 确认 `WHISPER_MODEL=tiny`；或 `enable-asr: false` 纯视觉 |
| Java snapshot_status=3 | 查看 `snapshot_message` 与推理服务日志 |