68 lines
9.5 KiB
Markdown
68 lines
9.5 KiB
Markdown
# 交互清单
|
|
|
|
> 当前为交互契约草案。P0 页面开工前需在 `docs/design/` 生成单文件 HTML 原型，并由产品确认；原型只负责结构，本文负责行为和状态。
|
|
|
|
| ID | 场景 | 必须覆盖的状态与行为 | 关联 US | 阶段 |
|
|
| --- | --- | --- | --- | --- |
|
|
| IX-001 | 批量导入设备 | 下载模板、上传校验、逐行错误、重复序列号、待激活、确认写入；任务历史保留逐项结果、操作者与时间，支持仅重试失败项 | US-001 | M2 |
|
|
| IX-002 | 配额与批量结果 | 显示已用/上限；超 16 不等于非法，按站点配置校验；部分成功可重试；配额不可读取时只禁用新增/启用并保留已有列表与流 | US-001 | M2 |
|
|
| IX-003 | 设备列表 | 分页/筛选/批量选择；128 路不一次加载所有视频和详情 | US-001 | M2/M4 |
|
|
| IX-004 | 设备健康 | 期望态、媒体/推理/存储实际态、认证失败、最后在线完整时间与站点时区、时间漂移、分片、重试进度；运维告警独立，凭据更新只允许写入新值且旧值永不回显 | US-002 | M2/M4 |
|
|
| IX-005 | 预警到达 | 明确严重度、站点、时间、证据可用性与关联事件数；重复投递不产生重复处置 | US-003 | M3 |
|
|
| IX-006 | ack | 一次点击可确认，显示确认人/时间；服务端首个成功者成为处置人，并发后到者看到当前处置人和冲突结果，不静默覆盖或显示双成功 | US-003 | M3 |
|
|
| IX-007 | 升级与投递 | 显示当前层级、下一次升级时间；每个通道分别展示已发出、已送达、已看到，Alert ack 单独展示；无回执/不支持/未知、可重试失败及最终失败不得伪装成功 | US-003 | M3 |
|
|
| IX-008 | 事件详情 | 结构化事实、抓拍、视频、时间线、处置；证据加载失败可重试且不丢元数据；Alert 展示关联 Event 与聚合原因，Event 展示触发的 Alert 与最终状态，两边可深链；被抑制且未创建 Alert 的事件明确标为未触发 | US-003 | M3/M4 |
|
|
| IX-009 | 误报反馈 | 确认动作、可选原因、提交成功反馈；只改变 outcome，不改原始事件 | US-004 | M3 |
|
|
| IX-010 | 规则编辑 | 显示租户/站点/设备继承来源，支持区域/警戒线/时段/持续时间 | US-005 | M3/M4 |
|
|
| IX-011 | 规则试运行与回滚 | 明确“未正式生效”，展示命中样本与影响范围，支持取消；回滚前展示目标版本差异与影响，确认后创建并发布等价的新版本，历史版本保持不可变；版本冲突时阻止覆盖并提供刷新/另存路径 | US-005 | M4 |
|
|
| IX-012 | 升级链/静默 | 升级步骤通过类型化目标引用指定人员、值班组或值班排班，不写死号码；显示目标解析预览、联系人顺序、超时与双通道；每次投递固化实际收件人、通道和排班版本快照；静默最长 4h、显示自动恢复时间、无永久选项 | US-005、US-013 | M3/M4 |
|
|
| IX-013 | 权限与隐私 | 越权统一处理；无授权租户不展示人脸入口；不泄露流 URL/凭据 | US-006 | M3/M4 |
|
|
| IX-014 | 设备模态与能力 | 一级入口为“设备”；列表可按 `modality` 筛选，添加时先选模态，详情按 `capabilities` 渐进展示；能力同时显示厂商/型号/固件/认证、探测来源与时间、探测值和生效值差异；视频设备显示画面/媒体/检测区域，未交付的非视频适配器显示 `adapter_not_ready`，不用虚构遥测或禁用的视频页签占位 | US-008 | M2/M6 |
|
|
| IX-015 | 停用与收敛 | 明确区分暂停推理订阅、停用设备接入和仅踢当前会话；暂停推理必须说明“解除推理侧订阅”，并在结果中显示推理订阅、其他 reader 数与上游按需拉流状态；操作前展示对观看、录制与证据回捞的影响并二次确认；期望态立即改变、实际态经对账收敛，部分失败可逐项重试；重复请求不产生重复副作用，但每次请求均留审计结果 | US-001、US-002 | M2 |
|
|
| IX-016 | 隐私区域设备准入 | Area 与 `capture_policy` 由 Bell 统一管理，Sense 消费带版本的只读投影；`non_imaging_only` 不允许新增/启用具有成像能力的设备；前端就地禁用并解释，后端返回稳定错误码；策略读取失败时拒绝新变更并告警，已有设备遇到策略变化时由 Bell 进入显式迁移/取消流程，不静默留存或停用 | US-008、US-010 | M2/M6 |
|
|
| IX-017 | 检测区域几何编辑 | 多边形和方向警戒线支持绘制、显式完成、撤销、清空、顶点编辑；警戒线在草稿/已保存态均显示方向箭头并可反转；鼠标与键盘坐标操作等效；画面参数变化后标记待校准且不自动改坐标；区域版本与规则版本独立 | US-005 | M3 |
|
|
| IX-018 | 草稿与跨系统上下文 | 几何草稿自动保存并可恢复；只有持久化失败或切换空间类型等会破坏草稿的动作才拦截确认；Sense↔Bell 双向携带并消费 `camera + zone + return_to` 上下文；返回后恢复草稿，版本已被他人更新时提示冲突且不覆盖 | US-005 | M3 |
|
|
| IX-019 | 运维中心与写入降级 | Sense 用一个一级“运维中心”聚合对账差异/退避/下次重试/孤儿安全闸、媒体与推理分片、边缘节点/隧道/补传、运维告警和系统状态；配额或 Area 策略不可读取时页面继续可读且已有链路不受影响，只禁用相关写操作；不得混入 Bell 业务预警 | US-002、US-008 | M2/M4/M6 |
|
|
| IX-020 | 管理上下文、RBAC 与审计归属 | 全局头部显示租户、站点、账号和角色；只读角色隐藏写操作，深链越权统一拒绝且不泄露资源是否存在；Tenant/Site/Area/RBAC/配额/全局审计由 Bell 管理，Sense 只呈现消费上下文和设备操作入口，携带 tenant/site/device/return_to 深链到 Bell 审计；Bell 移动端底部导航不超过 5 项，并通过可发现的“管理”入口访问 Site/Area 与审计 | US-006、US-009、US-010 | M2/M4 |
|
|
| IX-021 | 值班交接 | 清单覆盖未 ack、处置中和升级中的 Alert，显示交班人、接班人、备注及下一次升级时间；接班确认写审计，交接期间不暂停或重置升级链，未确认时不转移责任 | US-011 | M3 |
|
|
| IX-022 | 规则验收报表 | 按规则版本与冻结样本窗口展示召回率、每路每天误报数和计算样本量；支持保留口径的导出；不提供跨场景统一准确率 | US-012 | M4 |
|
|
| IX-023 | 联系人与值班排班 | 在“升级链”内部以升级策略、值班与排班、联系人和通道三个二级模块统一设计；联系人与排班共享人员/值班组/已验证通道主数据但分对象维护；排班覆盖站点时区、周轮换、生效日期、临时替班、空档/重叠冲突、当前/未来值班人预览和版本发布审计；交接班只转移进行中 Alert，不暗改未来排班 | US-005、US-011、US-013 | M3/M4 |
|
|
| IX-024 | Brain 单路工程演示 | 固定展示来源类型、fixture/真实检测边界、连接状态、detector 名称、帧序号、处理耗时、匿名 track、区域内外和最近候选；合成/离线数据不得伪装为模型输出。区域支持画布加点、撤销、清空、保存和坐标表单等效路径；保存失败保留草稿。页面不得展示流 URL、凭据、平台事件 ID、Alert 或虚构准确率 | US-014 | M3 |
|
|
|
|
## 全局状态
|
|
|
|
每个页面/组件至少评估：
|
|
|
|
- 初始、加载、空数据、成功、部分成功、可重试失败、不可重试失败。
|
|
- 无权限、会话过期、网络断开、后端超时、数据已被他人修改。
|
|
- 长任务的进度、取消、后台继续和结果通知。
|
|
- 批量任务的逐项结果、幂等重试和导出错误清单。
|
|
|
|
## 桌面与大屏
|
|
|
|
- 默认 16 路视图不得演变为 16 个同时自动播放的主码流。
|
|
- 64/128 路使用分页、虚拟列表、缩略图按需加载和明确并发预览上限。
|
|
- 值班台的高优先级预警必须可键盘操作，声音/颜色不能成为唯一提示。
|
|
- 地图/平面图与列表能相互定位，但点位缺失时仍可从列表处置。
|
|
|
|
## App
|
|
|
|
- push 只作为唤醒入口，最终状态从服务端读取；重复 push 不重复创建处置。
|
|
- ack 和一键呼叫必须防误触但不能藏得太深。
|
|
- 弱网下先显示结构化事件，再渐进加载抓拍/视频。
|
|
- 家属只看到自己的站点和事件证据，不提供常态监控入口。
|
|
|
|
## 无障碍与安全
|
|
|
|
- 键盘可完成主要 Web 流程，焦点清晰，表单错误关联到字段。
|
|
- 正文、按钮文字和关键状态对比度不低于 4.5:1；大字号（不低于 24px，或不低于 18.66px 且粗体）不低于 3:1；非文本控件、状态边界与焦点指示器不低于 3:1。严重度同时用文字/图标表达。
|
|
- 当前导航项显式使用 `aria-current="page"`；响应式隐藏可见文字时，图标按钮仍保留稳定的可访问名。
|
|
- 使用 tab 模式时完整实现 `tablist` / `tab` / `tabpanel`、`aria-controls` / `aria-labelledby`、单一 Tab 停靠点和方向键导航；不能完整实现时不声明 tab 角色。
|
|
- 移动端主要操作目标不小于 44×44px，输入控件正文不小于 16px；绘制画布必须提供无需精确点击的键盘/表单等效路径。
|
|
- 删除、停用、踢流、批量覆盖和规则正式发布需要明确影响范围与二次确认。
|
|
- UI 不展示摄像头密码、完整连接串、token 或可复用的内部流地址。
|
|
|
|
## 证据要求
|
|
|
|
UI 任务完成时在任务文件记录：关联 US/IX、原型路径、自动化测试、关键状态截图/录屏、无障碍检查和人工验收人。未完成的必需人工验收不得标 DONE。
|