docs: adopt harness coding workflow

docs/08-interaction-checklist.md

@@ -0,0 +1,53 @@
+# 交互清单
+
+> 当前为交互契约草案。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 | 一次点击可确认，显示确认人/时间；并发 ack 有清晰结果 | US-003 | M3 |
+| IX-007 | 升级 | 显示当前层级、下一次升级时间、每次投递状态；失败不能伪装成功 | US-003 | M3 |
+| IX-008 | 事件详情 | 结构化事实、抓拍、视频、时间线、处置；证据加载失败可重试且不丢元数据 | 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 | M3/M4 |
+| IX-013 | 权限与隐私 | 越权统一处理；无授权租户不展示人脸入口；不泄露流 URL/凭据 | US-006 | M3/M4 |
+
+## 全局状态
+
+每个页面/组件至少评估：
+
+- 初始、加载、空数据、成功、部分成功、可重试失败、不可重试失败。
+- 无权限、会话过期、网络断开、后端超时、数据已被他人修改。
+- 长任务的进度、取消、后台继续和结果通知。
+- 批量任务的逐项结果、幂等重试和导出错误清单。
+
+## 桌面与大屏
+
+- 默认 16 路视图不得演变为 16 个同时自动播放的主码流。
+- 64/128 路使用分页、虚拟列表、缩略图按需加载和明确并发预览上限。
+- 值班台的高优先级预警必须可键盘操作，声音/颜色不能成为唯一提示。
+- 地图/平面图与列表能相互定位，但点位缺失时仍可从列表处置。
+
+## App
+
+- push 只作为唤醒入口，最终状态从服务端读取；重复 push 不重复创建处置。
+- ack 和一键呼叫必须防误触但不能藏得太深。
+- 弱网下先显示结构化事件，再渐进加载抓拍/视频。
+- 家属只看到自己的站点和事件证据，不提供常态监控入口。
+
+## 无障碍与安全
+
+- 键盘可完成主要 Web 流程，焦点清晰，表单错误关联到字段。
+- 文本和关键状态满足可读对比度；严重度同时用文字/图标表达。
+- 删除、停用、踢流、批量覆盖和规则正式发布需要明确影响范围与二次确认。
+- UI 不展示摄像头密码、完整连接串、token 或可复用的内部流地址。
+
+## 证据要求
+
+UI 任务完成时在任务文件记录：关联 US/IX、原型路径、自动化测试、关键状态截图/录屏、无障碍检查和人工验收人。未完成的必需人工验收不得标 DONE。