[T-004] 设计 Sense 与 Bell 交互原型 #8

Merged
ila merged 14 commits from agent/codex/T-004 into main 2026-08-04 14:22:19 +08:00
Owner

Closes #6

当前状态:原型已完成自测,等待项目负责人分别打开 Sense 与 Bell 页面进行人工确认。确认前任务保持 DOING,本 PR 不合并。

  • task_file: docs/tasks/T-004.md
  • context_ref: 32b9859a405a4d64c03b6d3ae765340bc37fdfa0
  • claim_branch: claims/T-004
  • work_branch: agent/codex/T-004

写入路径:

  • docs/tasks/T-004.md
  • docs/design/sense/index.html
  • docs/design/bell/index.html

原型摘要:

  • Sense:参考 MiBeeNvr 信息架构,增加设备健康、期望态/实际态、16/128 路批量接入、多边形与方向警戒线编辑、坐标键盘替代、试运行和发布确认。
  • Bell:预警队列、事件证据、一键 ack、升级倒计时、投递事实、处置结果、误报反馈、规则、升级链、报表和审计。
  • 两页均为单文件内联 CSS/JS,无外部依赖和真实数据,支持深浅主题、加载/空态/错误、键盘焦点和 reduced-motion。

自动/浏览器验证:

  • ./init.ps1:通过(agent context、16 个治理单测、完整治理检查)。
  • 静态 HTML 审���:无重复 id、无未命名按钮、无不可识别表单控件、无外部 HTTP 资源。
  • Playwright:1440×900 与 375×812 无页面级横向溢出,控制台 0 error / 0 warning。
  • Sense:区域坐标添加/保存、摄像头对话框、Esc 退出通过。
  • Bell:ack、弱网降级、误报必填与焦点恢复、Esc 退出通过。

人工门禁:

  • 分别打开两个 HTML,确认信息架构、控件集合、区域编辑与预警处置流程。
  • 需要调整时继续在本分支修改;确认后再把任务标记为 DONE、Issue 切到 review 并合并。

最终治理元数据

  • work_branch: agent/codex/T-004
  • write_paths:
    • docs/tasks/T-004.md
    • docs/design/sense/index.html
    • docs/design/bell/index.html
    • docs/raw/09-Sense原型评审-IX草稿.md
    • docs/raw/11-Sense原型-第二轮缺口.md
    • docs/raw/12-Sense原型-待办清单.md
    • docs/raw/14-Bell原型评审.md
    • docs/routes.md
    • docs/08-interaction-checklist.md
    • docs/07-user-stories.md
    • docs/02-requirements.md
    • docs/04-architecture.md
    • docs/raw/02-需求分析.md
    • docs/raw/03-通用场景应用方案.md
    • docs/raw/08-三系统职责划分.md
Closes #6 > 当前状态:原型已完成自测,等待项目负责人分别打开 Sense 与 Bell 页面进行人工确认。确认前任务保持 `DOING`,本 PR 不合并。 - task_file: `docs/tasks/T-004.md` - context_ref: `32b9859a405a4d64c03b6d3ae765340bc37fdfa0` - claim_branch: `claims/T-004` - work_branch: `agent/codex/T-004` 写入路径: - `docs/tasks/T-004.md` - `docs/design/sense/index.html` - `docs/design/bell/index.html` 原型摘要: - Sense:参考 MiBeeNvr 信息架构,增加设备健康、期望态/实际态、16/128 路批量接入、多边形与方向警戒线编辑、坐标键盘替代、试运行和发布确认。 - Bell:预警队列、事件证据、一键 ack、升级倒计时、投递事实、处置结果、误报反馈、规则、升级链、报表和审计。 - 两页均为单文件内联 CSS/JS,无外部依赖和真实数据,支持深浅主题、加载/空态/错误、键盘焦点和 reduced-motion。 自动/浏览器验证: - `./init.ps1`:通过(agent context、16 个治理单测、完整治理检查)。 - 静态 HTML 审���:无重复 id、无未命名按钮、无不可识别表单控件、无外部 HTTP 资源。 - Playwright:1440×900 与 375×812 无页面级横向溢出,控制台 0 error / 0 warning。 - Sense:区域坐标添加/保存、摄像头对话框、Esc 退出通过。 - Bell:ack、弱网降级、误报必填与焦点恢复、Esc 退出通过。 人工门禁: - 分别打开两个 HTML,确认信息架构、控件集合、区域编辑与预警处置流程。 - 需要调整时继续在本分支修改;确认后再把任务标记为 DONE、Issue 切到 review 并合并。 ## 最终治理元数据 - work_branch: `agent/codex/T-004` - write_paths: - `docs/tasks/T-004.md` - `docs/design/sense/index.html` - `docs/design/bell/index.html` - `docs/raw/09-Sense原型评审-IX草稿.md` - `docs/raw/11-Sense原型-第二轮缺口.md` - `docs/raw/12-Sense原型-待办清单.md` - `docs/raw/14-Bell原型评审.md` - `docs/routes.md` - `docs/08-interaction-checklist.md` - `docs/07-user-stories.md` - `docs/02-requirements.md` - `docs/04-architecture.md` - `docs/raw/02-需求分析.md` - `docs/raw/03-通用场景应用方案.md` - `docs/raw/08-三系统职责划分.md`
ila added 2 commits 2026-08-04 00:24:30 +08:00
docs(tasks): claim T-004
Harness governance / validate (push) Has been cancelled
b643e42535
docs(design): add Sense and Bell prototypes
Harness governance / validate (push) Has been cancelled
Harness governance / validate (pull_request) Has been cancelled
f43a4efa80
ila added 1 commit 2026-08-04 09:04:53 +08:00
docs(design): update Sense workflow
Harness governance / validate (push) Has been cancelled
2715e557a9
ila added 1 commit 2026-08-04 09:04:57 +08:00
docs(design): update Bell workflow
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
5251199205
ila added 1 commit 2026-08-04 09:05:02 +08:00
docs(task): record product review revision
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
618174cbf2
ila added 1 commit 2026-08-04 09:07:20 +08:00
docs(design): restore complete Sense prototype
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
cce38003cb
ila added 1 commit 2026-08-04 09:07:28 +08:00
docs(design): restore complete Bell prototype
Harness governance / validate (push) Has been cancelled
9a82b17b10
ila added 1 commit 2026-08-04 09:07:30 +08:00
docs(task): preserve complete T-004 revision record
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
122cde4938
Author
Owner

已按产品经理复审后的最终建议更新原型与任务文档:

  • Sense 不再提供一级“区域规则”入口;检测区域并入摄像头详情的“画面与检测区域”页签。
  • Sense 只负责区域/线段几何、版本与待校准状态,不承担告警业务规则发布。
  • Bell 统一负责场景模板、继承/覆盖、时间段、持续时长、试运行和正式发布。
  • Sense 与 Bell 通过携带 camera/zone 上下文的相对深链形成连续工作流。
  • T-004 已补充产品边界、验收口径、设计不变量和修订后自测记录。

验证结果:./init.ps1 通过(16 tests);git diff --check 通过;两套 HTML 静态审计、脚本语法检查通过;1440×900 与 375×812 浏览器交互、双向深链、无横向溢出及控制台 0 error 均已验证。远端三个文件的 Blob SHA 已与本地逐一核对一致。

当前仍保留人工验收门禁,T-004 维持 DOING,不自动合并。

已按产品经理复审后的最终建议更新原型与任务文档: - Sense 不再提供一级“区域规则”入口;检测区域并入摄像头详情的“画面与检测区域”页签。 - Sense 只负责区域/线段几何、版本与待校准状态,不承担告警业务规则发布。 - Bell 统一负责场景模板、继承/覆盖、时间段、持续时长、试运行和正式发布。 - Sense 与 Bell 通过携带 camera/zone 上下文的相对深链形成连续工作流。 - T-004 已补充产品边界、验收口径、设计不变量和修订后自测记录。 验证结果:`./init.ps1` 通过(16 tests);`git diff --check` 通过;两套 HTML 静态审计、脚本语法检查通过;1440×900 与 375×812 浏览器交互、双向深链、无横向溢出及控制台 0 error 均已验证。远端三个文件的 Blob SHA 已与本地逐一核对一致。 当前仍保留人工验收门禁,T-004 维持 DOING,不自动合并。
ila added 1 commit 2026-08-04 09:37:50 +08:00
docs(task): expand T-004 review scope
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
d36b785f67
ila added 1 commit 2026-08-04 10:06:08 +08:00
docs(design): apply Sense prototype review
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
e18a1ea83b
Author
Owner

Claude 评审续修已推送到 e18a1ea83b48da6262a2d63d88860c5ff2dd27ca。

本轮完成通用设备信息架构、Area 隐私准入、停止动作收敛、区域草稿/冲突、完整 Tab 键盘交互及 Sense↔Bell 的 camera + zone + return_to 双向深链,并同步正式需求/架构/US/IX 文档。

自动验证已通过:./init.ps1(16 tests)、git diff --check、HTML/JS 静态审计,以及 Edge 1440×900、375×812、812×375 交互验证;运行时 0 exception。PR 继续保留人工验收门禁,不自动合并。

Claude 评审续修已推送到 `e18a1ea83b48da6262a2d63d88860c5ff2dd27ca`。 本轮完成通用设备信息架构、Area 隐私准入、停止动作收敛、区域草稿/冲突、完整 Tab 键盘交互及 Sense↔Bell 的 `camera + zone + return_to` 双向深链,并同步正式需求/架构/US/IX 文档。 自动验证已通过:`./init.ps1`(16 tests)、`git diff --check`、HTML/JS 静态审计,以及 Edge 1440×900、375×812、812×375 交互验证;运行时 0 exception。PR 继续保留人工验收门禁,不自动合并。
ila added 1 commit 2026-08-04 11:10:00 +08:00
docs(design): close Sense second-review gaps
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
e0b0bfafeb
Author
Owner

??????????? e0b0bfa?????????????;Sense/Bell ?????5 ? IA??????Area ?????????????

?????????,? PR ?????

??????????? `e0b0bfa`?????????????;Sense/Bell ?????5 ? IA??????Area ????????????? ?????????,? PR ?????
ila added 1 commit 2026-08-04 11:49:24 +08:00
docs(design): close Bell prototype review gaps
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
e96cc2fbb5
Author
Owner

Bell 原型评审缺口已按最终裁决修复并推送:96cc2f。

本轮完成:

  • 固化
    aw/14 复核定稿,并同步 US-003/005/011/012、IX-005~008/011/020~022 与候选路由职责;
  • 投递按已发出/已送达/已看到展示,ack 独立;覆盖无回执、通道不支持、可重试和最终失败;
  • Alert↔Event 双向导航、并发 ack 真实处置人、值班交接、事件/审计分页;
  • 规则局部版本冲突、历史差异与“创建新版本 v8”回滚;按规则版本/冻结样本窗的召回率和每路每天误报数;
  • 移动端保留 5 项底部导航,通过顶部“管理”进入 Site/Area 与审计;桌面业务/管理分组;
  • 审计深链参数改用 textContent/DOM 构造,恶意 参数未生成节点、未执行脚本。

未采纳/未扩范围:A-2 数据库视图仍是独立架构裁决;未修改 API/schema/生产路由实现;正常业务时间线不展示内部服务重启。

验证:内联 JS、124 个唯一 ID、92 个有名称按钮、无外部依赖/insertAdjacentHTML;Edge/CDP 1440x900、375x812、812x375 覆盖 11 条关键流程,0 runtime exception、无页面级横向溢出;./init.ps1 16/16,git diff --check 通过。

T-004 继续保持 DOING,PR #8 不合并:仍需项目负责人打开 Bell 原型,人工确认信息架构、投递语义、交接与回滚流程。

Bell 原型评审缺口已按最终裁决修复并推送:96cc2f。 本轮完成: - 固化 aw/14 复核定稿,并同步 US-003/005/011/012、IX-005~008/011/020~022 与候选路由职责; - 投递按已发出/已送达/已看到展示,ack 独立;覆盖无回执、通道不支持、可重试和最终失败; - Alert↔Event 双向导航、并发 ack 真实处置人、值班交接、事件/审计分页; - 规则局部版本冲突、历史差异与“创建新版本 v8”回滚;按规则版本/冻结样本窗的召回率和每路每天误报数; - 移动端保留 5 项底部导航,通过顶部“管理”进入 Site/Area 与审计;桌面业务/管理分组; - 审计深链参数改用 textContent/DOM 构造,恶意 <img onerror> 参数未生成节点、未执行脚本。 未采纳/未扩范围:A-2 数据库视图仍是独立架构裁决;未修改 API/schema/生产路由实现;正常业务时间线不展示内部服务重启。 验证:内联 JS、124 个唯一 ID、92 个有名称按钮、无外部依赖/insertAdjacentHTML;Edge/CDP 1440x900、375x812、812x375 覆盖 11 条关键流程,0 runtime exception、无页面级横向溢出;./init.ps1 16/16,git diff --check 通过。 T-004 继续保持 DOING,PR #8 不合并:仍需项目负责人打开 Bell 原型,人工确认信息架构、投递语义、交接与回滚流程。
ila added 1 commit 2026-08-04 14:14:30 +08:00
docs(design): unify Bell roster and escalation targets
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
8115f584dd
Author
Owner

联系人、值班排班与升级策略产品裁决已实现并推送:8115f58。

设计与契约:

  • “同源”修正为共享人员/值班组/已验证通道主数据、分对象建模;Contact/Team、OnCallSchedule/Version/Exception、EscalationPolicy/Step 边界已同步需求与架构;
  • 升级步骤使用 person / team / on_call_schedule 类型化目标,不写死手机号;DeliveryAttempt 固化实际收件人、通道和排班版本快照;
  • 新增 US-013、IX-023,更新 IX-012、/escalations 候选职责及
    aw/14 裁决;交接班只转移进行中 Alert,未来替班走新排班版本。

Bell 原型:

  • 一级“升级链”保留,内部新增“升级策略 / 值班与排班 / 联系人和通道”三个二级模块;
  • 支持目标类型切换与解析预览、Site 时区/周轮换/覆盖率、空档和重叠阻断、临时替班 v13 草稿、版本发布/审计;
  • 联系人表单只包含身份、角色、值班组和需验证通道,不包含班次/轮换字段;已创建投递保留快照。

边界:未实现高级自动排班、外部日历同步、工时合规、自助换班;未修改 API/schema/生产代码。

验证:内联 JS、167 个唯一 ID、114 个有名称按钮、表单标签、无外部依赖/危险 DOM API;Edge/CDP 1440x900、375x812、812x375 覆盖 8 条新流程,0 runtime exception、无页面级横向溢出;./init.ps1 16/16、git diff --check 通过。

T-004/PR #8 继续保持人工验收门禁,项目负责人确认升级链信息架构和排班边界前不合并、不标记 DONE。

联系人、值班排班与升级策略产品裁决已实现并推送:8115f58。 设计与契约: - “同源”修正为共享人员/值班组/已验证通道主数据、分对象建模;Contact/Team、OnCallSchedule/Version/Exception、EscalationPolicy/Step 边界已同步需求与架构; - 升级步骤使用 person / team / on_call_schedule 类型化目标,不写死手机号;DeliveryAttempt 固化实际收件人、通道和排班版本快照; - 新增 US-013、IX-023,更新 IX-012、/escalations 候选职责及 aw/14 裁决;交接班只转移进行中 Alert,未来替班走新排班版本。 Bell 原型: - 一级“升级链”保留,内部新增“升级策略 / 值班与排班 / 联系人和通道”三个二级模块; - 支持目标类型切换与解析预览、Site 时区/周轮换/覆盖率、空档和重叠阻断、临时替班 v13 草稿、版本发布/审计; - 联系人表单只包含身份、角色、值班组和需验证通道,不包含班次/轮换字段;已创建投递保留快照。 边界:未实现高级自动排班、外部日历同步、工时合规、自助换班;未修改 API/schema/生产代码。 验证:内联 JS、167 个唯一 ID、114 个有名称按钮、表单标签、无外部依赖/危险 DOM API;Edge/CDP 1440x900、375x812、812x375 覆盖 8 条新流程,0 runtime exception、无页面级横向溢出;./init.ps1 16/16、git diff --check 通过。 T-004/PR #8 继续保持人工验收门禁,项目负责人确认升级链信息架构和排班边界前不合并、不标记 DONE。
ila added 1 commit 2026-08-04 14:20:45 +08:00
docs(tasks): complete T-004 prototype acceptance
Harness governance / validate (pull_request) Has been cancelled
Harness governance / validate (push) Has been cancelled
547232b7b8
Author
Owner

人工验收门禁已通过:项目负责人确认 Sense 与 Bell 原型均 OK。最终任务状态提交:547232b;T-004 为 DONE,完整治理验证通过。

人工验收门禁已通过:项目负责人确认 Sense 与 Bell 原型均 OK。最终任务状态提交:`547232b`;T-004 为 `DONE`,完整治理验证通过。
ila merged commit de2f1027ec into main 2026-08-04 14:22:19 +08:00
Sign in to join this conversation.