70 lines
4.4 KiB
Markdown
70 lines
4.4 KiB
Markdown
---
|
||
id: T-007
|
||
title: 完成客户试点真实多路摄像头现场验收
|
||
phase: 3
|
||
deps: [T-001, T-006]
|
||
status: TODO
|
||
created: 2026-08-04
|
||
issue: 22
|
||
context_ref: null
|
||
claim_branch: null
|
||
work_branch: null
|
||
write_paths:
|
||
- docs/tasks/T-007.md
|
||
- docs/research/pilot-real-camera-integration.md
|
||
- Sense/
|
||
- docs/current-state.md
|
||
---
|
||
|
||
## 问题 / 背景
|
||
|
||
受硬件预算限制，T-006 只用 1 台真实海康摄像头和至少 4 条合成 RTSP 源完成实验室软件闭环，不能证明多台真实设备的并发接入、网络故障隔离、批次一致性或现场恢复。项目无需为日常开发提前采购设备，但在客户试点、借用或租赁条件具备后，生产上线和真实多路 SLA 声明仍需要现场证据。
|
||
|
||
## 关联需求与交互（如适用）
|
||
|
||
- 用户故事：US-001、US-002、US-007。
|
||
- 交互清单：无正式 UI；使用 Sense API、日志、指标和版本化现场记录验收。
|
||
- 前置产物：T-001 指定准入基线、T-006 五路混合源实验室证据。
|
||
|
||
## 方案
|
||
|
||
1. 使用客户授权、借用或租赁设备，在隔离的试点测试窗口建立至少 5 条来自不同真实编码上游的视频通道；优先使用 T-001 准入型号。若型号/硬件/固件不在准入基线，先按 T-001 全矩阵完成独立准入变更，不能在本任务中默许。
|
||
2. 通过 Sense 自动完成设备发现/台账期望态、MediaMTX path、探活和对账；不得人工修改 MediaMTX 配置或复制同一 RTSP URI 凑数。
|
||
3. 对至少一条上游执行摄像头/网络断开恢复，并验证 Sense 与 MediaMTX 分别重启后的全量自动收敛；记录配置期限、实际恢复时间和 `unconverged`。
|
||
4. 全部真实上游同时在线连续观察至少 2 小时；记录码率、分辨率、FPS、连接/重连、path/reader/upstream 一致性和失败时间线。
|
||
5. 将步骤、授权来源、设备身份/固件的脱敏摘要、网络拓扑、命令、结果、限制和签字结论写入 `docs/research/pilot-real-camera-integration.md`，不提交视频样本或秘密。
|
||
|
||
## 不可变约束
|
||
|
||
- 阈值 / 数值边界：至少 5 条独立真实编码上游，同时在线至少 2 小时；同一摄像头/编码会话/RTSP URI 的重复连接和 MediaMTX fan-out 只算 1 路。本任务不替代 16/64/128 路容量验收。
|
||
- 判定式 / 状态转换：数据库仍是期望态真相源；摄像头/网络、Sense、MediaMTX 三类恢复后必须自动达到 `unconverged = 0`，不得人工改配置或重建数据库通过。
|
||
- 安全边界：设备必须自购、借用、租赁或由客户书面授权；在测试窗口使用无敏感人物画面或遮挡画面，证据不含密码、完整 URI、token、客户地址或媒体样本。
|
||
- 上线边界：本任务不阻塞本地开发和 M1 实验室出口，但阻塞客户生产试点启用、真实多路稳定性结论和相关 SLA。
|
||
|
||
## 验收要点
|
||
|
||
- 任务相关验证：执行全部 Sense 单测、vet、migration/契约检查；完成至少 5 路真实上游、2 小时观察和三类恢复；运行三条 harness 治理命令。
|
||
- 完整门禁：若修改 ONVIF、MediaMTX、store、reconcile、probe 或公共 API，重跑全部 Sense 测试和全部现场矩阵。
|
||
- 人工 / 设备验收：必需。客户/实施/硬件负责人核对设备来源、身份、固件、网络、原始时间线、脱敏证据与限制，并签署结论。
|
||
- 构建产物：记录 Sense/MediaMTX 版本与哈希、配置模板、启动/恢复命令和证据文档；不提交摄像头秘密或媒体。
|
||
|
||
## 边界（不改什么）
|
||
|
||
不开发 Brain/Bell 功能，不评估 AI 检出率，不宣称多品牌兼容，不做 16/64/128 路容量验收，不要求项目在客户/借用/租赁条件出现前自行购买额外摄像头。
|
||
|
||
## 协作约束
|
||
|
||
- 责任 Agent：由 dispatcher 分配。
|
||
- 唯一写入者：同责任 Agent。
|
||
- 委派：默认不启用；现场人员可执行设备操作，但任务所有者必须核验并版本化脱敏证据。
|
||
- Gitea：主 Issue 为 #22；T-001、T-006 均为 `DONE` 且外部设备条件具备前保持 `status/waiting`。
|
||
|
||
任何新增写路径先由 dispatcher 与活跃任务做前缀冲突检查。
|
||
|
||
## 执行记录
|
||
|
||
### 2026-08-04 任务定义
|
||
|
||
- 项目负责人批准后续本地开发只使用现有一台海康摄像头，多路由合成 RTSP 补足；真实五路现场证据从 T-006 移入本任务。
|
||
- 设备不要求项目当前采购，可使用客户授权、借用或租赁设备；本任务只阻塞生产试点，不阻塞软件开发。
|