Files
yovision/docs/07-user-stories.md
QiuSW a5f4cbed6f
Harness governance / validate (push) Has been cancelled
docs: adopt harness coding workflow
2026-08-03 22:18:02 +08:00

64 lines
3.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 用户故事
> 用户故事用于连接需求、页面交互和任务验收。当前 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,使用版本化测试文档。
## 追溯规则
新增 P0 UI 任务必须引用至少一个 US 和一个 IX;若没有 UI,任务文件明确写“不适用”。需求变化先更新用户故事和交互清单,再改页面。