From f43a4efa805b64a72d66dda205ec18cf11300091 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Tue, 4 Aug 2026 00:23:55 +0800 Subject: [PATCH] docs(design): add Sense and Bell prototypes --- docs/design/bell/index.html | 443 ++++++++++++++++++++++++++++++ docs/design/sense/index.html | 513 +++++++++++++++++++++++++++++++++++ docs/tasks/T-004.md | 14 + 3 files changed, 970 insertions(+) create mode 100644 docs/design/bell/index.html create mode 100644 docs/design/sense/index.html diff --git a/docs/design/bell/index.html b/docs/design/bell/index.html new file mode 100644 index 0000000..496057e --- /dev/null +++ b/docs/design/bell/index.html @@ -0,0 +1,443 @@ + + + + + + + + YoVision Bell · 预警处置原型 + + + + + +
PROTOTYPE - 仅供枚举交互，非实现依据
+
+ + +
+
+
青藤寄宿学校 · 值班中心客户侧私有实例 · 当前仅匿名安全规则
+
+ + + +
+
+ +
+
+ +
+

实时值班台

先确认高危预警，再查看证据与升级状态；重复投递不会生成重复处置。

值班组在线
+
+
+

待处置预警

6 个未 ack
+
+
+
+ +
+
高危 · S1

危险区域闯入

北围墙 01 · 23:14:08 · EVT-01J8…7A2

+
+
+ + + person · 0.92北围墙 01 · 事件片段事发前 8s · 事发后 12s · 匿名目标 + +
00:11 / 00:20
+
+
+
规则非授权人员进入
置信度0.92
持续时间8.4s
证据状态已校验
+
+
仅显示与本事件关联的 20 秒证据。常态录像仍在客户 NVR，本页不暴露流地址或摄像头凭据。
+
+ + +
+
+ +
+

事件中心

事件是不可变事实；预警与处置结果作为关联记录单独展示。

+
+
今日事件47较昨日 -8%
已触发预警18规则命中后独立创建
误报反馈5进入标注队列
证据可用率97.9%1 个片段可重试
+
+
共 47 条
+ + + +
事件编号时间点位规则事实预警结果证据
EVT-01J8…7A223:14:08北围墙 01非授权人员进入已确认Alert #1842处置中可用
EVT-01J8…69P22:48:31宿舍东通道区域聚集已记录未触发试运行样本可用
EVT-01J8…52C22:19:04实验楼入口危险区域闯入已确认Alert #1839误报重试中
+
+ +
+

规则策略

继承来源、试运行和正式发布清晰分开；空间区域在 Sense 编辑。

+
+
正式生效

非授权人员进入

危险区域 × 全天 × 持续 3 秒

覆盖范围
4 个点位
继承来源
站点模板
今日命中
8
+
试运行

区域内聚集

人数 ≥ 6 × 持续 20 秒 × 夜间

覆盖范围
3 个点位
继承来源
设备覆盖
样本命中
14
+
草稿

方向越线

警戒线 A → B × 上学时段

覆盖范围
1 个点位
继承来源
设备草稿
最近修改
2h 前
+
+
+ +
+

升级链

生产前至少两条独立路径；无回执不能当作成功。

+

校园高危事件 · 默认链

已发布 v4
+
1
值班室 Web + 本地声光立即 · 站点局域网内
主路径
+
2
当班值班员短信立即 · 送达后等待 2 分钟
独立路径
+
3
校级负责人语音未 ack 时升级 · 等待 3 分钟
兜底
+

静默规则

无永久选项

静默仅影响选定规则和点位，到时自动恢复；S1 事件不可静默。

+
+ +
+

运营报表

算法效果和系统 SLA 分开统计；图表同时提供表格导出。

+

近 7 日预警量

按站点日期汇总；可切换到每路每天误报数。

处置结果

本月已闭环事件。

正常处置 61%误报 22%未闭环 17%
+
+ +
+

审计日志

查询、ack、规则发布和证据下载均可追溯；不记录密码与可复用连接串。

+
只读
+ +
时间角色动作对象结果来源
23:14:18站点值班员ACK_ALERTALT-1842成功值班室 Web
22:52:06站点管理员PUBLISH_RULERULE-007成功管理端
22:20:31只读用户VIEW_EVIDENCEEVT-01J8…52C拒绝响应式 H5
+
+
+
+
+ + + +

标记为误报

这只会追加事件 outcome，不会修改原始事件事实和证据。

 + +

创建限时静默

到期自动恢复；S1 高危事件与设备离线运维告警不受此静默影响。

 +
+ + + + diff --git a/docs/design/sense/index.html b/docs/design/sense/index.html new file mode 100644 index 0000000..96fde3a --- /dev/null +++ b/docs/design/sense/index.html @@ -0,0 +1,513 @@ + + + + + + + + YoVision Sense · 设备与视频接入原型 + + + + + +
PROTOTYPE - 仅供枚举交互，非实现依据
+
+ + +
+
+
青藤寄宿学校 / 主校区 · 16 / 16 路
+
+ + + +
+
+ +
+
+ +
+

运行总览

先判断是否影响业务，再进入设备或分片定位原因。

+
+
在线设备
15 / 1693.8% · 1 路重连中
+
活跃媒体流
15主/子码流均衡
+
待收敛项
2配置 1 · 时间漂移 1
+
今日设备告警
3与业务预警分开
+
+
+

分片健康

全部可用
+
media-018 / 32
+
media-028 / 32
+
推理绑定16 / 16
+
+

需要处理

2 项
+

北围墙 03
断线 02:14 · 正在第 4 次重连

+

实验楼入口 02
时间漂移 +3.8s · 建议重新校时

+
+
+
+ +
+

实时监控

默认只并发预览 4 路子码流；切页会释放上一页播放器。

第 1 / 4 页
+
+
+ +
+

摄像头

期望态与实际态分开展示；连接地址和凭据始终脱敏。

+
+
已用 16 / 128
+
设备期望态实际态最后在线时间漂移媒体分片操作
+
+
+ +
+

区域与警戒线

在子码流快照上定义规则空间；保存草稿不会立即影响正式策略。

草稿未发布
+
+ + +
+ +
+ + + + + + + 北围墙 01 · 子码流预览CAM-S2-001 · 704 × 576 · 5 FPS + +
多边形：点击画面添加顶点，双击闭合；也可在右侧输入坐标。
+
+
当前草稿：0 个点缩放 100% · 网格吸附关闭
+
+ + +
+
+ +
+

接入任务

默认 16 路也支持批量导入；128 路时不依赖逐路手工操作。

+
+

导入摄像头

配额 16 / 128
选择 CSV 文件或拖到这里

先本地校验列、重复序列号和配额，不上传明文密码。

+

当前任务

进行中

宿舍区第二批 · 8 路

已验证 5 / 8 · 2 路待补凭据 · 1 路重试中

+
+
+ +
+

系统状态

MediaMTX、数据库和对账器只是可观察组件，不替代设备台账真相。

+
+

Sense 服务

状态
健康
运行时间
12d 06h
待处理队列
2
+

MediaMTX

实例
2 / 2
Readers
15
重连
1
+

本地资源

CPU
22%
内存
4.8 / 16 GB
事件缓存
86 MB
+
+
+
+
+
+ + + + +
+

添加摄像头

+
+
+
+
原型使用保留地址；保存后列表仅显示脱敏端点。
+
+
+
+
+

保存前先验证 Profiles、StreamUri 与校时能力。

+
+
+ +
+ + + + diff --git a/docs/tasks/T-004.md b/docs/tasks/T-004.md index b580e23..994af69 100644 --- a/docs/tasks/T-004.md +++ b/docs/tasks/T-004.md @@ -71,3 +71,17 @@ Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前， - dispatcher `ila` 已将 Issue #6 分配给 `codex`，claim 与工作分支均从精确 `context_ref` 创建并读回一致。 - 在独立 worktree `D:\OPC\yovision-T-004` 开始工作；写入范围仅限本任务声明的三个路径。 + +### 2026-08-04 原型实现 + +- 使用 `ui-ux-pro-max` 生成并复核统一设计系统：深色专业安防控制台、高信息密度、系统字体、语义状态色、150–300ms 微交互、明确焦点和 reduced-motion；Sense 使用青蓝强调接入/画面，Bell 使用紫色强调处置/状态机。 +- `docs/design/sense/index.html` 已覆盖运行总览、4 路按需监控、摄像头期望态/实际态、批量接入、系统健康，以及多边形/方向警戒线的鼠标绘制、坐标键盘替代、撤销、草稿、试运行和发布确认。 +- `docs/design/bell/index.html` 已覆盖预警队列、事件事实与证据、一次点击 ack、升级倒计时和投递事实、处置结果、误报反馈、规则、升级链、报表和审计；弱网时先显示结构化事实并允许证据后台重试。 +- 两个文件均为单文件内联 CSS/JS，无外部依赖、真实视频、客户数据、连接串或人脸入口；顶部均固定显示原型用途提示。 + +### 2026-08-04 自测结果 + +- 标准库 HTML 结构审计通过：两文件均有 viewport、原型横幅、reduced-motion，无重复 `id`、无未命名按钮、无不可识别表单控件和外部 HTTP 资源；Sense 统计 40 个按钮/21 个控件，Bell 统计 42 个按钮/14 个控件。 +- Playwright 在 1440×900 与 375×812 视口实测：两页页面级 `scrollWidth == clientWidth`，桌面三栏和移动底部导航正常，浏览器控制台 0 error / 0 warning；桌面与移动关键状态截图已人工检查，临时 QA 图片未写入仓库。 +- Sense 实测坐标点添加、草稿状态、保存反馈、设备导航、添加摄像头对话框和 Esc 退出；Bell 实测一键 ack、升级计时停止、弱网状态、误报必填校验、错误焦点和 Esc 退出。 +- 尚待项目负责人分别打开两个 HTML，确认页面结构、控件集合和主要工作流；在收到确认前任务保持 `DOING`。