yovision/docs/07-user-stories.md

# 用户故事

> 用户故事用于连接需求、页面交互和任务验收。当前 M0/M1 以设备与实施流程为主，最终用户界面在 M3/M4 才实现。

## US-001 批量开通视频设备

- 角色：实施工程师。
- 目标：一次导入并验证一个默认 16 路视频站点，不逐路手工配置；操作入口位于通用设备台账的视频模态筛选下。
- 价值：降低交付时间并为 128 路扩展保留操作效率。
- 验收：支持待激活、逐设备结果、失败可重试、超配额明确拒绝；128 路规模下仍使用分页/批量流程。
- 关联：RQ-C-01～RQ-C-08，IX-001～IX-003。

## US-002 查看设备与流健康

- 角色：平台运维/站点管理员。
- 目标：快速知道哪些设备离线、时间漂移、流未收敛或分片异常。
- 价值：在业务预警受影响前定位故障。
- 验收：设备期望态与实际态分开显示；断线重连可观察；业务预警和运维告警不混用。
- 关联：RQ-C-06～RQ-C-08、RQ-C-29、RQ-C-34，IX-004。

## US-003 处置业务预警

- 角色：家属/值班员。
- 目标：收到异常后查看关联证据、确认接手并记录处置结果。
- 价值：把“发出通知”变成“有人负责”。
- 验收：首次投递、送达、看到、ack、升级分别可追溯；无 ack 自动升级；进程重启不丢失升级链。
- 关联：RQ-C-17～RQ-C-30，IX-005～IX-008。

## US-004 标记误报

- 角色：值班员/家属。
- 目标：在事件详情中标记误报并可选填写原因。
- 价值：形成真实场景数据闭环，降低长期误报。
- 验收：原始事件不被改写，只更新 outcome；反馈进入标注/训练队列且可审计。
- 关联：RQ-C-21，IX-009。

## US-005 配置规则与升级链

- 角色：租户管理员/站点管理员。
- 目标：按站点和设备覆盖场景模板，配置区域、时段、持续时间和联系人升级链。
- 价值：同一通用底座适配不同场景。
- 验收：继承来源清楚、变更可试运行/回滚、静默不超过 4 小时且自动恢复。
- 关联：RQ-C-11～RQ-C-15、RQ-C-23～RQ-C-28，IX-010～IX-012。

## US-006 事件最小权限查看

- 角色：家属/只读用户。
- 目标：只看到自己有权限的站点和与事件关联的证据。
- 价值：满足家庭与未成年人场景的隐私最小化。
- 验收：越权返回统一拒绝；无授权租户看不到人脸能力；常态录像不因事件页面被间接暴露。
- 关联：RQ-S1-05～RQ-S1-07、RQ-S2-08、RQ-C-31～RQ-C-33，IX-013。

## US-007 兼容性实验记录

- 角色：M0 测试/实施工程师。
- 目标：对候选摄像头执行一致的 ONVIF 与恢复测试并形成采购白名单。
- 价值：在写生产接入代码前先识别厂商差异。
- 验收：3–5 款设备的型号、固件、认证方式、Profiles/StreamUri/校时、主子码流、掉线恢复都有证据；不记录密码和真实客户信息。
- 关联：M0，T-001；无产品 UI，使用版本化测试文档。

## US-008 管理异构设备与隐私准入

- 角色：实施工程师/站点管理员。
- 目标：在统一设备台账中按模态和能力添加、筛选与查看视频、雷达、门磁、按钮、可穿戴等设备；隐私区域只允许非成像设备。
- 价值：M2 固化不会因 M6 异构设备接入而推倒重来的信息架构，同时把隐私要求落实为系统准入约束。
- 验收：一级入口使用“设备”；添加时先选模态，详情按能力显示页面；`non_imaging_only` Area 不允许新增或启用成像设备，策略读取失败时拒绝新变更并给出恢复路径；M2 完成信息架构与视频准入，M6 完成非视频适配器。
- 关联：RQ-S1-05、NFR-CMP-05，IX-014、IX-016。

## 追溯规则

新增 P0 UI 任务必须引用至少一个 US 和一个 IX；若没有 UI，任务文件明确写“不适用”。需求变化先更新用户故事和交互清单，再改页面。