docs(design): unify Bell roster and escalation targets
Harness governance / validate (push) Has been cancelled
Harness governance / validate (pull_request) Has been cancelled

This commit is contained in:
QiuSW
2026-08-04 14:14:06 +08:00
parent e96cc2fbb5
commit 8115f584dd
8 changed files with 208 additions and 15 deletions
+12 -3
View File
@@ -35,8 +35,8 @@ Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前,
## 关联需求与交互(如适用)
- 用户故事:Sense 关联 US-001、US-002、US-008、US-009,并为 US-005 提供视频设备空间配置;Bell 关联 US-003~US-006、US-010~US-012,并拥有 US-005 的业务规则工作流及 Tenant/Site/Area/RBAC/配额/全局审计真相。
- 交互清单:Sense 关联 IX-001~IX-004、IX-014~IX-020,并提供 IX-010 所需的区域/警戒线几何;Bell 关联 IX-005~IX-013、IX-016、IX-020~IX-022,负责规则继承/试运行/发布/回滚、站点与 Area 策略、值班交接、验收报表和全局审计。
- 用户故事:Sense 关联 US-001、US-002、US-008、US-009,并为 US-005 提供视频设备空间配置;Bell 关联 US-003~US-006、US-010~US-013,并拥有 US-005 的业务规则工作流及 Tenant/Site/Area/RBAC/配额/全局审计真相。
- 交互清单:Sense 关联 IX-001~IX-004、IX-014~IX-020,并提供 IX-010 所需的区域/警戒线几何;Bell 关联 IX-005~IX-013、IX-016、IX-020~IX-023,负责规则继承/试运行/发布/回滚、联系人/排班/升级策略、站点与 Area 策略、值班交接、验收报表和全局审计。
- 相关页面 / 路由:原型阶段为 `docs/design/sense/index.html` 与 `docs/design/bell/index.html`;同步补充 `docs/routes.md` 的候选页面职责,但不冻结或实现生产 URL。
## 方案
@@ -51,6 +51,7 @@ Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前,
8. 全局头部展示租户、站点、账号和角色;只读角色隐藏写操作,深链越权不泄露资源是否存在。Sense 设备日志带租户/站点/设备条件跳到 Bell 全局审计并可返回。
9. 完成桌面、窄屏、横屏、键盘焦点、加载/空态/错误/依赖降级切换和 `prefers-reduced-motion` 检查,提交人工评审;产品确认前不把任务标为 `DONE`。
10. Bell 事件与审计列表必须分页;规则验收报表按规则版本和冻结样本窗显示召回率与每路每天误报数,不提供跨场景统一准确率;移动端底部主导航保持 5 项,通过顶部“管理”入口访问 Site/Area 与审计。
11. Bell 一级“升级链”内部统一设计升级策略、值班与排班、联系人和通道三个二级模块:共享人员/值班组/已验证通道主数据但分对象维护;升级步骤引用人员/组/排班类型化目标,排班支持时区、周轮换、生效日期、临时替班、冲突检查、解析预览、版本发布和审计,投递保留解析快照。
## 不可变约束
@@ -61,7 +62,7 @@ Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前,
## 验收要点
- 任务相关验证:两个 HTML 可本地打开、无外部依赖;关键按钮和状态切换可用;Sense 一级导航固定 5 项且无“区域规则”,设备列表可按类型/生命周期筛选与分页,视频详情可编辑检测区域,非视频适配器未交付时不伪装在线;运维中心覆盖对账/分片/边缘/运维告警/系统状态;Bell 可演示投递事实、Event↔Alert、并发 ack、交接班、事件/审计分页、试运行、正式发布、新版本回滚、验收报表、移动端管理入口和 Site/Area 策略冲突;Sense↔Bell 规则深链保留 `camera + zone + return_to`,审计深链保留 `tenant + site + device + return_to` 且只按文本渲染参数;运行 HTML 结构检查、`git diff --check` 与 `./init.ps1`。
- 任务相关验证:两个 HTML 可本地打开、无外部依赖;关键按钮和状态切换可用;Sense 一级导航固定 5 项且无“区域规则”,设备列表可按类型/生命周期筛选与分页,视频详情可编辑检测区域,非视频适配器未交付时不伪装在线;运维中心覆盖对账/分片/边缘/运维告警/系统状态;Bell 可演示投递事实、Event↔Alert、并发 ack、交接班、事件/审计分页、试运行、正式发布、新版本回滚、验收报表、移动端管理入口、Site/Area 策略冲突,以及升级策略/排班/联系人二级模块、动态目标解析、排班发布/替班/冲突和投递快照;Sense↔Bell 规则深链保留 `camera + zone + return_to`,审计深链保留 `tenant + site + device + return_to` 且只按文本渲染参数;运行 HTML 结构检查、`git diff --check` 与 `./init.ps1`。
- 完整门禁:本任务不修改 schema/API 或生产路由实现,因此不触发契约实现门禁;候选路由职责已随 IX 更新。若实现范围变化则另立任务。
- 人工 / 设备验收:必需。项目负责人分别打开 Sense 与 Bell 原型,确认页面结构、控件集合和主要工作流;未确认前不得标记 `DONE` 或合并为最终设计。
- 构建产物:`docs/design/sense/index.html`、`docs/design/bell/index.html`;双击浏览器打开,零构建依赖。
@@ -81,6 +82,14 @@ Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前,
## 执行记录
### 2026-08-04 联系人、排班与升级策略产品裁决
- 采纳“一次设计到位”的方向,并将“同源”修正为“共享主数据、分对象建模”:Contact/Team 管身份和已验证通道,OnCallSchedule/Version/Exception 管时区、轮换和替班,EscalationStep 使用人员/组/排班类型化目标;DeliveryAttempt 固化实际收件人、通道与排班版本快照。
- 正式需求、架构、US-005/US-013、IX-012/IX-023、候选路由和 `raw/14` 已同步。交接班继续只转移进行中 Alert,未来替班必须形成排班草稿并发布新版本;高级自动排班、外部日历、工时合规和自助换班后置。
- Bell 保留一级“升级链”,内部新增“升级策略 / 值班与排班 / 联系人和通道”三个二级模块。策略可切换 `person / team / on_call_schedule` 并预览解析结果;排班覆盖 Site 时区、周轮换、覆盖率、空档/重叠阻断、临时替班、v13 发布与版本审计;联系人表单不含班次/轮换字段,通道需要验证且被引用时不可直接删除。
- Node.js 内联脚本、167 个唯一 ID、114 个按钮可访问名、全部表单标签、外部依赖和危险 DOM API 检查通过。Edge/CDP 在 1440×900、375×812、812×375 验证动态目标、解析快照、排班冲突、替班草稿、版本发布、联系人边界、交接边界和二级模块深链:页面级无横向溢出,移动端二级按钮不小于 44px,运行时 0 exception;临时 QA 脚本未写入仓库。
- 自动化验收完成后 T-004 仍保持 `DOING`;需项目负责人打开 Bell 原型人工确认升级链信息架构和排班边界,确认前不合并 PR、不标记 `DONE`。
### 2026-08-04 Bell 原型评审复核与修复
- 将 Claude 评审复核为最终裁决并保存到 `raw/14`:采纳投递状态、Event↔Alert、交接班、分页、回滚和验收报表;纠正 Area 归属、A-2、并发 ack 现状、弱网失败态和重启 UI 建议;额外识别移动端管理入口与审计深链 DOM 注入。