opc/yovision
2
0
Fork 0
Code Issues 1 Pull Requests 8 Actions Packages Projects Releases Wiki Activity

[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
Conversation 6 Commits 14 Files Changed 15
+1960 -71
15 changed files with 1960 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/02-requirements.md
+10
View File
@@ -28,10 +28,13 @@
### 3.1 接入与设备
- 支持标准 ONVIF/RTSP，不绑定摄像头品牌。
- 台账与管理端以“设备”为根实体，使用 `modality` 表达 video / radar / contact / button / wearable / other，并使用 `capabilities` 决定是否展示画面、媒体、空间配置、遥测等能力；M1～M5 只完整实现 video 适配器，M6 再接入非视频设备，但不得因此把数据模型和一级信息架构写死为摄像头。
- 支持 NAT 后的边缘主动推流；设备身份使用稳定序列号而非 IP。
- 批量开通不依赖逐路手工操作，支持待激活中间态。
- 探活、离线告警、开通校时、断线自动恢复。
- 容量写入时校验站点配额；配额服务不可用时拒绝新增/启用，但不影响已有流。
- Site、Area 与隐私准入策略由 Bell 统一持有；`capture_policy = video_allowed | non_imaging_only` 通过版本化内部 API 或只读投影提供给 Sense。Sense 在设备新增/启用时依据设备成像能力校验，并显示策略版本/同步状态；策略读取失败时拒绝新的成像设备变更并告警，已有链路不静默停用或伪装为已收敛。
- ONVIF 能力探测必须持久化厂商、型号、固件、认证方式、Profiles、校时与事件订阅结果以及探测时间；UI 区分探测值和最终生效值。M6 前未实现的非视频协议适配器使用 `adapter_not_ready`，不得伪造在线状态或遥测。
### 3.2 分析与规则
@@ -51,8 +54,13 @@
- 预警必须有 ack；未 ack 自动升级，进程重启后能续跑。
- 升级链、超时、联系人和时段可按租户/站点配置。
- 联系人与值班排班必须统一设计并共享人员、值班组和已验证通知通道主数据，但分对象、分版本管理：联系人不承载轮换字段，排班不复制手机号；升级步骤通过类型化目标引用指定人员、值班组或排班计划，不写死号码。
- 值班排班至少覆盖站点时区、周轮换、生效日期、临时替班、空档/重叠冲突检查、当前与未来值班人预览、版本发布和审计。每次投递创建时解析当时生效的排班版本，并固化实际收件人、通道与解析版本快照；后续修改不得改写历史投递事实。
- 至少两条独立投递路径，其中一条可绕过互联网。
- 区分已发出、已送达、已看到；没有回执不能当成功。
- Alert 与 Event 保持可导航的多对多关系；被规则抑制且没有创建 Alert 的 Event 不伪装为已投递。
- 班次交接覆盖未 ack、处置中与升级中的 Alert；接班确认留痕，交接过程不暂停或重置升级链。
- 交接班只显式转移进行中 Alert 的处置责任，不静默修改未来排班；未来班次替换通过排班临时替班并发布新版本完成。
- 静默必须限时且自动恢复，单次不超过 4 小时，无永久静默。
- 业务预警与运维告警使用不同通道和值班配置。
@@ -61,12 +69,14 @@
- 多租户数据、账号、配置和存储隔离；最小 RBAC 为平台管理员、租户管理员、站点管理员、值班员、只读。
- 全链路审计，预警生命周期可追溯。
- Prometheus/Grafana 至少覆盖设备在线、流状态、推理延迟、事件量、未收敛项和投递 SLA。
- Sense 提供面向接入运维的运维中心，聚合对账差异、重试退避、孤儿安全闸、媒体/推理分片、边缘隧道/补传和运维告警；它不承担 Bell 的业务预警和全局管理审计。
- 断网时边缘缓存事件，恢复后补传。
- 不在代码、日志、证据文件名和工单中泄露摄像头凭据、客户名或敏感地址。
### 3.6 管理端与外部集成
- Bell 自研并持有事件、Alert、ack、升级链、租户和审计真相；客户既有平台不得成为这些状态的唯一真相源。
- Bell 管理端持有 Tenant、Site、Area、RBAC、配额和全局审计真相；Sense 只消费当前租户/站点/角色上下文和带版本的配额/Area 策略投影。Area 策略变更与已有成像设备冲突时必须显式迁移或取消，禁止静默停用。
- 对外使用版本化 OpenAPI/Webhook；M3 客户端为值班室 Web + 响应式移动 H5，可嵌入客户系统。
- 投递层必须使用供应商无关的 provider 接口；试点至少有本地声光/Web 与一条短信或语音，生产前补齐两条独立路径及故障切换。
docs/04-architecture.md
+18 -9
View File
@@ -16,16 +16,16 @@ YoVision 使用“通用底座 + 场景包”，按变化频率分为：
| 系统 | 语言/状态 | 职责 | 不负责 |
| --- | --- | --- | --- |
| Sense | Go，有状态 | 设备台账、ONVIF、MediaMTX 控制、对账、探活、隧道、设备型触发、流分片 | AI 判定、事件业务、预警 |
| Sense | Go，有状态 | 设备台账（`modality + capabilities`）、ONVIF 能力探测、MediaMTX 控制、对账、探活、隧道、设备型触发、流分片、配额/Area 策略投影与准入执行、接入运维中心 | AI 判定、事件业务、预警、Tenant/Site/Area/RBAC/全局审计真相 |
| Brain | Python/CUDA，业务无状态 | 解码/推理、检测/姿态/跟踪/ReID、时间窗判定、事件 mapper、像素级触发 | 设备真相源、告警升级、租户权限 |
| Bell | Go + Web，有状态 | 事件校验/存储、规则、预警状态机、投递、反馈、租户/RBAC、审计、配额真相源和管理端 | 媒体转发、模型执行 |
| Bell | Go + Web，有状态 | 事件校验/存储、规则、预警状态机、投递、反馈、Tenant/Site/Area/RBAC、全局审计、配额与 `capture_policy` 真相源和统一管理端 | 媒体转发、模型执行、设备实际态 |
MediaMTX、PostgreSQL、MinIO、Prometheus 等作为独立基础设施部署。
## 3. 部署与系统边界
- 首期每个客户部署一套私有实例，数据和事件证据留在客户环境；数据库实体、RBAC、配置与 API 从第一版携带 `tenant_id` 并保持 SaaS-ready 边界。
- Bell 自研且是事件、Alert、ack、升级链、租户和审计的唯一业务真相源；客户平台通过版本化 OpenAPI/Webhook 集成，不反向接管核心状态机。
- Bell 自研且是事件、Alert、ack、升级链、Tenant/Site/Area/RBAC、配额和全局审计的唯一业务真相源；客户平台通过版本化 OpenAPI/Webhook 集成，不反向接管核心状态机。Sense 只保存执行所需的版本化只读投影，不形成第二份组织/策略真相。
- M1–M3 的视频入口只有 ONVIF/RTSP。现有 NVR 在售前盘点；仅支持 GB/T 28181 的项目必须建立独立适配器任务，不把国标信令混入 Sense 最小骨架。
- M3 客户端为值班室 Web + 响应式移动 H5，可嵌入客户系统；是否开发原生 App 在 M4 后另行决定。
@@ -45,7 +45,7 @@ Sense ── 视频流/触发信号 ──> Brain
主流程：
1. Bell 持有站点配额；Sense 在新增/启用设备时通过版本化内部 API 或只读投影校验。
1. Bell 持有站点、Area、配额与 `capture_policy`；Sense 在新增/启用设备时通过版本化内部 API 或只读投影校验，并记录所用投影版本。
2. Sense 维护设备期望态，通过 MediaMTX API 和对账器收敛实际态。
3. Brain 消费视频与触发信号，产生符合 v0.1 的事件。
4. Bell 做 schema 与代码级断言，生成平台 ULID，保存不可变事件。
@@ -55,7 +55,7 @@ Sense ── 视频流/触发信号 ──> Brain
首个 M3 数据流部署在 S2 民办寄宿学校的 16 路高风险点位，只运行越线、危险区域和聚集等匿名规则，不加载人脸底库。
## 5. 九条不可越界的决定
## 5. 十二条不可越界的决定
1. MediaMTX 独立运行，Sense 管配置与生命周期。
2. 设备型触发源归 Sense；需要解码的像素级触发归 Brain。
@@ -66,6 +66,9 @@ Sense ── 视频流/触发信号 ──> Brain
7. Bell 拥有 `site.max_video_channels`，Sense 在设备写路径执行；不跨 schema 直接写。
8. 事件片段写入客户侧 MinIO/S3，常态录像留在客户 NVR；元数据/审计、人脸和训练样本使用独立生命周期。
9. 投递状态机只依赖 Bell provider 接口，不直接依赖某家短信或语音 SDK；生产前至少两条独立路径并能故障切换。
10. 设备领域模型使用 `modality + capabilities`，页面不以摄像头作为唯一根实体；未实现协议适配器明确为 `adapter_not_ready`，不得用模拟遥测伪装交付。
11. Tenant/Site/Area/RBAC、配额、`capture_policy` 与全局审计属于 Bell；Sense 只读消费版本化投影并在设备写路径执行，投影不可用时只阻断相关新变更，不静默切断已有链路。
12. Sense 的设备操作审计先写本地持久化 outbox，再由幂等 relay 异步送入 Bell 全局审计；不得使用“先执行高风险操作、再尽力入队”的顺序。具体字段、签名、重放与留存契约必须由独立 API/契约任务冻结后实现。
## 6. 容量架构
@@ -82,14 +85,20 @@ Sense ── 视频流/触发信号 ──> Brain
- 对账器水平触发、幂等、指数退避、限制并发；部分失败不做跨系统回滚，只持续收敛。
- 孤儿删除必须有 10% 安全闸和人工可观察指标。
- 配额读取失败只阻止新增/启用，不中断已有流。
- Area 策略投影读取失败只阻止相关设备新增/启用；已有设备保持原状态并产生运维告警。策略变更与已有成像设备冲突时由 Bell 管理端显式处置。
- 高风险设备操作在本地事务内同时写期望态与审计 outbox；异步 relay 可重试、幂等投递到 Bell。T-004 只验证交互归属，不定义或实现接口契约。
- Brain 投递失败落本地队列重试，不阻塞实时推理主链路。
- Alert 先落库再投递，进程重启恢复未完成升级链。
- 值班排班发布前必须按 Site 时区校验班次空档、重叠、联系人停用和通道验证；排班以新版本和未来生效时间发布，不原地改写历史。交接班是进行中 Alert 的显式责任转移事件，不替代排班版本变更。
- 事件证据技术默认保留 30 天并按生命周期删除；客户/法务在 M3 生产上线前确认法规适用性和最终期限，技术默认值不能覆盖其结论。
## 8. 数据与契约
- 核心实体：Tenant → Site → Area/Device → StreamBinding/Zone；Rule → Event → Alert → DeliveryAttempt/Ack。
- Event 与 Alert 不合并：一个事件可触发多次预警与投递，一次预警也可聚合多个事件。
- Bell 核心实体：Tenant → Site → Area（含 `capture_policy`）以及 Role/Binding/Quota/Audit；Sense 核心实体：Device（含 `modality + capabilities`）→ StreamBinding/Zone，以及带 `source_version`/`synced_at` 的 SiteQuota/AreaPolicyProjection。两个 schema 以稳定逻辑 ID 关联，不跨 schema 写入。
- 业务实体：Rule → Event → Alert → DeliveryAttempt/Ack；Event 与 Alert 不合并。
- Bell 通知域分为三个聚合：Contact/Team 保存身份、成员关系和已验证通道；OnCallSchedule/ScheduleVersion/ShiftException 保存时区、轮换与例外；EscalationPolicy/Step 通过 `person / team / on_call_schedule` 类型化 `target_ref` 引用目标。三者共享逻辑 ID，不复制手机号、班次或轮换字段。
- 每个 DeliveryAttempt 创建时解析当时生效的排班版本，并保存实际收件人、通道、`schedule_version` 和解析时间快照；之后联系人或排班修改不得回写既有投递事实。
- 一个事件可触发多次预警与投递，一次预警也可聚合多个事件。
- 事件 v0.1 以 `raw/contracts/event-v0.1.schema.json` 与 `raw/contracts/README.md` 为准；未知顶层字段拒绝，只允许通过 `ext` 扩展。
- v0.1 还需代码校验时间自洽、`confidence` 当前为 null、证据文件名隐私、唯一 primary sensor 等跨字段约束。
- S2 MVP 不处理人脸。首个人脸试点最早 M5，只允许经法务/客户门禁确认的 S4 成人访客/承包商白名单（≤10,000 人），并提供非人脸替代方式。
@@ -108,10 +117,10 @@ Bell/{web,packs,contracts}
## 10. 开发顺序
- M0 不写生产代码。
- M1 只动 Sense，5 路接入骨架与 MediaMTX。
- M1 只动 Sense，5 路视频接入骨架与 MediaMTX；设备模型从此时起保持模态/能力可扩展，但不提前实现非视频适配器。
- M2 仍以 Sense 为主，完成 16 路开通/停用、对账、多租户投影与隧道。
- M3 Brain 与 Bell 同时起步，事件契约首次被真实使用。
- M4/M5 再做 64/128 路分片、完整管理端和多个场景包。
- M4/M5 再做 64/128 路分片、完整管理端和多个场景包；M6 接入雷达、门磁、按钮和可穿戴等非视频适配器。
M3 先执行不少于 2 周的 dry-run，冻结现场标注集，按规则报告召回率和每路每天误报数；现场基线评审后才把数值阈值写入站点验收附件。算法效果指标与系统 SLA 分开验收。
docs/07-user-stories.md
+58 -10
View File
@@ -2,28 +2,28 @@
> 用户故事用于连接需求、页面交互和任务验收。当前 M0/M1 以设备与实施流程为主，最终用户界面在 M3/M4 才实现。
## US-001 批量开通摄像头
## US-001 批量开通视频设备
- 角色：实施工程师。
- 目标：一次导入并验证一个默认 16 路站点，不逐路手工配置。
- 目标：一次导入并验证一个默认 16 路视频站点，不逐路手工配置；操作入口位于通用设备台账的视频模态筛选下。
- 价值：降低交付时间并为 128 路扩展保留操作效率。
- 验收：支持待激活、逐设备结果、失败可重试、超配额明确拒绝；128 路规模下仍使用分页/批量流程。
- 关联：RQ-C-01～RQ-C-08，IX-001～IX-003。
- 验收：导入后先进入待激活，任务历史可查看逐设备成功/失败原因并仅重试失败项；认证失败时提供不回显旧密码的凭据更新路径；超配额明确拒绝；128 路规模下仍使用分页/批量流程。
- 关联：RQ-C-01～RQ-C-08，IX-001～IX-004、IX-015。
## US-002 查看设备与流健康
- 角色：平台运维/站点管理员。
- 目标：快速知道哪些设备离线、时间漂移、流未收敛或分片异常。
- 目标：快速知道哪些设备离线、认证失败、时间漂移、流未收敛、隧道异常或分片异常，并能区分期望态与各下游实际态。
- 价值：在业务预警受影响前定位故障。
- 验收：设备期望态与实际态分开显示；断线重连可观察；业务预警和运维告警不混用。
- 关联：RQ-C-06～RQ-C-08、RQ-C-29、RQ-C-34，IX-004。
- 验收：设备期望态与媒体/推理/存储实际态分开显示；对账差异、退避、下次重试和孤儿安全闸可观察；边缘隧道与视频数据面分别显示；业务预警和运维告警不混用。
- 关联：RQ-C-06～RQ-C-08、RQ-C-29、RQ-C-34，IX-004、IX-019。
## US-003 处置业务预警
- 角色：家属/值班员。
- 目标：收到异常后查看关联证据、确认接手并记录处置结果。
- 价值：把“发出通知”变成“有人负责”。
- 验收：首次投递、送达、看到、ack、升级分别可追溯；无 ack 自动升级；进程重启不丢失升级链。
- 验收：通道的已发出、已送达、已看到，与 Alert 的 ack、升级分别可追溯；无回执、通道不支持、可重试失败和最终失败不伪装成功；Alert 可查看聚合的 Event，Event 可查看触发的 Alert；并发 ack 时后到者看到真实处置人且不能覆盖；无 ack 自动升级，进程重启不丢失升级链。
- 关联：RQ-C-17～RQ-C-30，IX-005～IX-008。
## US-004 标记误报
@@ -37,9 +37,9 @@
## US-005 配置规则与升级链
- 角色：租户管理员/站点管理员。
- 目标：按站点和设备覆盖场景模板，配置区域、时段、持续时间和联系人升级链。
- 目标：按站点和设备覆盖场景模板，配置区域、时段、持续时间和升级链；升级步骤引用指定人员、值班组或值班排班，不直接写死手机号。
- 价值：同一通用底座适配不同场景。
- 验收：继承来源清楚、变更可试运行/回滚、静默不超过 4 小时且自动恢复。
- 验收：继承来源清楚、变更可试运行；升级目标可预览当前解析人和通道，投递后保留解析快照；回滚先展示版本差异与影响，并创建新的不可变版本，不改写历史；静默不超过 4 小时且自动恢复。
- 关联：RQ-C-11～RQ-C-15、RQ-C-23～RQ-C-28，IX-010～IX-012。
## US-006 事件最小权限查看
@@ -58,6 +58,54 @@
- 验收：3–5 款设备的型号、固件、认证方式、Profiles/StreamUri/校时、主子码流、掉线恢复都有证据；不记录密码和真实客户信息。
- 关联：M0，T-001；无产品 UI，使用版本化测试文档。
## US-008 管理异构设备与隐私准入
- 角色：实施工程师/站点管理员。
- 目标：在统一设备台账中按模态和能力添加、筛选与查看视频、雷达、门磁、按钮、可穿戴等设备；隐私区域只允许非成像设备。
- 价值：M2 固化不会因 M6 异构设备接入而推倒重来的信息架构，同时把隐私要求落实为系统准入约束。
- 验收：一级入口使用“设备”；添加时先选模态，详情按探测能力显示页面并标明来源、时间与生效差异；未实现适配器显示 `adapter_not_ready`，不得伪装在线；`non_imaging_only` Area 不允许新增或启用成像设备，策略读取失败时拒绝新变更并给出恢复路径；M2 完成信息架构与视频准入，M6 完成非视频适配器。
- 关联：RQ-S1-05、NFR-CMP-05，IX-014、IX-016、IX-019。
## US-009 以最小权限运维接入系统
- 角色：平台运维/租户管理员/站点管理员/只读用户。
- 目标：进入 Sense 时明确当前租户、站点、账号和角色，并只看到权限范围内的数据与操作。
- 价值：让私有化单租户交付也保留 SaaS-ready 隔离边界，避免原型把管理员权限当成默认事实。
- 验收：切换站点会刷新上下文；只读角色看不到写操作；深链越权安全拒绝且不泄露设备存在性；设备操作日志可带筛选上下文跳到 Bell 全局审计。
- 关联：RQ-C-31～RQ-C-33，IX-013、IX-020。
## US-010 管理站点与区域准入策略
- 角色：租户管理员/站点管理员。
- 目标：在统一管理端维护 Site、Area 层级与 `capture_policy`，并让 Sense 使用同一版本的策略执行设备准入。
- 价值：避免 Area 在 Sense、Bell 各有一份真相，保证权限、报表和隐私准入口径一致。
- 验收：Bell 是 Site/Area/配额/策略真相源；策略变更影响已有成像设备时必须显式选择迁移或取消，不自动停用；Sense 展示策略版本与同步状态，投影不可用时仅拒绝相关新写入。
- 关联：RQ-S1-05、NFR-CMP-05，IX-016、IX-020。
## US-011 完成值班交接
- 角色：交班值班员/接班值班员。
- 目标：在班次结束前把所有未 ack、处置中和升级中的 Alert 连同备注交给下一班，并得到明确接手确认。
- 价值：保证“有人负责”不在班次边界中断。
- 验收：交接清单显示当前状态、处置人与下一次升级时间；接班人确认后写审计；交接过程不暂停、不重置升级链，未确认交接时原责任关系保持不变。
- 关联：RQ-C-17～RQ-C-30，IX-021。
## US-012 导出规则验收效果
- 角色：项目负责人/租户管理员/验收人员。
- 目标：按规则版本和冻结样本窗口查看可复核的召回率与每路每天误报数。
- 价值：让站点验收使用场景相关、可追溯的效果口径，避免跨场景“准确率”误导。
- 验收：报表展示规则版本、样本时间窗、正样本/漏检样本、通道天数、召回率和每路每天误报数；明确不提供跨场景统一准确率；导出保留筛选与口径说明。
- 关联：RQ-C-22、`02-requirements` §8，IX-022。
## US-013 管理联系人和值班排班
- 角色：租户管理员/站点管理员。
- 目标：使用同一套人员、值班组和通知通道主数据配置可发布的值班排班，并让升级策略引用排班目标。
- 价值：避免先把联系人和号码写死进升级链、后续再迁移到时段轮换；同时避免把联系人、班次和轮换混成一个难维护对象。
- 验收：联系人维护身份、角色、值班组和已验证通道，不出现排班轮换字段；排班维护时区、班次、周轮换、生效日期、临时替班和版本；发布前发现空档/重叠并阻止发布，可预览当前及未来值班人；投递固化收件人、通道与排班版本快照；交接进行中 Alert 不静默修改未来排班。
- 关联：RQ-C-24～RQ-C-27、RQ-C-33，IX-012、IX-023。
## 追溯规则
新增 P0 UI 任务必须引用至少一个 US 和一个 IX；若没有 UI，任务文件明确写“不适用”。需求变化先更新用户故事和交互清单，再改页面。
docs/08-interaction-checklist.md
+23 -10
View File
@@ -4,19 +4,29 @@
| ID | 场景 | 必须覆盖的状态与行为 | 关联 US | 阶段 |
| --- | --- | --- | --- | --- |
| IX-001 | 批量导入设备 | 下载模板、上传校验、逐行错误、重复序列号、待激活、确认写入 | US-001 | M2 |
| IX-002 | 配额与批量结果 | 显示已用/上限；超 16 不等于非法，按站点配置校验；部分成功可重试 | US-001 | M2 |
| 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-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 | 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 |
## 全局状态
@@ -44,7 +54,10 @@
## 无障碍与安全
- 键盘可完成主要 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 或可复用的内部流地址。
docs/design/bell/index.html
+999
View File
@@ -0,0 +1,999 @@
<!doctype html>
<html lang="zh-CN" data-theme="dark">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="dark light">
<link rel="icon" href="data:,">
<title>YoVision Bell · 预警处置原型</title>
<style>
:root {
--bg: #090d18;
--surface: #101725;
--surface-2: #151e2e;
--surface-3: #1b2638;
--text: #f5f7fb;
--muted: #a3b0c2;
--subtle: #73839a;
--line: #29364a;
--primary: #8b7cf6;
--primary-strong: #7161e8;
--primary-soft: rgba(139, 124, 246, .14);
--cyan: #38bdf8;
--success: #34d399;
--warning: #fbbf24;
--danger: #fb7185;
--shadow: 0 18px 46px rgba(0, 0, 0, .25);
--radius: 14px;
--sidebar: 216px;
--banner: 28px;
}
html[data-theme="light"] {
--bg: #f1f4f8;
--surface: #ffffff;
--surface-2: #f8fafc;
--surface-3: #eaf0f6;
--text: #131d2c;
--muted: #52647a;
--subtle: #738096;
--line: #d2dbe6;
--primary-soft: rgba(113, 97, 232, .1);
--shadow: 0 14px 34px rgba(32, 52, 78, .12);
}
* { box-sizing: border-box; }
[hidden] { display: none !important; }
html { min-width: 320px; background: var(--bg); }
body { margin: 0; min-height: 100dvh; background: var(--bg); color: var(--text); font: 14px/1.5 Inter, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif; }
button, input, select, textarea { font: inherit; }
button, select, input[type="checkbox"], input[type="radio"] { cursor: pointer; }
button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-visible, [tabindex]:focus-visible { outline: 3px solid rgba(139, 124, 246, .45); outline-offset: 2px; }
.prototype-banner { position: fixed; z-index: 1000; inset: 0 0 auto 0; height: var(--banner); display: flex; align-items: center; justify-content: center; background: #f6c344; color: #211900; font-size: 12px; font-weight: 800; letter-spacing: .07em; }
.icon { width: 18px; height: 18px; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; flex: 0 0 auto; }
.app { min-height: 100dvh; padding-top: var(--banner); display: grid; grid-template-columns: var(--sidebar) minmax(0, 1fr); }
.sidebar { position: sticky; top: var(--banner); z-index: 30; height: calc(100dvh - var(--banner)); padding: 18px 12px; border-right: 1px solid var(--line); background: var(--surface); display: flex; flex-direction: column; }
.brand { display: flex; align-items: center; gap: 10px; padding: 2px 10px 20px; }
.brand-mark { width: 34px; height: 34px; display: grid; place-items: center; border-radius: 10px; background: linear-gradient(145deg, #8b7cf6, #38bdf8); color: white; font-weight: 900; box-shadow: 0 8px 22px rgba(113, 97, 232, .25); }
.brand strong { display: block; font-size: 16px; }
.brand small { color: var(--muted); }
.nav-label { margin: 8px 10px 6px; color: var(--subtle); font-size: 11px; font-weight: 800; text-transform: uppercase; letter-spacing: .12em; }
.nav { display: grid; gap: 4px; }
.nav button { min-height: 44px; padding: 0 12px; border: 0; border-radius: 10px; background: transparent; color: var(--muted); display: flex; align-items: center; gap: 10px; text-align: left; transition: .2s ease; }
.nav button:hover { color: var(--text); background: var(--surface-2); }
.nav button[aria-current="page"] { color: var(--text); background: var(--primary-soft); box-shadow: inset 3px 0 var(--primary); }
.nav .count { margin-left: auto; min-width: 22px; padding: 1px 6px; border-radius: 999px; background: var(--surface-3); color: var(--text); text-align: center; font-size: 12px; }
.shift-card { margin-top: auto; padding: 12px; border: 1px solid var(--line); border-radius: 11px; background: var(--surface-2); }
.shift-card strong { display: block; }
.shift-card span { color: var(--muted); font-size: 12px; }
.shift-bar { margin-top: 9px; height: 5px; border-radius: 99px; background: var(--surface-3); overflow: hidden; }
.shift-bar i { display: block; width: 63%; height: 100%; background: var(--success); }
.main { min-width: 0; }
.topbar { position: sticky; top: var(--banner); z-index: 20; min-height: 64px; padding: 10px 20px; display: flex; align-items: center; gap: 12px; border-bottom: 1px solid var(--line); background: color-mix(in srgb, var(--surface) 94%, transparent); backdrop-filter: blur(12px); }
.site strong { display: block; font-size: 15px; }
.site span { color: var(--muted); font-size: 12px; }
.top-actions { margin-left: auto; display: flex; gap: 8px; align-items: center; }
.btn { min-height: 40px; border: 1px solid var(--line); border-radius: 9px; padding: 8px 13px; background: var(--surface-2); color: var(--text); display: inline-flex; align-items: center; justify-content: center; gap: 8px; font-weight: 750; text-decoration: none; transition: .2s ease; }
.btn:hover { border-color: var(--primary); }
.btn:disabled { cursor: not-allowed; opacity: .5; }
.btn-primary { background: var(--primary-strong); border-color: var(--primary-strong); color: white; }
.btn-success { background: #117a5d; border-color: #159271; color: white; }
.btn-danger { background: rgba(251,113,133,.1); border-color: rgba(251,113,133,.38); color: #ffb4c2; }
.btn-quiet { border-color: transparent; background: transparent; color: var(--muted); }
.icon-btn { width: 42px; padding: 0; }
.text-button { min-height: 32px; padding: 2px 6px; border: 0; background: transparent; color: #b8e5ff; text-decoration: underline; text-underline-offset: 3px; }
.select, .field, .textarea { width: 100%; min-height: 40px; padding: 8px 11px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); color: var(--text); }
.textarea { min-height: 80px; resize: vertical; }
.top-actions .select { width: auto; min-width: 150px; }
.content { padding: 18px; }
.view { display: none; animation: reveal .22s ease-out; }
.view.active { display: block; }
@keyframes reveal { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
.page-head { margin-bottom: 15px; display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; }
.page-head h1 { margin: 0 0 4px; font-size: 24px; line-height: 1.25; }
.page-head p { margin: 0; color: var(--muted); }
.page-actions, .toolbar { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }
.card { border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); box-shadow: var(--shadow); }
.card-head { min-height: 52px; padding: 11px 14px; border-bottom: 1px solid var(--line); display: flex; align-items: center; justify-content: space-between; gap: 10px; }
.card-head h2, .card-head h3 { margin: 0; font-size: 15px; }
.card-body { padding: 14px; }
.badge { display: inline-flex; align-items: center; gap: 5px; min-height: 24px; padding: 2px 8px; border: 1px solid var(--line); border-radius: 999px; color: var(--muted); font-size: 12px; white-space: nowrap; }
.badge.success { color: #78edc2; border-color: rgba(52,211,153,.34); background: rgba(52,211,153,.1); }
.badge.warning { color: #ffe18a; border-color: rgba(251,191,36,.36); background: rgba(251,191,36,.1); }
.badge.danger { color: #ff9eb0; border-color: rgba(251,113,133,.4); background: rgba(251,113,133,.1); }
.badge.info { color: #a5e2ff; border-color: rgba(56,189,248,.35); background: rgba(56,189,248,.1); }
.badge.violet { color: #c9c1ff; border-color: rgba(139,124,246,.38); background: var(--primary-soft); }
.duty-grid { display: grid; grid-template-columns: 320px minmax(420px, 1fr) 330px; gap: 12px; min-height: calc(100dvh - 156px); }
.queue, .evidence, .action-panel { min-width: 0; overflow: hidden; }
.queue-head { padding: 10px; border-bottom: 1px solid var(--line); }
.queue-tabs { display: grid; grid-template-columns: repeat(3, 1fr); gap: 4px; padding: 4px; border-radius: 9px; background: var(--surface-2); }
.queue-tabs button { min-height: 34px; border: 0; border-radius: 7px; background: transparent; color: var(--muted); }
.queue-tabs button.active { background: var(--surface-3); color: var(--text); }
.alert-list { padding: 8px; display: grid; gap: 7px; max-height: calc(100dvh - 265px); overflow-y: auto; }
.alert-card { width: 100%; padding: 11px; border: 1px solid transparent; border-radius: 10px; background: transparent; color: var(--text); text-align: left; transition: .18s ease; }
.alert-card:hover { background: var(--surface-2); }
.alert-card.selected { background: var(--primary-soft); border-color: rgba(139,124,246,.45); }
.alert-card-top, .alert-card-foot { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
.alert-card h3 { margin: 8px 0 3px; font-size: 14px; }
.alert-card p { margin: 0; color: var(--muted); font-size: 12px; }
.alert-card-foot { margin-top: 9px; color: var(--subtle); font-size: 12px; }
.severity-dot { width: 8px; height: 8px; border-radius: 50%; background: currentColor; }
.evidence-summary { padding: 12px 14px; display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; border-bottom: 1px solid var(--line); }
.evidence-summary h2 { margin: 0 0 5px; font-size: 18px; }
.evidence-summary p { margin: 0; color: var(--muted); }
.evidence-tabs { display: flex; gap: 4px; padding: 8px 12px 0; }
.evidence-tabs button { min-height: 36px; padding: 0 12px; border: 0; border-radius: 8px 8px 0 0; background: transparent; color: var(--muted); }
.evidence-tabs button.active { background: var(--surface-2); color: var(--text); }
.video-stage { position: relative; aspect-ratio: 16/9; margin: 0 12px 12px; background: #02060d; overflow: hidden; border: 1px solid var(--line); border-radius: 10px; }
.video-stage svg { width: 100%; height: 100%; display: block; }
.video-controls { position: absolute; inset: auto 0 0; min-height: 44px; padding: 6px 10px; display: flex; align-items: center; gap: 9px; color: white; background: linear-gradient(transparent, rgba(0,0,0,.88)); }
.video-controls button { width: 34px; height: 34px; border: 0; border-radius: 7px; background: rgba(255,255,255,.08); color: white; }
.timeline-bar { flex: 1; height: 5px; border-radius: 99px; background: rgba(255,255,255,.22); overflow: hidden; }
.timeline-bar i { display: block; width: 54%; height: 100%; background: var(--primary); }
.fact-grid { margin: 0 12px 12px; display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 8px; }
.fact { padding: 10px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); }
.fact span { display: block; color: var(--muted); font-size: 11px; }
.fact strong { display: block; margin-top: 3px; font-size: 13px; font-variant-numeric: tabular-nums; }
.privacy-note { margin: 0 12px 12px; padding: 9px 10px; display: flex; gap: 8px; border-left: 3px solid var(--cyan); background: rgba(56,189,248,.08); color: var(--muted); font-size: 12px; }
.relation-panel { margin: 0 12px 12px; padding: 11px; border: 1px solid var(--line); border-radius: 10px; background: var(--surface-2); }
.relation-panel h3 { margin: 0 0 8px; font-size: 13px; }
.relation-list { display: grid; gap: 7px; }
.relation-item { min-height: 40px; padding: 8px 10px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); color: var(--text); display: flex; align-items: center; justify-content: space-between; gap: 10px; text-align: left; }
.relation-item span { color: var(--muted); font-size: 12px; }
.action-scroll { max-height: calc(100dvh - 210px); overflow-y: auto; }
.ack-box { padding: 14px; border-bottom: 1px solid var(--line); }
.ack-box .btn { width: 100%; min-height: 48px; }
.ack-box p { margin: 9px 0 0; color: var(--muted); font-size: 12px; }
.ack-tools { margin-top: 8px; display: flex; justify-content: flex-end; }
.inline-alert { margin-top: 9px; padding: 9px 10px; border: 1px solid rgba(251,191,36,.4); border-radius: 8px; background: rgba(251,191,36,.09); color: #ffe8a8; font-size: 12px; }
.inline-alert.danger { border-color: rgba(251,113,133,.42); background: rgba(251,113,133,.09); color: #ffc3ce; }
.countdown { display: grid; grid-template-columns: auto 1fr; gap: 10px; align-items: center; padding: 12px; margin: 12px; border: 1px solid rgba(251,191,36,.28); border-radius: 10px; background: rgba(251,191,36,.07); }
.countdown strong { display: block; font-size: 20px; color: #ffe18a; font-variant-numeric: tabular-nums; }
.countdown span { color: var(--muted); font-size: 12px; }
.escalation { padding: 0 14px 14px; }
.escalation h3 { margin: 0 0 10px; font-size: 14px; }
.step { position: relative; padding: 0 0 16px 27px; }
.step::before { content: ""; position: absolute; left: 7px; top: 17px; bottom: 0; width: 1px; background: var(--line); }
.step:last-child::before { display: none; }
.step-dot { position: absolute; left: 0; top: 3px; width: 15px; height: 15px; border-radius: 50%; border: 3px solid var(--surface); background: var(--subtle); box-shadow: 0 0 0 1px var(--line); }
.step.done .step-dot { background: var(--success); }
.step.current .step-dot { background: var(--warning); }
.step strong { display: block; }
.step span { color: var(--muted); font-size: 12px; }
.delivery-facts { margin-top: 4px; display: grid; gap: 2px; }
.delivery-facts span { display: block; }
.disposition { padding: 14px; border-top: 1px solid var(--line); display: grid; gap: 9px; }
.disposition label { color: var(--muted); font-size: 12px; font-weight: 700; }
.disposition-actions { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; }
.grid { display: grid; gap: 12px; }
.stats { grid-template-columns: repeat(4, minmax(0, 1fr)); margin-bottom: 12px; }
.stat { padding: 15px; min-height: 110px; display: flex; flex-direction: column; justify-content: space-between; }
.stat span { color: var(--muted); }
.stat strong { font-size: 27px; font-variant-numeric: tabular-nums; }
.search { position: relative; min-width: 230px; }
.search .icon { position: absolute; left: 11px; top: 11px; color: var(--subtle); pointer-events: none; }
.search input { padding-left: 38px; }
.table-wrap { overflow-x: auto; }
table { width: 100%; border-collapse: collapse; min-width: 870px; }
th, td { padding: 12px 14px; border-bottom: 1px solid var(--line); text-align: left; vertical-align: middle; }
th { background: var(--surface-2); color: var(--muted); font-size: 12px; }
td { font-variant-numeric: tabular-nums; }
tr:last-child td { border-bottom: 0; }
tr:hover td { background: color-mix(in srgb, var(--primary-soft) 50%, transparent); }
.pager { min-height: 58px; padding: 10px 14px; border-top: 1px solid var(--line); display: flex; align-items: center; justify-content: space-between; gap: 12px; }
.pager-actions { display: flex; gap: 7px; }
.rule-grid { grid-template-columns: repeat(3, minmax(0, 1fr)); }
.rule-card { padding: 15px; }
.rule-card-top { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
.rule-card h2 { margin: 12px 0 5px; font-size: 16px; }
.rule-card p { margin: 0 0 14px; color: var(--muted); }
.rule-card dl { margin: 0; display: grid; grid-template-columns: 1fr auto; gap: 7px; color: var(--muted); }
.rule-card dd { margin: 0; color: var(--text); }
.rule-card-actions { margin-top: 14px; padding-top: 12px; display: flex; flex-wrap: wrap; gap: 7px; border-top: 1px solid var(--line); }
.rule-context { margin-bottom: 12px; padding: 11px 13px; display: flex; align-items: center; justify-content: space-between; gap: 12px; border: 1px solid rgba(56,189,248,.34); border-radius: 10px; background: rgba(56,189,248,.08); }
.rule-context[hidden] { display: none; }
.rule-context p { margin: 0; color: var(--muted); }
.site-grid { grid-template-columns: minmax(260px,.72fr) minmax(520px,1.45fr); }
.site-list { padding: 8px; display: grid; gap: 7px; }
.site-item { width: 100%; min-height: 62px; padding: 10px 12px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); color: var(--text); display: flex; justify-content: space-between; align-items: center; gap: 10px; text-align: left; }
.site-item.active { border-color: var(--primary); background: var(--primary-soft); }
.site-item small { display: block; color: var(--muted); }
.policy-note { margin: 12px 14px 0; padding: 10px 12px; border-left: 3px solid var(--warning); background: rgba(251,191,36,.08); color: var(--muted); }
.context-strip { margin-bottom: 12px; padding: 11px 13px; border: 1px solid rgba(56,189,248,.34); border-radius: 10px; background: rgba(56,189,248,.08); display: flex; align-items: center; justify-content: space-between; gap: 12px; }
.context-strip p { margin: 0; color: var(--muted); }
.linked-zone { grid-column: 1/-1; padding: 11px; display: flex; align-items: center; justify-content: space-between; gap: 12px; border: 1px solid var(--line); border-radius: 10px; background: var(--surface-2); }
.linked-zone strong, .linked-zone small { display: block; }
.linked-zone small { color: var(--muted); }
.workflow-note { grid-column: 1/-1; margin: 0; padding: 10px 11px; border-left: 3px solid var(--primary); background: var(--primary-soft); color: var(--muted); font-size: 12px; }
.version-diff { display: grid; gap: 8px; }
.version-diff article { padding: 10px 12px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); }
.version-diff article strong { display: block; }
.chain-subnav { margin-bottom: 12px; padding: 4px; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 4px; border: 1px solid var(--line); border-radius: 11px; background: var(--surface); }
.chain-subnav button { min-height: 44px; border: 0; border-radius: 8px; background: transparent; color: var(--muted); font-weight: 750; }
.chain-subnav button.active { background: var(--primary-soft); color: var(--text); box-shadow: inset 0 0 0 1px rgba(139,124,246,.36); }
.chain-panel { display: none; }
.chain-panel.active { display: block; }
.chain-grid { grid-template-columns: minmax(0, 1.4fr) minmax(300px, .8fr); }
.chain-row { padding: 13px 14px; display: grid; grid-template-columns: 40px 1fr auto; gap: 11px; align-items: center; border-bottom: 1px solid var(--line); }
.chain-row:last-child { border-bottom: 0; }
.chain-num { width: 32px; height: 32px; display: grid; place-items: center; border-radius: 50%; background: var(--primary-soft); color: #cfc8ff; font-weight: 800; }
.chain-row small { color: var(--muted); }
.target-ref { display: inline-block; margin-top: 3px; color: #b8e5ff; font: 12px/1.4 ui-monospace, SFMono-Regular, Consolas, monospace; }
.resolve-card { padding: 14px; }
.resolve-card h2 { margin: 0 0 4px; font-size: 15px; }
.resolve-card > p { margin: 0 0 12px; color: var(--muted); }
.resolve-list { display: grid; gap: 8px; }
.resolve-item { padding: 10px 11px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); }
.resolve-item span, .resolve-item small { display: block; color: var(--muted); }
.resolve-item strong { display: block; margin: 2px 0; }
.roster-week { padding: 12px; display: grid; grid-template-columns: repeat(7, minmax(125px, 1fr)); gap: 8px; overflow-x: auto; }
.roster-day { min-width: 125px; padding: 10px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); }
.roster-day.current { border-color: var(--primary); background: var(--primary-soft); }
.roster-day > strong { display: block; margin-bottom: 8px; }
.shift-slot { padding: 8px 0; border-top: 1px solid var(--line); }
.shift-slot:first-of-type { border-top: 0; }
.shift-slot span, .shift-slot small { display: block; color: var(--muted); font-size: 12px; }
.shift-slot strong { display: block; margin: 2px 0; font-size: 13px; }
.object-note { padding: 11px 14px; border-top: 1px solid var(--line); color: var(--muted); }
.contact-summary { grid-template-columns: repeat(3, minmax(0, 1fr)); margin-bottom: 12px; }
.contact-summary .stat { min-height: 96px; }
.chart-grid { grid-template-columns: 1.35fr .65fr; }
.chart { padding: 16px; }
.chart h2 { margin: 0; font-size: 15px; }
.chart p { margin: 4px 0 14px; color: var(--muted); }
.bars { height: 220px; display: flex; align-items: end; gap: 16px; padding: 10px 6px 26px; border-bottom: 1px solid var(--line); }
.bar { position: relative; flex: 1; min-width: 24px; height: var(--h); border-radius: 7px 7px 0 0; background: linear-gradient(180deg, var(--primary), #4f46a8); }
.bar span { position: absolute; inset: calc(100% + 5px) 0 auto; text-align: center; color: var(--muted); font-size: 11px; }
.donut { width: 170px; height: 170px; margin: 18px auto; border-radius: 50%; background: conic-gradient(var(--success) 0 61%, var(--warning) 61% 83%, var(--danger) 83%); position: relative; }
.donut::after { content: "83%\A 24h 内闭环"; white-space: pre; position: absolute; inset: 27px; border-radius: 50%; display: grid; place-items: center; text-align: center; background: var(--surface); color: var(--text); font-weight: 800; }
.legend { display: flex; flex-wrap: wrap; gap: 10px; color: var(--muted); font-size: 12px; }
.legend i { display: inline-block; width: 9px; height: 9px; margin-right: 5px; border-radius: 2px; }
.metric-note { margin: 12px 0 0; padding: 10px 12px; border-left: 3px solid var(--cyan); background: rgba(56,189,248,.08); color: var(--muted); }
.state-layer { display: none; min-height: 420px; place-items: center; padding: 24px; border: 1px dashed var(--line); border-radius: var(--radius); background: var(--surface); text-align: center; }
.state-layer.show { display: grid; }
.state-layer .icon { width: 40px; height: 40px; color: var(--primary); }
.state-layer h2 { margin: 12px 0 4px; font-size: 18px; }
.state-layer p { margin: 0 0 14px; max-width: 460px; color: var(--muted); }
.skeleton { width: min(460px, 90%); display: grid; gap: 10px; }
.skeleton i { height: 15px; border-radius: 6px; background: linear-gradient(90deg, var(--surface-3), var(--line), var(--surface-3)); background-size: 200% 100%; animation: shimmer 1.4s infinite; }
.skeleton i:nth-child(2) { width: 72%; }
@keyframes shimmer { to { background-position: -200% 0; } }
dialog { width: min(610px, calc(100% - 28px)); max-height: 88dvh; padding: 0; border: 1px solid var(--line); border-radius: 16px; background: var(--surface); color: var(--text); box-shadow: 0 24px 80px rgba(0,0,0,.5); }
#ruleDialog, #eventDialog, #handoverDialog, #rollbackDialog, #escalationDialog, #scheduleDialog, #substituteDialog, #contactDialog { width: min(760px, calc(100% - 28px)); }
dialog::backdrop { background: rgba(4,7,15,.68); backdrop-filter: blur(4px); }
.dialog-head, .dialog-foot { padding: 14px 18px; border-bottom: 1px solid var(--line); display: flex; align-items: center; justify-content: space-between; gap: 10px; }
.dialog-head h2 { margin: 0; font-size: 17px; }
.dialog-body { padding: 18px; overflow: auto; }
.dialog-foot { border: 0; border-top: 1px solid var(--line); justify-content: flex-end; }
.form-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
.form-field { display: grid; gap: 6px; }
.form-field.full { grid-column: 1/-1; }
.form-field label { color: var(--muted); font-size: 12px; font-weight: 700; }
.radio-card { display: block; margin-bottom: 9px; padding: 11px 12px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-2); }
.toast { position: fixed; right: 20px; bottom: 20px; z-index: 1100; max-width: min(420px, calc(100% - 40px)); padding: 12px 14px; border: 1px solid rgba(52,211,153,.35); border-radius: 10px; background: #0b2c25; color: #d9fff3; box-shadow: var(--shadow); transform: translateY(20px); opacity: 0; pointer-events: none; transition: .2s ease; }
.toast.show { transform: none; opacity: 1; }
.muted { color: var(--muted); }
.mono { font-family: ui-monospace, SFMono-Regular, Consolas, monospace; font-variant-numeric: tabular-nums; }
.mobile-nav { display: none; }
.mobile-manage { display: none; }
@media (max-width: 1240px) {
:root { --sidebar: 78px; }
.brand-copy, .nav span:not(.count), .nav-label, .shift-card { display: none; }
.brand { justify-content: center; padding-inline: 0; }
.nav button { justify-content: center; padding: 0; }
.nav .count { position: absolute; margin: -24px 0 0 25px; }
.duty-grid { grid-template-columns: 285px minmax(390px, 1fr); }
.action-panel { grid-column: 1/-1; }
.action-scroll { max-height: none; display: grid; grid-template-columns: repeat(3, 1fr); }
.disposition { border-top: 0; border-left: 1px solid var(--line); }
}
@media (max-width: 850px) {
:root { --sidebar: 0px; }
.app { display: block; padding-bottom: 66px; }
.sidebar { display: none; }
.topbar { padding: 8px 12px; }
.site span, .top-actions .select { display: none; }
.mobile-manage { display: inline-flex; min-width: 44px; }
.content { padding: 12px; }
.btn, .select, .field, .textarea { min-height: 44px; }
.icon-btn { min-width: 44px; }
.duty-grid, .chain-grid, .chart-grid { grid-template-columns: 1fr; }
.alert-list, .action-scroll { max-height: none; }
.action-scroll { display: block; }
.disposition { border-left: 0; border-top: 1px solid var(--line); }
.stats { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.site-grid { grid-template-columns: 1fr; }
.roster-week { grid-template-columns: repeat(2, minmax(145px, 1fr)); }
.rule-grid { grid-template-columns: 1fr 1fr; }
.fact-grid { grid-template-columns: repeat(2, 1fr); }
.pager { align-items: flex-start; flex-direction: column; }
.mobile-nav { position: fixed; z-index: 50; left: 8px; right: 8px; bottom: 8px; display: grid; grid-template-columns: repeat(5, 1fr); padding: 5px; border: 1px solid var(--line); border-radius: 14px; background: var(--surface); box-shadow: var(--shadow); }
.mobile-nav button { min-height: 48px; border: 0; border-radius: 9px; background: transparent; color: var(--muted); display: grid; place-items: center; font-size: 11px; }
.mobile-nav button.active { color: #c9c1ff; background: var(--primary-soft); }
}
@media (max-width: 560px) {
.page-head { display: grid; }
.stats, .rule-grid { grid-template-columns: 1fr; }
.chain-subnav { grid-template-columns: 1fr; }
.contact-summary { grid-template-columns: 1fr; }
.roster-week { grid-template-columns: 1fr; }
.form-grid { grid-template-columns: 1fr; }
.form-field.full { grid-column: auto; }
.video-stage { margin-inline: 8px; }
.fact-grid { margin-inline: 8px; }
.evidence-summary { display: grid; }
.disposition-actions { grid-template-columns: 1fr; }
}
@media (prefers-reduced-motion: reduce) { *, *::before, *::after { animation-duration: .01ms !important; animation-iteration-count: 1 !important; transition-duration: .01ms !important; scroll-behavior: auto !important; } }
</style>
</head>
<body>
<svg aria-hidden="true" width="0" height="0" style="position:absolute">
<symbol id="i-inbox" viewBox="0 0 24 24"><path d="M4 4h16v16H4Z"/><path d="m4 14 5-1 2 3h2l2-3 5 1"/></symbol>
<symbol id="i-event" viewBox="0 0 24 24"><path d="M6 3h12v18H6z"/><path d="M9 8h6m-6 4h6m-6 4h4"/></symbol>
<symbol id="i-rule" viewBox="0 0 24 24"><path d="M4 6h7m6 0h3M4 12h3m6 0h7M4 18h9m6 0h1"/><circle cx="14" cy="6" r="2"/><circle cx="10" cy="12" r="2"/><circle cx="16" cy="18" r="2"/></symbol>
<symbol id="i-phone" viewBox="0 0 24 24"><path d="M5 4h4l2 5-3 2a16 16 0 0 0 5 5l2-3 5 2v4c-8 2-17-7-15-15Z"/></symbol>
<symbol id="i-chart" viewBox="0 0 24 24"><path d="M4 20V9m6 11V4m6 16v-7m4 7H2"/></symbol>
<symbol id="i-shield" viewBox="0 0 24 24"><path d="m12 3 8 3v6c0 5-3 8-8 9-5-1-8-4-8-9V6Z"/><path d="m9 12 2 2 4-5"/></symbol>
<symbol id="i-search" viewBox="0 0 24 24"><circle cx="11" cy="11" r="7"/><path d="m20 20-4-4"/></symbol>
<symbol id="i-sun" viewBox="0 0 24 24"><circle cx="12" cy="12" r="4"/><path d="M12 2v2m0 16v2M4.9 4.9l1.4 1.4m11.4 11.4 1.4 1.4M2 12h2m16 0h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></symbol>
<symbol id="i-bell" viewBox="0 0 24 24"><path d="M18 8a6 6 0 0 0-12 0c0 7-3 7-3 9h18c0-2-3-2-3-9"/><path d="M10 21h4"/></symbol>
<symbol id="i-check" viewBox="0 0 24 24"><path d="m5 12 4 4L19 6"/></symbol>
<symbol id="i-alert" viewBox="0 0 24 24"><path d="M12 3 2 20h20Z"/><path d="M12 9v4m0 3v.01"/></symbol>
<symbol id="i-play" viewBox="0 0 24 24"><path d="m8 5 11 7-11 7Z"/></symbol>
<symbol id="i-expand" viewBox="0 0 24 24"><path d="M8 3H3v5m13-5h5v5M8 21H3v-5m13 5h5v-5"/></symbol>
<symbol id="i-download" viewBox="0 0 24 24"><path d="M12 3v12m0 0 5-5m-5 5-5-5M4 20h16"/></symbol>
<symbol id="i-lock" viewBox="0 0 24 24"><rect x="4" y="10" width="16" height="11" rx="2"/><path d="M8 10V7a4 4 0 0 1 8 0v3"/></symbol>
<symbol id="i-clock" viewBox="0 0 24 24"><circle cx="12" cy="12" r="9"/><path d="M12 7v6l4 2"/></symbol>
<symbol id="i-more" viewBox="0 0 24 24"><circle cx="5" cy="12" r="1"/><circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/></symbol>
</svg>
<div class="prototype-banner">PROTOTYPE - 仅供枚举交互，非实现依据</div>
<div class="app">
<aside class="sidebar" aria-label="Bell 主导航">
<div class="brand"><div class="brand-mark">Y</div><div class="brand-copy"><strong>YoVision</strong><small>Bell · Duty Console</small></div></div>
<div class="nav-label">值班与业务</div>
<nav class="nav">
<button data-view="duty" aria-current="page"><svg class="icon"><use href="#i-inbox"/></svg><span>值班台</span><span class="count">6</span></button>
<button data-view="events"><svg class="icon"><use href="#i-event"/></svg><span>事件中心</span></button>
<button data-view="rules"><svg class="icon"><use href="#i-rule"/></svg><span>规则策略</span></button>
<button data-view="chains"><svg class="icon"><use href="#i-phone"/></svg><span>升级链</span></button>
<button data-view="reports"><svg class="icon"><use href="#i-chart"/></svg><span>运营报表</span></button>
</nav>
<div class="nav-label">管理</div>
<nav class="nav">
<button data-view="sites"><svg class="icon"><use href="#i-rule"/></svg><span>站点与 Area</span></button>
<button data-view="audit"><svg class="icon"><use href="#i-shield"/></svg><span>审计日志</span></button>
</nav>
<div class="shift-card"><strong>安保值班组 · 白班</strong><span>08:00–20:00 · 4 人在线</span><div class="shift-bar"><i></i></div></div>
</aside>
<main class="main" id="main-content" tabindex="-1">
<header class="topbar">
<div class="site"><strong>青藤教育集团 · 青藤寄宿学校</strong><span>当前账号：林工 · 租户管理员 · Asia/Shanghai</span></div>
<div class="top-actions">
<select class="select" id="stateSelect" aria-label="原型状态演示"><option value="normal">正常状态</option><option value="loading">加载中</option><option value="weak">弱网 / 证据失败</option><option value="empty">队列为空</option><option value="denied">无权限</option><option value="expired">会话已过期</option></select>
<button class="btn mobile-manage" id="mobileManage" aria-haspopup="dialog">管理</button>
<button class="btn icon-btn" id="themeToggle" aria-label="切换明暗主题" title="切换明暗主题"><svg class="icon"><use href="#i-sun"/></svg></button>
<button class="btn icon-btn" aria-label="查看通知" title="查看通知"><svg class="icon"><use href="#i-bell"/></svg></button>
</div>
</header>
<div class="content">
<section class="state-layer" id="stateLayer" aria-live="polite"></section>
<section class="view active" data-page="duty">
<div class="page-head"><div><h1>实时值班台</h1><p>先确认高危预警，再查看证据与升级状态；重复投递不会生成重复处置。</p></div><div class="page-actions"><span class="badge success">值班组在线</span><button class="btn" id="handoverButton">发起交接班</button><button class="btn" id="muteButton">限时静默</button></div></div>
<div class="duty-grid">
<section class="card queue" aria-label="待处置预警队列">
<div class="card-head"><h2>待处置预警</h2><span class="badge danger">6 个未 ack</span></div>
<div class="queue-head"><div class="queue-tabs" aria-label="预警队列筛选"><button class="active" aria-pressed="true">全部 9</button><button aria-pressed="false">高危 3</button><button aria-pressed="false">我的 2</button></div></div>
<div class="alert-list" id="alertList"></div>
</section>
<section class="card evidence" aria-label="事件事实与证据">
<div class="evidence-summary"><div><span class="badge danger" id="selectedSeverity">高危 · S1</span><h2 id="selectedTitle">危险区域闯入</h2><p id="selectedMeta">北围墙 01 · 23:14:08 · EVT-01J8…7A2</p></div><button class="btn icon-btn" aria-label="更多事件操作"><svg class="icon"><use href="#i-more"/></svg></button></div>
<div class="evidence-tabs" aria-label="证据类型筛选"><button class="active" aria-pressed="true">视频片段</button><button aria-pressed="false">抓拍 2</button><button aria-pressed="false">结构化事实</button></div>
<div class="video-stage" id="videoStage">
<svg viewBox="0 0 960 540" role="img" aria-label="北围墙 01 事件视频模拟画面，匿名目标进入危险区域">
<defs><linearGradient id="bellSky" x1="0" y1="0" x2="0" y2="1"><stop stop-color="#102337"/><stop offset="1" stop-color="#060a11"/></linearGradient><pattern id="bellScan" width="8" height="8" patternUnits="userSpaceOnUse"><path d="M0 8h8" stroke="#fff" stroke-opacity=".035"/></pattern></defs>
<rect width="960" height="540" fill="url(#bellSky)"/><path d="M0 340 180 260 355 316 520 232 690 306 830 230 960 285V540H0Z" fill="#142638"/><rect y="414" width="960" height="126" fill="#111820"/><path d="M0 416h960M0 474h960" stroke="#6d8496" stroke-opacity=".48"/><path d="M150 305v235m250-240v240m280-255v255m170-280v280" stroke="#758b9d" stroke-width="4"/><polygon points="92,362 305,318 558,342 525,480 126,478" fill="#fb7185" fill-opacity=".15" stroke="#fb7185" stroke-width="4" stroke-dasharray="10 7"/><rect x="354" y="330" width="63" height="148" fill="none" stroke="#fbbf24" stroke-width="4"/><text x="354" y="319" fill="#ffe18a" font-size="17">person · 0.92</text><circle cx="385" cy="310" r="24" fill="none" stroke="#fbbf24" stroke-width="4"/><rect width="960" height="540" fill="url(#bellScan)"/><text x="26" y="38" fill="#d6e8f5" font-size="18">北围墙 01 · 事件片段</text><text x="26" y="66" fill="#91a6b8" font-size="14">事发前 8s · 事发后 12s · 匿名目标</text>
</svg>
<div class="video-controls"><button aria-label="播放片段"><svg class="icon"><use href="#i-play"/></svg></button><span class="mono">00:11 / 00:20</span><div class="timeline-bar"><i></i></div><button aria-label="全屏查看"><svg class="icon"><use href="#i-expand"/></svg></button><button aria-label="下载授权证据"><svg class="icon"><use href="#i-download"/></svg></button></div>
</div>
<div class="fact-grid">
<div class="fact"><span>规则</span><strong id="factRule">非授权人员进入</strong></div><div class="fact"><span>置信度</span><strong>0.92</strong></div><div class="fact"><span>持续时间</span><strong>8.4s</strong></div><div class="fact"><span>证据状态</span><strong style="color:var(--success)">已校验</strong></div>
</div>
<div class="relation-panel"><h3>关联事件 · <span id="relatedEventCount">2</span></h3><div class="relation-list" id="relatedEvents"></div></div>
<div class="privacy-note"><svg class="icon"><use href="#i-lock"/></svg><span>仅显示与本事件关联的 20 秒证据。常态录像仍在客户 NVR，本页不暴露流地址或摄像头凭据。</span></div>
</section>
<aside class="card action-panel" aria-label="预警确认与处置">
<div class="card-head"><h2>处置与升级</h2><span class="badge warning" id="ackState">等待 ack</span></div>
<div class="action-scroll">
<div class="ack-box"><button class="btn btn-primary" id="ackButton"><svg class="icon"><use href="#i-check"/></svg>确认接手</button><p id="ackHelp">一次点击确认；并发确认时会显示实际接手人，不覆盖对方结果。</p><div class="ack-tools"><button class="text-button" id="simulateAckConflict">演示另一值班员抢先 ack</button></div><div class="inline-alert" id="ackConflict" role="alert" hidden></div></div>
<div><div class="countdown"><svg class="icon" style="color:var(--warning);width:26px;height:26px"><use href="#i-clock"/></svg><div><strong id="countdown">01:42</strong><span>未 ack 将升级到校级负责人</span></div></div>
<div class="escalation"><h3>投递时间线</h3>
<div class="step done"><i class="step-dot"></i><strong>值班室 Web + 本地声光</strong><div class="delivery-facts"><span>已发出 23:14:10</span><span>已送达 23:14:11</span><span>已看到 23:14:31</span></div></div>
<div class="step current"><i class="step-dot"></i><strong>值班员短信 · 可重试</strong><div class="delivery-facts"><span>已发出 23:14:13</span><span style="color:var(--warning)">未收到送达回执 · 已等待 42 秒</span><span>通道不支持“已看到” · 重试 2/3，23:15:25</span></div></div>
<div class="step"><i class="step-dot"></i><strong>校级负责人语音</strong><div class="delivery-facts"><span>预计 23:16:10 · 尚未发送</span><span>号码无效将标记最终失败，不继续伪装送达</span></div></div>
</div>
</div>
<div class="disposition"><label for="outcome">处置结果</label><select class="select" id="outcome"><option value="">待选择</option><option>已现场核查，无人员受伤</option><option>已通知安保人员处理</option><option>已转交校方负责人</option></select><label for="note">处置备注</label><textarea class="textarea" id="note" placeholder="记录已采取的动作，不改写原始事件事实"></textarea><div class="disposition-actions"><button class="btn btn-danger" id="falsePositive">标记误报</button><button class="btn btn-success" id="completeAlert">完成处置</button></div></div>
</div>
</aside>
</div>
</section>
<section class="view" data-page="events">
<div class="page-head"><div><h1>事件中心</h1><p>事件是不可变事实；预警与处置结果作为关联记录单独展示。</p></div><div class="page-actions"><button class="btn"><svg class="icon"><use href="#i-download"/></svg>导出筛选结果</button></div></div>
<div class="grid stats">
<article class="card stat"><span>今日事件</span><strong>47</strong><span class="muted">较昨日 -8%</span></article><article class="card stat"><span>已触发预警</span><strong>18</strong><span class="muted">规则命中后独立创建</span></article><article class="card stat"><span>误报反馈</span><strong>5</strong><span class="muted">进入标注队列</span></article><article class="card stat"><span>证据可用率</span><strong>97.9%</strong><span class="muted">1 个片段可重试</span></article>
</div>
<article class="card"><div class="card-head"><div class="toolbar"><div class="search"><svg class="icon"><use href="#i-search"/></svg><input class="field" aria-label="搜索事件" placeholder="事件编号、点位或规则"></div><select class="select" aria-label="严重度筛选"><option>全部严重度</option><option>S1 高危</option><option>S2 重要</option></select><select class="select" aria-label="结果筛选"><option>全部结果</option><option>已处置</option><option>误报</option></select></div><span class="muted">共 47 条</span></div><div class="table-wrap"><table><thead><tr><th>事件编号</th><th>时间</th><th>点位</th><th>规则</th><th>事实</th><th>预警</th><th>结果</th><th>证据</th></tr></thead><tbody id="eventRows"></tbody></table></div><div class="pager"><span id="eventPageSummary">第 1 / 16 页 · 每页 3 条</span><div class="pager-actions"><button class="btn" id="eventPrev">上一页</button><button class="btn" id="eventNext">下一页</button></div></div></article>
</section>
<section class="view" data-page="rules">
<div class="rule-context" id="ruleContext" hidden><p><strong>已带入摄像头与区域上下文：</strong><span id="ruleContextCamera">北围墙 01</span> · <span id="ruleContextZone">ZONE-007</span>，可继续完成规则草稿。</p><button class="btn btn-primary" id="continueRuleDraft">继续配置</button></div>
<div class="page-head"><div><h1>规则策略</h1><p>Bell 管理场景、范围、时段、持续时间、试运行与发布；检测区域来自对应摄像头的版本化空间配置。</p></div><div class="page-actions"><button class="btn btn-primary" id="openRuleDialog">新建规则</button></div></div>
<div class="grid rule-grid">
<article class="card rule-card"><div class="rule-card-top"><span class="badge success" id="publishedRuleBadge">正式生效 · v7</span><button class="btn btn-quiet icon-btn" aria-label="更多操作"><svg class="icon"><use href="#i-more"/></svg></button></div><h2>非授权人员进入</h2><p>危险区域 × 全天 × 持续 3 秒</p><dl><dt>覆盖范围</dt><dd>4 个点位</dd><dt>检测区域</dt><dd>北围墙危险区域 v7</dd><dt>继承来源</dt><dd>站点模板</dd><dt>今日命中</dt><dd>8</dd></dl><div class="rule-card-actions"><button class="btn" data-edit-rule>编辑规则</button><button class="btn" id="openRollback">版本历史 / 回滚</button><a class="btn" href="../sense/index.html?view=device-detail&amp;camera=CAM-S2-001&amp;zone=ZONE-007&amp;return_to=bell-rule">校准检测区域</a></div></article>
<article class="card rule-card"><div class="rule-card-top"><span class="badge warning" id="trialBadge">试运行</span><button class="btn btn-quiet icon-btn" aria-label="更多操作"><svg class="icon"><use href="#i-more"/></svg></button></div><h2>区域内聚集</h2><p>人数 ≥ 6 × 持续 20 秒 × 夜间</p><dl><dt>覆盖范围</dt><dd>3 个点位</dd><dt>检测区域</dt><dd>3 个区域版本</dd><dt>继承来源</dt><dd>设备覆盖</dd><dt>样本命中</dt><dd>14</dd></dl><div class="rule-card-actions"><button class="btn" data-edit-rule>查看试运行</button><button class="btn btn-primary" id="publishTrialRule">正式发布</button></div></article>
<article class="card rule-card"><div class="rule-card-top"><span class="badge violet">草稿</span><button class="btn btn-quiet icon-btn" aria-label="更多操作"><svg class="icon"><use href="#i-more"/></svg></button></div><h2>方向越线</h2><p>警戒线 A → B × 上学时段</p><dl><dt>覆盖范围</dt><dd>1 个点位</dd><dt>检测区域</dt><dd>宿舍东通道 · 警戒线 v3</dd><dt>继承来源</dt><dd>设备草稿</dd><dt>最近修改</dt><dd>2h 前</dd></dl><div class="rule-card-actions"><button class="btn" data-edit-rule>继续编辑</button><a class="btn" href="../sense/index.html?view=device-detail&amp;camera=CAM-S2-011&amp;zone=ZONE-011&amp;return_to=bell-rule">查看警戒线</a></div></article>
</div>
</section>
<section class="view" data-page="chains">
<div class="page-head"><div><h1>升级链</h1><p>联系人、值班排班和升级策略统一设计、分对象管理；策略引用动态目标，不写死手机号。</p></div><div class="page-actions"><span class="badge success">当前排班覆盖完整</span></div></div>
<div class="chain-subnav" aria-label="升级链二级模块"><button class="active" data-chain-section="strategy" aria-pressed="true">升级策略</button><button data-chain-section="roster" aria-pressed="false">值班与排班</button><button data-chain-section="contacts" aria-pressed="false">联系人和通道</button></div>
<section class="chain-panel active" data-chain-panel="strategy">
<div class="grid chain-grid"><article class="card"><div class="card-head"><div><h2>校园高危事件 · 默认链</h2><span class="muted">每一步引用类型化目标，解析后才创建投递</span></div><span class="badge success">已发布 v4</span></div>
<div class="chain-row"><div class="chain-num">1</div><div><strong>值班室 Web + 本地声光</strong><small>立即 · 站点局域网内</small><span class="target-ref">team:DUTY-ROOM</span></div><span class="badge success">固定值班组</span></div>
<div class="chain-row"><div class="chain-num">2</div><div><strong>当前排班值班员 · 短信</strong><small>立即 · 送达后等待 2 分钟</small><span class="target-ref">on_call_schedule:SCH-CAMPUS-SECURITY@v12</span></div><span class="badge info">动态排班</span></div>
<div class="chain-row"><div class="chain-num">3</div><div><strong>校级负责人 · 语音</strong><small>未 ack 时升级 · 等待 3 分钟</small><span class="target-ref">person:USR-SCHOOL-LEAD</span></div><span class="badge warning">指定人员</span></div>
<div class="object-note">升级策略只保存目标引用和通道偏好，不复制联系人号码或轮换字段。</div>
</article><article class="card resolve-card"><div class="card-head" style="padding:0 0 11px;margin-bottom:12px"><div><h2>目标解析预览</h2><span class="muted">事件时间 2026-08-04 23:14 · Asia/Shanghai</span></div><button class="btn" id="editEscalation">编辑策略</button></div><div class="resolve-list"><div class="resolve-item"><span>排班目标</span><strong>校园安保值班表 · v12</strong><small class="mono">SCH-CAMPUS-SECURITY</small></div><div class="resolve-item"><span>当前解析结果</span><strong id="resolvedPerson">王值班员 · 晚班</strong><small>短信已验证 · 语音已验证</small></div><div class="resolve-item"><span>投递快照</span><strong>23:14:13 已固化</strong><small>收件人、通道、排班 v12；后续编辑不改写本次事实</small></div></div></article></div>
<div class="grid chain-grid" style="margin-top:12px"><article class="card"><div class="card-head"><h2>解析与版本规则</h2><span class="badge info">不可变历史</span></div><div class="card-body"><p class="muted">每次投递创建时按站点时区解析当时生效的排班版本，并保存实际收件人、通道与版本快照。未来排班版本只影响其生效时间后的新投递。</p></div></article><article class="card"><div class="card-head"><h2>静默规则</h2><span class="badge info">无永久选项</span></div><div class="card-body"><label for="muteDuration" class="muted">维护窗口</label><select id="muteDuration" class="select" style="margin-top:6px"><option>30 分钟</option><option>1 小时</option><option>2 小时</option><option>4 小时（上限）</option></select><p class="muted">静默仅影响选定规则和点位，到时自动恢复；S1 事件不可静默。</p><button class="btn">创建维护窗口</button></div></article></div>
</section>
<section class="chain-panel" data-chain-panel="roster">
<div class="grid stats"><article class="card stat"><span>当前排班</span><strong id="scheduleVersion">v12</strong><span class="muted">已发布 · 08-01 生效</span></article><article class="card stat"><span>站点时区</span><strong style="font-size:18px">Asia/Shanghai</strong><span class="muted">跨午夜班次按站点时间</span></article><article class="card stat"><span>当前值班</span><strong style="font-size:18px">王值班员</strong><span class="muted">晚班 · 至明日 08:00</span></article><article class="card stat"><span>未来 14 天覆盖</span><strong>100%</strong><span class="muted">0 空档 · 0 重叠</span></article></div>
<article class="card"><div class="card-head"><div><h2>校园安保值班表</h2><span class="muted">周轮换 · 白班 08:00–20:00 / 晚班 20:00–08:00</span></div><div class="page-actions"><button class="btn" id="simulateRosterConflict">演示冲突检查</button><button class="btn" id="openSubstitute">临时替班</button><button class="btn btn-primary" id="openSchedulePublish">发布新版本</button></div></div><div class="inline-alert danger" id="rosterConflict" role="alert" hidden style="margin:12px 12px 0"></div><div class="roster-week">
<div class="roster-day current"><strong>今天 · 周二</strong><div class="shift-slot"><span>白班</span><strong>林值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong id="currentNightShift">王值班员</strong><small>20:00–08:00</small></div></div>
<div class="roster-day"><strong>周三</strong><div class="shift-slot"><span>白班</span><strong>赵值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong id="wednesdayNightShift">周值班员</strong><small>20:00–08:00</small></div></div>
<div class="roster-day"><strong>周四</strong><div class="shift-slot"><span>白班</span><strong>林值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong>王值班员</strong><small>20:00–08:00</small></div></div>
<div class="roster-day"><strong>周五</strong><div class="shift-slot"><span>白班</span><strong>赵值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong>周值班员</strong><small>20:00–08:00</small></div></div>
<div class="roster-day"><strong>周六</strong><div class="shift-slot"><span>白班</span><strong>林值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong>王值班员</strong><small>20:00–08:00</small></div></div>
<div class="roster-day"><strong>周日</strong><div class="shift-slot"><span>白班</span><strong>赵值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong>周值班员</strong><small>20:00–08:00</small></div></div>
<div class="roster-day"><strong>下周一</strong><div class="shift-slot"><span>白班</span><strong>林值班员</strong><small>08:00–20:00</small></div><div class="shift-slot"><span>晚班</span><strong>王值班员</strong><small>20:00–08:00</small></div></div>
</div><div class="object-note"><strong>边界：</strong>临时替班进入新排班草稿并经发布后影响未来班次；值班交接只转移进行中 Alert 的责任，不会暗改这里的轮换。</div></article>
<article class="card" style="margin-top:12px"><div class="card-head"><h2>版本与例外</h2><span class="badge info">全量审计</span></div><div class="table-wrap"><table><thead><tr><th>版本</th><th>生效时间</th><th>变更</th><th>状态</th><th>发布人</th></tr></thead><tbody><tr><td>v12</td><td>2026-08-01 00:00</td><td>暑期周轮换</td><td><span class="badge success">当前生效</span></td><td>林工</td></tr><tr><td>v11</td><td>2026-07-01 00:00</td><td>赵值班员加入白班组</td><td><span class="badge">历史</span></td><td>周管理员</td></tr></tbody></table></div></article>
</section>
<section class="chain-panel" data-chain-panel="contacts">
<div class="grid contact-summary"><article class="card stat"><span>联系人</span><strong id="contactCount">6</strong><span class="muted">4 名值班员 · 2 名负责人</span></article><article class="card stat"><span>已验证通道</span><strong>11 / 12</strong><span class="muted">1 个语音号码待验证</span></article><article class="card stat"><span>被排班引用</span><strong>4</strong><span class="muted">删除前必须解除引用</span></article></div>
<article class="card"><div class="card-head"><div><h2>联系人和通知通道</h2><span class="muted">只维护身份、角色、值班组和通道；班次与轮换在排班模块维护</span></div><button class="btn btn-primary" id="openContact">新建联系人</button></div><div class="table-wrap"><table><thead><tr><th>联系人</th><th>角色</th><th>值班组</th><th>通知通道</th><th>排班引用</th><th>状态</th><th>操作</th></tr></thead><tbody><tr><td><strong>王值班员</strong><br><span class="mono muted">USR-DUTY-WANG</span></td><td>值班员</td><td>校园安保组</td><td>短信 ✓ · 语音 ✓ · Web ✓</td><td>SCH-CAMPUS-SECURITY</td><td><span class="badge success">可用</span></td><td><button class="btn" data-edit-contact="wang">编辑</button></td></tr><tr><td><strong>林值班员</strong><br><span class="mono muted">USR-DUTY-LIN</span></td><td>值班员</td><td>校园安保组</td><td>短信 ✓ · Web ✓</td><td>SCH-CAMPUS-SECURITY</td><td><span class="badge success">可用</span></td><td><button class="btn" data-edit-contact="lin">编辑</button></td></tr><tr><td><strong>校级负责人</strong><br><span class="mono muted">USR-SCHOOL-LEAD</span></td><td>站点负责人</td><td>校级负责人组</td><td>短信 ✓ · 语音待验证</td><td>升级策略 v4</td><td><span class="badge warning">部分可用</span></td><td><button class="btn" data-edit-contact="lead">编辑</button></td></tr></tbody></table></div><div class="object-note">联系人通道变更只影响后续新投递；已创建投递保留当时的收件人和通道快照。联系人被排班或策略引用时不能直接删除。</div></article>
</section>
</section>
<section class="view" data-page="reports">
<div class="page-head"><div><h1>运营报表</h1><p>算法效果和系统 SLA 分开统计；图表同时提供表格导出。</p></div><div class="page-actions"><button class="btn"><svg class="icon"><use href="#i-download"/></svg>导出 CSV</button></div></div>
<div class="grid chart-grid"><article class="card chart"><h2>近 7 日预警量</h2><p>按站点日期汇总；可切换到每路每天误报数。</p><div class="bars" role="img" aria-label="近七日预警量依次为 18、22、15、31、27、24、19"><div class="bar" style="--h:58%"><span>周一</span></div><div class="bar" style="--h:70%"><span>周二</span></div><div class="bar" style="--h:48%"><span>周三</span></div><div class="bar" style="--h:100%"><span>周四</span></div><div class="bar" style="--h:87%"><span>周五</span></div><div class="bar" style="--h:77%"><span>周六</span></div><div class="bar" style="--h:61%"><span>周日</span></div></div></article><article class="card chart"><h2>处置结果</h2><p>本月已闭环事件。</p><div class="donut" role="img" aria-label="正常处置 61%，误报 22%，升级未闭环 17%"></div><div class="legend"><span><i style="background:var(--success)"></i>正常处置 61%</span><span><i style="background:var(--warning)"></i>误报 22%</span><span><i style="background:var(--danger)"></i>未闭环 17%</span></div></article></div>
<article class="card" style="margin-top:12px"><div class="card-head"><div><h2>规则验收效果</h2><span class="muted">冻结样本窗口：2026-07-01～2026-07-31 · 现场复核集 v3</span></div><button class="btn">导出验收附件</button></div><div class="table-wrap"><table><thead><tr><th>规则版本</th><th>样本窗口</th><th>正样本 / 漏检</th><th>召回率</th><th>通道天数</th><th>误报数</th><th>每路每天误报数</th></tr></thead><tbody><tr><td>非授权人员进入 · v7</td><td>07-01～07-31</td><td>186 / 8</td><td><strong>95.7%</strong></td><td>496</td><td>19</td><td><strong>0.038</strong></td></tr><tr><td>区域内聚集 · v4 试运行</td><td>07-15～07-31</td><td>72 / 6</td><td><strong>91.7%</strong></td><td>272</td><td>16</td><td><strong>0.059</strong></td></tr></tbody></table></div><p class="metric-note"><strong>口径说明：</strong>按规则版本分别报告召回率与每路每天误报数；不提供跨场景统一“准确率”。样本量和冻结窗口随导出保留。</p></article>
</section>
<section class="view" data-page="sites">
<div class="page-head"><div><h1>站点与 Area</h1><p>Bell 是 Tenant、Site、Area、配额与隐私准入策略的唯一真相源；Sense 只消费版本化投影。</p></div><div class="page-actions"><button class="btn">管理角色权限</button><button class="btn btn-primary" id="newSite">新建站点</button></div></div>
<div class="grid stats"><article class="card stat"><span>租户</span><strong>1</strong><span class="muted">青藤教育集团</span></article><article class="card stat"><span>站点</span><strong>2</strong><span class="muted">1 个试点中</span></article><article class="card stat"><span>视频配额</span><strong>16 / 128</strong><span class="muted">默认 16，不是硬上限</span></article><article class="card stat"><span>策略投影</span><strong>v42</strong><span class="muted">Sense 2 分钟前已同步</span></article></div>
<div class="grid site-grid"><article class="card"><div class="card-head"><h2>站点</h2><button class="btn btn-quiet">筛选</button></div><div class="site-list"><button class="site-item active"><span><strong>青藤寄宿学校</strong><small>site-ivy · S2 校园包</small></span><span class="badge success">启用</span></button><button class="site-item"><span><strong>城东试验点</strong><small>site-east · 未绑定场景包</small></span><span class="badge warning">准备中</span></button></div></article>
<article class="card"><div class="card-head"><div><h2>青藤寄宿学校 · Area</h2><span class="muted">层级、报表口径和设备准入共用同一逻辑 ID</span></div><button class="btn btn-primary" id="newArea">新建 Area</button></div><div class="policy-note"><strong>策略变更不会静默处置已有设备。</strong> 若改为“仅非成像”且 Area 内已有摄像头，必须显式迁移设备或取消变更。</div><div class="table-wrap"><table><thead><tr><th>Area</th><th>父级</th><th>capture_policy</th><th>设备</th><th>策略版本</th><th>投影状态</th><th>操作</th></tr></thead><tbody><tr><td><strong>北围墙</strong><br><span class="muted">area-north-wall</span></td><td>校园</td><td><span class="badge success">允许成像</span></td><td>4 视频</td><td>v42</td><td><span class="badge success">已同步</span></td><td><button class="btn" data-edit-area="north">编辑策略</button></td></tr><tr><td><strong>宿舍卧室</strong><br><span class="muted">area-dorm-room</span></td><td>宿舍楼</td><td><span class="badge warning">仅非成像</span></td><td>0 视频 · 1 雷达规划</td><td>v38</td><td><span class="badge success">已同步</span></td><td><button class="btn" data-edit-area="dorm">编辑策略</button></td></tr><tr><td><strong>实验楼入口</strong><br><span class="muted">area-lab-gate</span></td><td>实验楼</td><td><span class="badge success">允许成像</span></td><td>2 视频</td><td>v41</td><td><span class="badge warning">待 Sense 拉取</span></td><td><button class="btn" data-edit-area="lab">编辑策略</button></td></tr></tbody></table></div></article></div>
</section>
<section class="view" data-page="audit">
<div class="context-strip" id="auditContext" hidden><p><strong>来自 Sense 设备日志：</strong>租户 <span id="auditTenant">—</span> · 站点 <span id="auditSite">—</span> · 设备 <span id="auditDevice">—</span>。已锁定筛选上下文。</p><a class="btn" id="auditReturn" href="../sense/index.html?view=device-detail">返回设备详情 ↗</a></div>
<div class="page-head"><div><h1>审计日志</h1><p>查询、ack、规则发布和证据下载均可追溯；不记录密码与可复用连接串。</p></div><div class="page-actions"><button class="btn">导出审计记录</button></div></div>
<article class="card"><div class="card-head"><div class="search"><svg class="icon"><use href="#i-search"/></svg><input class="field" id="auditSearch" aria-label="搜索审计日志" placeholder="操作、角色或对象编号"></div><span class="badge info">只读</span></div><div class="table-wrap"><table><thead><tr><th>时间</th><th>角色</th><th>动作</th><th>对象</th><th>结果</th><th>来源</th></tr></thead><tbody id="auditRows"></tbody></table></div><div class="pager"><span id="auditPageSummary">第 1 / 28 页 · 每页 3 条</span><div class="pager-actions"><button class="btn" id="auditPrev">上一页</button><button class="btn" id="auditNext">下一页</button></div></div></article>
</section>
</div>
</main>
</div>
<nav class="mobile-nav" aria-label="移动端主导航"><button class="active" data-view="duty">值班</button><button data-view="events">事件</button><button data-view="rules">规则</button><button data-view="chains">升级</button><button data-view="reports">报表</button></nav>
<dialog id="ruleDialog" aria-labelledby="ruleTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="ruleTitle">配置告警规则</h2><span class="muted">规则草稿 · 尚未正式生效</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭对话框">×</button></div><div class="dialog-body"><div class="form-grid">
<div class="form-field"><label for="ruleScene">场景模板</label><select id="ruleScene" class="select"><option>非授权人员进入</option><option>区域内聚集</option><option>方向越线</option></select></div>
<div class="form-field"><label for="ruleScope">继承与覆盖</label><select id="ruleScope" class="select"><option>当前设备覆盖</option><option>继承站点模板</option><option>覆盖站点模板</option></select></div>
<div class="form-field"><label for="ruleCamera">摄像头</label><select id="ruleCamera" class="select"><option value="CAM-S2-001">北围墙 01</option><option value="CAM-S2-006">实验楼入口 02</option><option value="CAM-S2-011">宿舍东通道</option></select></div>
<div class="form-field"><label for="ruleZone">检测区域</label><select id="ruleZone" class="select"><option value="ZONE-007">北围墙危险区域 · v7</option><option value="ZONE-011">北围墙方向警戒线 · v3</option></select></div>
<div class="linked-zone"><span><strong>空间坐标由摄像头详情维护</strong><small>区域版本变化不会绕过规则试运行或自动正式发布。</small></span><a class="btn" id="editRuleZone" href="../sense/index.html?view=device-detail&amp;camera=CAM-S2-001&amp;zone=ZONE-007&amp;return_to=bell-rule">编辑检测区域</a></div>
<div class="form-field"><label for="ruleSchedule">生效时段</label><select id="ruleSchedule" class="select"><option>全天</option><option>夜间 22:00–06:00</option><option>自定义课表</option></select></div>
<div class="form-field"><label for="ruleDuration">持续时间</label><select id="ruleDuration" class="select"><option>超过 3 秒</option><option>立即</option><option>超过 10 秒</option><option>超过 20 秒</option></select></div>
<div class="form-field full"><label><input id="startDryRun" type="checkbox" checked aria-label="保存后开始试运行"> 保存后开始试运行，不触发正式预警</label></div>
<div class="inline-alert danger form-field full" id="ruleConflict" role="alert" hidden><strong>规则已由周管理员发布为 v8。</strong><br>当前草稿基于 v7，不能覆盖。请刷新到 v8 后重新合并，或另存为新草稿。</div>
<p class="workflow-note">产品流程：先确认摄像头和检测区域，再配置业务条件；试运行样本达到现场评审要求后，才允许正式发布。</p>
</div></div><div class="dialog-foot"><button type="button" class="btn" id="simulateRuleConflict">演示版本冲突</button><button class="btn" value="cancel">取消</button><button class="btn btn-primary" id="saveRuleDraft" value="default">保存并开始试运行</button></div></form></dialog>
<dialog id="falseDialog" aria-labelledby="falseTitle"><form method="dialog"><div class="dialog-head"><h2 id="falseTitle">标记为误报</h2><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭对话框">×</button></div><div class="dialog-body"><p>这只会追加事件 outcome，不会修改原始事件事实和证据。</p><div class="form-grid"><div class="form-field full"><label for="falseReason">误报原因</label><select id="falseReason" class="select" required><option value="">请选择</option><option>区域配置不准确</option><option>目标分类错误</option><option>时段策略不准确</option><option>其他</option></select></div><div class="form-field full"><label for="falseNote">补充说明（可选）</label><textarea id="falseNote" class="textarea" placeholder="便于算法团队归因，不填写真实个人信息"></textarea></div><div class="form-field full"><label><input type="checkbox" checked> 进入标注复核队列</label></div></div></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button class="btn btn-danger" id="confirmFalse" value="default">确认标记</button></div></form></dialog>
<dialog id="muteDialog" aria-labelledby="muteTitle"><form method="dialog"><div class="dialog-head"><h2 id="muteTitle">创建限时静默</h2><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭对话框">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="muteScope">影响范围</label><select id="muteScope" class="select"><option>北围墙 01 · 当前规则</option><option>北围墙区域</option></select></div><div class="form-field"><label for="muteTime">持续时间</label><select id="muteTime" class="select"><option>30 分钟</option><option>1 小时</option><option>2 小时</option><option>4 小时（上限）</option></select></div><div class="form-field full"><label for="muteCause">原因</label><textarea id="muteCause" class="textarea" required placeholder="例如：现场施工维护，已安排人工巡查"></textarea></div></div><p class="muted">到期自动恢复；S1 高危事件与设备离线运维告警不受此静默影响。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button class="btn btn-primary" id="confirmMute" value="default">确认并记录审计</button></div></form></dialog>
<dialog id="areaDialog" aria-labelledby="areaTitle"><form method="dialog"><div class="dialog-head"><h2 id="areaTitle">编辑 Area 准入策略</h2><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭对话框">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="areaName">Area</label><input id="areaName" class="field" value="北围墙"></div><div class="form-field"><label for="areaParent">父级</label><select id="areaParent" class="select"><option>校园</option><option>教学区</option><option>宿舍楼</option></select></div><div class="form-field full"><label for="areaPolicy">capture_policy</label><select id="areaPolicy" class="select"><option value="video_allowed">允许成像设备</option><option value="non_imaging_only">仅允许非成像设备</option></select></div><div class="form-field full"><label for="areaReason">变更原因</label><textarea id="areaReason" class="textarea" placeholder="必填，进入全局审计"></textarea></div></div><p class="muted">保存生成新策略版本；Sense 投影同步前会显示旧版本，不允许绕过后端准入检查。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-primary" id="saveAreaPolicy">保存策略版本</button></div></form></dialog>
<dialog id="policyConflictDialog" aria-labelledby="policyConflictTitle"><form method="dialog"><div class="dialog-head"><h2 id="policyConflictTitle">策略与已有设备冲突</h2><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭对话框">×</button></div><div class="dialog-body"><p>北围墙当前有 4 台成像设备。改为“仅非成像”前必须选择显式处置；系统不会自动停用、移动或保留违规设备。</p><label class="radio-card"><input type="radio" name="conflictAction" value="move"> <strong>先迁移 4 台设备到允许成像的 Area</strong><br><span class="muted">创建迁移任务，全部成功后再发布策略。</span></label><label class="radio-card"><input type="radio" name="conflictAction" value="cancel" checked> <strong>取消本次策略变更</strong><br><span class="muted">保持 v42 和现有设备不变。</span></label></div><div class="dialog-foot"><button class="btn" value="cancel">返回编辑</button><button class="btn btn-primary" value="default" id="confirmPolicyConflict">确认选择</button></div></form></dialog>
<dialog id="manageDialog" aria-labelledby="manageTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="manageTitle">管理</h2><span class="muted">移动端保留 5 个主入口，低频管理能力从这里进入。</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭管理菜单">×</button></div><div class="dialog-body"><div class="relation-list"><button type="button" class="relation-item" data-manage-view="sites"><strong>站点与 Area</strong><span>配额、capture_policy、RBAC →</span></button><button type="button" class="relation-item" data-manage-view="audit"><strong>审计日志</strong><span>只读、筛选、分页 →</span></button></div></div></form></dialog>
<dialog id="eventDialog" aria-labelledby="eventDialogTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="eventDialogTitle">事件详情</h2><span class="muted" id="eventDialogSubtitle">不可变事实</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭事件详情">×</button></div><div class="dialog-body"><div class="fact-grid" style="margin:0 0 14px"><div class="fact"><span>事件编号</span><strong class="mono" id="eventDetailId">—</strong></div><div class="fact"><span>点位</span><strong id="eventDetailSite">—</strong></div><div class="fact"><span>规则</span><strong id="eventDetailRule">—</strong></div><div class="fact"><span>证据</span><strong id="eventDetailEvidence">—</strong></div></div><div class="relation-panel" style="margin:0"><h3>触发的预警</h3><div class="relation-list" id="eventAlerts"></div></div></div><div class="dialog-foot"><button class="btn" value="cancel">关闭</button></div></form></dialog>
<dialog id="handoverDialog" aria-labelledby="handoverTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="handoverTitle">值班交接</h2><span class="muted">白班 · 林值班员 → 晚班</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭交接班">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="handoverTo">接班人</label><select class="select" id="handoverTo"><option value="">请选择并确认本人已在场</option><option>王值班员 · 晚班</option><option>赵值班员 · 晚班</option></select></div><div class="form-field"><label for="handoverAt">交接时间</label><input class="field" id="handoverAt" value="2026-08-04 20:00" readonly></div><div class="form-field full"><label>待交接 Alert</label><div class="relation-list"><div class="relation-item"><strong>ALT-1842 · 未 ack</strong><span>下一次升级 01:42</span></div><div class="relation-item"><strong>ALT-1841 · 处置中</strong><span>王值班员现场核查</span></div><div class="relation-item"><strong>ALT-1839 · 升级中</strong><span>短信重试 2/3</span></div></div></div><div class="form-field full"><label for="handoverNote">交接备注</label><textarea class="textarea" id="handoverNote" placeholder="记录现场状态、已采取动作和待跟进事项"></textarea></div></div><p class="metric-note">交接期间升级链继续计时，不暂停、不重置；只转移这些进行中 Alert 的处置责任，不修改未来排班。未来班次变化请在“值班与排班”创建替班版本。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-primary" id="confirmHandover">接班人确认并留痕</button></div></form></dialog>
<dialog id="rollbackDialog" aria-labelledby="rollbackTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="rollbackTitle">版本历史与回滚</h2><span class="muted">RULE-007 · 历史版本不可变</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭版本历史">×</button></div><div class="dialog-body"><div class="version-diff"><article><strong>当前 v7 · 2026-08-01 正式发布</strong><span class="muted">持续 3 秒 · 全天 · 4 个点位 · 区域 v7</span></article><article><strong>目标 v6 · 2026-07-18 历史版本</strong><span class="muted">持续 5 秒 · 夜间 22:00–06:00 · 3 个点位 · 区域 v6</span></article><article><strong>影响评估</strong><span class="muted">将减少 1 个点位并收窄时段；预计每日预警 -18%。确认后创建并发布 v8，使其配置等价于 v6，v6/v7 均保持不变。</span></article></div></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-danger" id="confirmRollback">创建并发布回滚版本 v8</button></div></form></dialog>
<dialog id="escalationDialog" aria-labelledby="escalationTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="escalationTitle">编辑升级步骤</h2><span class="muted">默认链 v5 草稿 · 不直接保存手机号</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭升级步骤编辑">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="escalationTargetType">目标类型</label><select class="select" id="escalationTargetType"><option value="schedule">值班排班</option><option value="team">固定值班组</option><option value="person">指定人员</option></select></div><div class="form-field"><label for="escalationTargetRef">目标</label><select class="select" id="escalationTargetRef"></select></div><div class="form-field"><label for="escalationChannel">首选通道</label><select class="select" id="escalationChannel"><option>短信 + 语音兜底</option><option>Web + 本地声光</option><option>语音 + 短信兜底</option></select></div><div class="form-field"><label for="escalationTimeout">等待 ack</label><select class="select" id="escalationTimeout"><option>2 分钟</option><option>3 分钟</option><option>5 分钟</option></select></div><div class="form-field full"><label>当前解析预览</label><div class="resolve-item" id="escalationPreview" aria-live="polite"></div></div></div><p class="workflow-note">保存的是类型化目标引用与通道偏好。每次投递创建时按站点时区解析生效排班，再固化收件人、通道和排班版本快照。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-primary" id="saveEscalation">保存策略草稿</button></div></form></dialog>
<dialog id="scheduleDialog" aria-labelledby="scheduleTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="scheduleTitle">发布值班排班</h2><span class="muted">历史版本不可变</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭排班发布">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="scheduleName">排班计划</label><input class="field" id="scheduleName" value="校园安保值班表" readonly></div><div class="form-field"><label for="scheduleNextVersion">新版本</label><input class="field" id="scheduleNextVersion" value="v13" readonly></div><div class="form-field"><label for="scheduleTimezone">站点时区</label><select class="select" id="scheduleTimezone"><option>Asia/Shanghai</option></select></div><div class="form-field"><label for="scheduleEffective">生效时间</label><input class="field" id="scheduleEffective" type="datetime-local" value="2026-08-05T20:00"></div><div class="form-field full"><label for="scheduleReason">发布说明</label><textarea class="textarea" id="scheduleReason" placeholder="必填，例如：王值班员临时替班，覆盖周三晚班"></textarea></div></div><p class="metric-note">发布前重新检查空档、重叠、联系人停用和通道验证。新版本只影响生效时间后的投递，不回写 v12 或既有投递快照。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-primary" id="confirmSchedulePublish">确认发布 v13</button></div></form></dialog>
<dialog id="substituteDialog" aria-labelledby="substituteTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="substituteTitle">创建临时替班</h2><span class="muted">保存到 v13 草稿，发布后生效</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭临时替班">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="substituteShift">被替换班次</label><select class="select" id="substituteShift"><option>周三晚班 · 周值班员 · 20:00–08:00</option><option>周四白班 · 林值班员 · 08:00–20:00</option></select></div><div class="form-field"><label for="substitutePerson">替班人</label><select class="select" id="substitutePerson"><option value="">请选择可用联系人</option><option>王值班员</option><option>赵值班员</option></select></div><div class="form-field full"><label for="substituteReason">替班原因</label><textarea class="textarea" id="substituteReason" placeholder="必填，写入排班版本审计"></textarea></div></div><p class="workflow-note">临时替班修改未来排班。若只是把正在处置的 Alert 交给下一班，请使用值班台“交接班”，不要改排班。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-primary" id="saveSubstitute">保存到 v13 草稿</button></div></form></dialog>
<dialog id="contactDialog" aria-labelledby="contactTitle"><form method="dialog"><div class="dialog-head"><div><h2 id="contactTitle">新建联系人</h2><span class="muted">联系人不包含班次和轮换字段</span></div><button class="btn btn-quiet icon-btn" value="cancel" aria-label="关闭联系人编辑">×</button></div><div class="dialog-body"><div class="form-grid"><div class="form-field"><label for="contactName">姓名</label><input class="field" id="contactName" placeholder="联系人显示名"></div><div class="form-field"><label for="contactRole">角色</label><select class="select" id="contactRole"><option>值班员</option><option>站点负责人</option><option>租户管理员</option></select></div><div class="form-field"><label for="contactTeam">值班组</label><select class="select" id="contactTeam"><option>校园安保组</option><option>校级负责人组</option></select></div><div class="form-field"><label for="contactPhone">新通知号码</label><input class="field" id="contactPhone" type="tel" placeholder="输入后发送验证码；不回显旧值"></div><div class="form-field full"><label>启用通道</label><label class="radio-card"><input type="checkbox" id="contactSms" checked> 短信（需验证）</label><label class="radio-card"><input type="checkbox" id="contactVoice"> 语音（需验证）</label><label class="radio-card"><input type="checkbox" id="contactWeb" checked> Web 站内通知</label></div></div><p class="metric-note">联系人保存身份、角色、值班组与已验证通道。加入哪个班次、何时轮换由“值班与排班”模块引用联系人 ID 完成。</p></div><div class="dialog-foot"><button class="btn" value="cancel">取消</button><button type="button" class="btn btn-primary" id="saveContact">保存并发起通道验证</button></div></form></dialog>
<div class="toast" id="toast" role="status" aria-live="polite"></div>
<script>
const $ = (selector, root = document) => root.querySelector(selector);
const $$ = (selector, root = document) => [...root.querySelectorAll(selector)];
const toast = $('#toast');
let toastTimer;
function notify(message) {
toast.textContent = message;
toast.classList.add('show');
clearTimeout(toastTimer);
toastTimer = setTimeout(() => toast.classList.remove('show'), 3800);
}
const alerts = [
{id:'ALT-1842',severity:'S1 高危',badge:'danger',title:'危险区域闯入',site:'北围墙 01',time:'23:14:08',age:'1 分钟',rule:'非授权人员进入',delivery:'短信等待回执',events:[{id:'EVT-01J8…7A2',reason:'同点位 30 秒窗口聚合'},{id:'EVT-01J8…7B4',reason:'同规则连续命中聚合'}]},
{id:'ALT-1841',severity:'S1 高危',badge:'danger',title:'方向越线',site:'宿舍东通道',time:'23:12:46',age:'3 分钟',rule:'夜间越线 A → B',delivery:'声光已看到',events:[{id:'EVT-01J8…71M',reason:'单事件触发'}]},
{id:'ALT-1839',severity:'S2 重要',badge:'warning',title:'区域聚集',site:'操场西北角',time:'23:08:21',age:'7 分钟',rule:'人数 ≥ 6 持续 20 秒',delivery:'Web 已看到',events:[{id:'EVT-01J8…52C',reason:'同站点 60 秒窗口聚合'}]},
{id:'ALT-1836',severity:'S2 重要',badge:'warning',title:'危险区域滞留',site:'配电房门口',time:'22:57:03',age:'18 分钟',rule:'区域内停留 ≥ 10 秒',delivery:'短信最终失败',events:[{id:'EVT-01J8…44K',reason:'单事件触发'}]}
];
const eventRecords = [
{id:'EVT-01J8…7A2',time:'23:14:08',site:'北围墙 01',rule:'非授权人员进入',fact:'已确认',factBadge:'danger',result:'处置中',evidence:'可用',evidenceBadge:'success',alerts:[{id:'ALT-1842',state:'等待 ack · 聚合 2 个事件'}]},
{id:'EVT-01J8…7B4',time:'23:14:21',site:'北围墙 01',rule:'非授权人员进入',fact:'已确认',factBadge:'danger',result:'已聚合',evidence:'可用',evidenceBadge:'success',alerts:[{id:'ALT-1842',state:'等待 ack · 同点位窗口聚合'}]},
{id:'EVT-01J8…69P',time:'22:48:31',site:'宿舍东通道',rule:'区域内聚集',fact:'已记录',factBadge:'info',result:'试运行样本',evidence:'可用',evidenceBadge:'success',alerts:[]},
{id:'EVT-01J8…52C',time:'22:19:04',site:'实验楼入口',rule:'危险区域闯入',fact:'已确认',factBadge:'danger',result:'误报',evidence:'重试中',evidenceBadge:'warning',alerts:[{id:'ALT-1839',state:'处置完成 · 误报'}]},
{id:'EVT-01J8…71M',time:'21:58:20',site:'宿舍东通道',rule:'夜间越线 A → B',fact:'已确认',factBadge:'danger',result:'处置中',evidence:'可用',evidenceBadge:'success',alerts:[{id:'ALT-1841',state:'已 ack · 现场核查'}]},
{id:'EVT-01J8…44K',time:'21:31:02',site:'配电房门口',rule:'区域内停留 ≥ 10 秒',fact:'已确认',factBadge:'warning',result:'升级中',evidence:'仅抓拍',evidenceBadge:'warning',alerts:[{id:'ALT-1836',state:'短信最终失败 · 语音待发送'}]}
];
const auditRecords = [
{time:'23:14:18',role:'站点值班员',action:'ACK_ALERT',object:'ALT-1842',result:'成功',badge:'success',source:'值班室 Web'},
{time:'22:52:06',role:'站点管理员',action:'PUBLISH_RULE',object:'RULE-007',result:'成功',badge:'success',source:'管理端'},
{time:'22:20:31',role:'只读用户',action:'VIEW_EVIDENCE',object:'EVT-01J8…52C',result:'拒绝',badge:'danger',source:'响应式 H5'},
{time:'21:56:04',role:'站点值班员',action:'HANDOVER_SHIFT',object:'SHIFT-20260804-DAY',result:'成功',badge:'success',source:'值班室 Web'},
{time:'21:41:12',role:'租户管理员',action:'ROLLBACK_RULE',object:'RULE-007:v8',result:'成功',badge:'success',source:'管理端'},
{time:'20:05:55',role:'站点管理员',action:'UPDATE_AREA_POLICY',object:'area-lab-gate:v41',result:'成功',badge:'success',source:'管理端'}
];
function makeTextCell(row, value, className = '') {
const cell = document.createElement('td');
cell.textContent = value;
if (className) cell.className = className;
row.append(cell);
return cell;
}
function makeBadgeCell(row, value, badge) {
const cell = document.createElement('td');
const span = document.createElement('span');
span.className = `badge ${badge}`;
span.textContent = value;
cell.append(span);
row.append(cell);
}
let selectedAlertIndex = 0;
let ackOwner = null;
const alertList = $('#alertList');
function renderAlerts(selected = selectedAlertIndex) {
alertList.innerHTML = alerts.map((alert, index) => `<button class="alert-card ${index === selected ? 'selected' : ''}" data-index="${index}"><div class="alert-card-top"><span class="badge ${alert.badge}"><i class="severity-dot"></i>${alert.severity}</span><span class="muted">${alert.age}</span></div><h3>${alert.title}</h3><p>${alert.site} · ${alert.time}</p><div class="alert-card-foot"><span>${alert.delivery}</span><span class="mono">${alert.id}</span></div></button>`).join('');
$$('.alert-card', alertList).forEach(button => button.addEventListener('click', () => selectAlert(Number(button.dataset.index))));
}
function renderRelatedEvents(alert) {
const container = $('#relatedEvents');
container.replaceChildren();
alert.events.forEach(event => {
const button = document.createElement('button');
button.type = 'button';
button.className = 'relation-item';
const strong = document.createElement('strong');
strong.className = 'mono';
strong.textContent = event.id;
const reason = document.createElement('span');
reason.textContent = `${event.reason} →`;
button.append(strong, reason);
button.addEventListener('click', () => showEventDetail(event.id));
container.append(button);
});
$('#relatedEventCount').textContent = String(alert.events.length);
}
function resetAck() {
ackOwner = null;
$('#ackState').className = 'badge warning';
$('#ackState').textContent = '等待 ack';
$('#ackButton').disabled = false;
$('#ackButton').innerHTML = '<svg class="icon"><use href="#i-check"/></svg>确认接手';
$('#ackHelp').textContent = '一次点击确认；并发确认时会显示实际接手人，不覆盖对方结果。';
$('#ackConflict').hidden = true;
}
function selectAlert(index) {
selectedAlertIndex = index;
renderAlerts(index);
const alert = alerts[index];
$('#selectedSeverity').className = `badge ${alert.badge}`;
$('#selectedSeverity').textContent = alert.severity;
$('#selectedTitle').textContent = alert.title;
$('#selectedMeta').textContent = `${alert.site} · ${alert.time} · ${alert.id}`;
$('#factRule').textContent = alert.rule;
renderRelatedEvents(alert);
resetAck();
}
function openAlert(alertId) {
const index = alerts.findIndex(alert => alert.id === alertId);
if (index < 0) {
notify(`预警 ${alertId} 不在当前队列，请从历史预警查询。`);
return;
}
if ($('#eventDialog').open) $('#eventDialog').close();
switchView('duty');
selectAlert(index);
notify(`已从事件打开关联预警 ${alertId}。`);
}
function showEventDetail(eventId) {
const event = eventRecords.find(item => item.id === eventId) || eventRecords[0];
$('#eventDialogTitle').textContent = `${event.id} · 事件详情`;
$('#eventDialogSubtitle').textContent = `${event.time} · 事实不可由处置改写`;
$('#eventDetailId').textContent = event.id;
$('#eventDetailSite').textContent = event.site;
$('#eventDetailRule').textContent = event.rule;
$('#eventDetailEvidence').textContent = event.evidence;
const container = $('#eventAlerts');
container.replaceChildren();
if (!event.alerts.length) {
const message = document.createElement('div');
message.className = 'inline-alert';
message.textContent = '未创建 Alert：当前为试运行样本或已被规则抑制；不伪装成投递成功。';
container.append(message);
} else {
event.alerts.forEach(alert => {
const button = document.createElement('button');
button.type = 'button';
button.className = 'relation-item';
const strong = document.createElement('strong');
strong.className = 'mono';
strong.textContent = alert.id;
const state = document.createElement('span');
state.textContent = `${alert.state} →`;
button.append(strong, state);
button.addEventListener('click', () => openAlert(alert.id));
container.append(button);
});
}
$('#eventDialog').showModal();
}
let eventPage = 1;
const eventTotalPages = 16;
function renderEventPage() {
const start = ((eventPage - 1) * 3) % eventRecords.length;
const pageItems = [0, 1, 2].map(offset => eventRecords[(start + offset) % eventRecords.length]);
const body = $('#eventRows');
body.replaceChildren();
pageItems.forEach(event => {
const row = document.createElement('tr');
const idCell = document.createElement('td');
const eventButton = document.createElement('button');
eventButton.type = 'button';
eventButton.className = 'text-button mono';
eventButton.textContent = event.id;
eventButton.addEventListener('click', () => showEventDetail(event.id));
idCell.append(eventButton);
row.append(idCell);
makeTextCell(row, event.time);
makeTextCell(row, event.site);
makeTextCell(row, event.rule);
makeBadgeCell(row, event.fact, event.factBadge);
const alertCell = document.createElement('td');
if (event.alerts.length) {
event.alerts.forEach(alert => {
const button = document.createElement('button');
button.type = 'button';
button.className = 'text-button mono';
button.textContent = alert.id;
button.addEventListener('click', () => openAlert(alert.id));
alertCell.append(button);
});
} else {
alertCell.textContent = '未触发';
}
row.append(alertCell);
makeTextCell(row, event.result);
makeBadgeCell(row, event.evidence, event.evidenceBadge);
body.append(row);
});
$('#eventPageSummary').textContent = `第 ${eventPage} / ${eventTotalPages} 页 · 每页 3 条 · 共 47 条`;
$('#eventPrev').disabled = eventPage === 1;
$('#eventNext').disabled = eventPage === eventTotalPages;
}
let auditPage = 1;
const auditTotalPages = 28;
function renderAuditPage() {
const start = ((auditPage - 1) * 3) % auditRecords.length;
const pageItems = [0, 1, 2].map(offset => auditRecords[(start + offset) % auditRecords.length]);
const body = $('#auditRows');
body.replaceChildren();
pageItems.forEach(item => {
const row = document.createElement('tr');
makeTextCell(row, item.time);
makeTextCell(row, item.role);
makeTextCell(row, item.action);
makeTextCell(row, item.object, 'mono');
makeBadgeCell(row, item.result, item.badge);
makeTextCell(row, item.source);
body.append(row);
});
$('#auditPageSummary').textContent = `第 ${auditPage} / ${auditTotalPages} 页 · 每页 3 条 · 共 84 条`;
$('#auditPrev').disabled = auditPage === 1;
$('#auditNext').disabled = auditPage === auditTotalPages;
}
const validViews = new Set($$('.view').map(view => view.dataset.page));
function switchView(requested) {
const name = validViews.has(requested) ? requested : 'duty';
$$('.view').forEach(view => view.classList.toggle('active', view.dataset.page === name));
$$('[data-view]').forEach(button => {
const active = button.dataset.view === name;
button.toggleAttribute('aria-current', active);
button.classList.toggle('active', active);
});
$('#stateSelect').value = 'normal';
renderState('normal');
$('#main-content').focus({preventScroll:true});
}
$$('[data-view]').forEach(button => button.addEventListener('click', () => switchView(button.dataset.view)));
$$('.queue-tabs button').forEach(button => button.addEventListener('click', () => {
$$('.queue-tabs button').forEach(item => { const active = item === button; item.classList.toggle('active', active); item.setAttribute('aria-pressed', String(active)); });
notify(`队列已切换到“${button.textContent}”`);
}));
$$('.evidence-tabs button').forEach(button => button.addEventListener('click', () => {
$$('.evidence-tabs button').forEach(item => { const active = item === button; item.classList.toggle('active', active); item.setAttribute('aria-pressed', String(active)); });
notify(`正在演示“${button.textContent}”标签结构`);
}));
function renderState(state) {
const layer = $('#stateLayer');
const views = $$('.view');
layer.classList.toggle('show', state !== 'normal');
views.forEach(view => { view.style.display = state === 'normal' ? '' : 'none'; });
if (state === 'normal') return;
const states = {
loading:'<div><div class="skeleton" aria-label="正在加载"><i></i><i></i><i></i><i></i></div><h2>正在读取最新预警状态</h2><p>超过 300ms 显示进度；ack 和升级事实始终从服务端重新读取。</p></div>',
weak:'<div><svg class="icon" style="color:var(--warning)"><use href="#i-alert"/></svg><h2>结构化事件已到达，视频证据暂不可用</h2><p>弱网下先显示时间、点位、规则和升级链。视频片段可单独重试，不阻塞确认接手。</p><button class="btn" data-state-recover="weak">后台重试证据</button></div>',
empty:'<div><svg class="icon"><use href="#i-check"/></svg><h2>当前没有待处置预警</h2><p>系统在线，新的 Alert 会实时进入队列。历史事件仍可从事件中心查询。</p><button class="btn" data-empty-events>查看事件中心</button></div>',
denied:'<div><svg class="icon" style="color:var(--danger)"><use href="#i-lock"/></svg><h2>没有查看此站点证据的权限</h2><p>当前账号只能查看被授权站点。系统不会泄露事件是否存在、流地址或设备信息。</p><button class="btn" data-state-recover="denied">返回可访问范围</button></div>',
expired:'<div><svg class="icon" style="color:var(--danger)"><use href="#i-lock"/></svg><h2>会话已过期</h2><p>为保护预警和证据，页面已停止提交 ack 与处置。重新登录后从服务端读取最新责任人和升级状态，不重放旧操作。</p><button class="btn" data-state-recover="expired">重新登录并刷新状态</button></div>'
};
layer.innerHTML = states[state];
$('[data-state-recover]', layer)?.addEventListener('click', () => { $('#stateSelect').value = 'normal'; renderState('normal'); notify(state === 'weak' ? '证据重试任务已加入后台队列。' : '已刷新当前权限与服务端状态。'); });
$('[data-empty-events]', layer)?.addEventListener('click', () => switchView('events'));
}
$('#stateSelect').addEventListener('change', event => renderState(event.target.value));
$('#themeToggle').addEventListener('click', () => { const root = document.documentElement; root.dataset.theme = root.dataset.theme === 'dark' ? 'light' : 'dark'; notify(`已切换为${root.dataset.theme === 'dark' ? '深色' : '浅色'}主题`); });
$('#eventPrev').addEventListener('click', () => { if (eventPage > 1) { eventPage -= 1; renderEventPage(); } });
$('#eventNext').addEventListener('click', () => { if (eventPage < eventTotalPages) { eventPage += 1; renderEventPage(); } });
$('#auditPrev').addEventListener('click', () => { if (auditPage > 1) { auditPage -= 1; renderAuditPage(); } });
$('#auditNext').addEventListener('click', () => { if (auditPage < auditTotalPages) { auditPage += 1; renderAuditPage(); } });
$('#ackButton').addEventListener('click', async event => {
const button = event.currentTarget;
button.disabled = true;
button.textContent = '确认中…';
await new Promise(resolve => setTimeout(resolve, 650));
if (ackOwner && ackOwner !== 'current') {
button.textContent = '当前预警已由他人接手';
$('#ackConflict').hidden = false;
$('#ackConflict').textContent = '确认未生效：王值班员已于 23:15:01 抢先 ack。已刷新为服务端结果，没有覆盖对方。';
notify('并发确认未覆盖：请与当前处置人协作。');
return;
}
ackOwner = 'current';
button.innerHTML = '<svg class="icon"><use href="#i-check"/></svg>已由当前值班员接手';
$('#ackState').className = 'badge success';
$('#ackState').textContent = '已 ack';
$('#ackHelp').textContent = '23:15:02 · 当前值班员 · 服务端确认成功；通道回执仍单独保留。';
notify('确认成功，升级计时已停止并记录审计。');
});
$('#simulateAckConflict').addEventListener('click', () => {
ackOwner = 'other';
$('#ackButton').disabled = true;
$('#ackButton').textContent = '已由王值班员接手';
$('#ackState').className = 'badge info';
$('#ackState').textContent = '已 ack · 他人';
$('#ackHelp').textContent = '23:15:01 · 王值班员 · 服务端首个成功结果';
$('#ackConflict').hidden = false;
$('#ackConflict').textContent = '你的 ack 未生效：王值班员抢先成功。页面已刷新实际处置人，没有静默覆盖或显示双成功。';
});
$('#completeAlert').addEventListener('click', () => {
if (!$('#outcome').value) { notify('请先选择处置结果。'); $('#outcome').focus(); return; }
if (ackOwner !== 'current') { notify(ackOwner === 'other' ? '当前处置人为王值班员，你不能覆盖其处置结果。' : '请先确认接手，再完成处置。'); $('#ackButton').focus(); return; }
notify('处置结果已追加，原始事件事实未被修改。');
});
$('#falsePositive').addEventListener('click', () => $('#falseDialog').showModal());
$('#confirmFalse').addEventListener('click', event => { if (!$('#falseReason').value) { event.preventDefault(); notify('请选择误报原因。'); $('#falseReason').focus(); return; } notify('已标记误报并进入复核队列，原始事件保持不变。'); });
$('#muteButton').addEventListener('click', () => $('#muteDialog').showModal());
$('#confirmMute').addEventListener('click', event => { if (!$('#muteCause').value.trim()) { event.preventDefault(); notify('请填写静默原因。'); $('#muteCause').focus(); return; } notify('已创建限时静默，到期将自动恢复并通知值班组。'); });
$('#handoverButton').addEventListener('click', () => $('#handoverDialog').showModal());
$('#confirmHandover').addEventListener('click', () => { if (!$('#handoverTo').value) { notify('请选择接班人并由本人确认。'); $('#handoverTo').focus(); return; } $('#handoverDialog').close(); notify('交接已由接班人确认并写入审计；3 条 Alert 的升级链继续运行。'); });
function switchChainSection(name) {
const target = ['strategy', 'roster', 'contacts'].includes(name) ? name : 'strategy';
$$('[data-chain-panel]').forEach(panel => panel.classList.toggle('active', panel.dataset.chainPanel === target));
$$('[data-chain-section]').forEach(button => {
const active = button.dataset.chainSection === target;
button.classList.toggle('active', active);
button.setAttribute('aria-pressed', String(active));
});
}
$$('[data-chain-section]').forEach(button => button.addEventListener('click', () => switchChainSection(button.dataset.chainSection)));
const escalationTargets = {
schedule: [
{value:'SCH-CAMPUS-SECURITY',label:'校园安保值班表 · v12',preview:'王值班员 · 晚班 · 短信/语音已验证'},
{value:'SCH-SCHOOL-LEAD',label:'校级负责人轮值表 · v6',preview:'陈负责人 · 当前轮值 · 语音已验证'}
],
team: [
{value:'DUTY-ROOM',label:'值班室固定组',preview:'4 人在线 · Web + 本地声光'},
{value:'SCHOOL-LEADS',label:'校级负责人组',preview:'3 名成员 · 顺序通知'}
],
person: [
{value:'USR-SCHOOL-LEAD',label:'校级负责人',preview:'指定人员 · 短信已验证 · 语音待验证'},
{value:'USR-DUTY-WANG',label:'王值班员',preview:'指定人员 · 短信/语音/Web 已验证'}
]
};
function renderEscalationTargets() {
const type = $('#escalationTargetType').value;
const select = $('#escalationTargetRef');
select.replaceChildren();
escalationTargets[type].forEach(target => {
const option = document.createElement('option');
option.value = target.value;
option.textContent = target.label;
select.append(option);
});
renderEscalationPreview();
}
function renderEscalationPreview() {
const type = $('#escalationTargetType').value;
const target = escalationTargets[type].find(item => item.value === $('#escalationTargetRef').value) || escalationTargets[type][0];
const typeLabel = type === 'schedule' ? '值班排班' : type === 'team' ? '固定值班组' : '指定人员';
$('#escalationPreview').textContent = `${typeLabel} · ${target.label} → ${target.preview}。实际投递时固化解析快照。`;
}
$('#editEscalation').addEventListener('click', () => { renderEscalationTargets(); $('#escalationDialog').showModal(); });
$('#escalationTargetType').addEventListener('change', renderEscalationTargets);
$('#escalationTargetRef').addEventListener('change', renderEscalationPreview);
$('#saveEscalation').addEventListener('click', () => { $('#escalationDialog').close(); notify('升级策略草稿已保存为类型化目标引用；未复制联系人号码。'); });
let rosterHasConflict = false;
$('#simulateRosterConflict').addEventListener('click', event => {
rosterHasConflict = !rosterHasConflict;
$('#rosterConflict').hidden = !rosterHasConflict;
$('#rosterConflict').textContent = rosterHasConflict ? '发布已阻止：周三 20:00–21:00 存在排班重叠，同时安排了周值班员和王值班员；周四 08:00–09:00 存在空档。请调整后重新检查。' : '';
event.currentTarget.textContent = rosterHasConflict ? '恢复无冲突排班' : '演示冲突检查';
$('#openSchedulePublish').disabled = rosterHasConflict;
notify(rosterHasConflict ? '发现 1 个重叠和 1 个空档，排班不能发布。' : '冲突已修复，未来 14 天覆盖完整。');
});
$('#openSchedulePublish').addEventListener('click', () => { if (rosterHasConflict) { notify('请先修复排班空档和重叠。'); $('#rosterConflict').focus(); return; } $('#scheduleDialog').showModal(); });
$('#confirmSchedulePublish').addEventListener('click', () => {
if (!$('#scheduleReason').value.trim()) { notify('请填写排班发布说明。'); $('#scheduleReason').focus(); return; }
$('#scheduleDialog').close();
$('#scheduleVersion').textContent = 'v13';
notify('排班 v13 已发布，将在设定时间生效；v12 与既有投递快照保持不变。');
});
$('#openSubstitute').addEventListener('click', () => $('#substituteDialog').showModal());
$('#saveSubstitute').addEventListener('click', () => {
if (!$('#substitutePerson').value) { notify('请选择替班人。'); $('#substitutePerson').focus(); return; }
if (!$('#substituteReason').value.trim()) { notify('请填写替班原因。'); $('#substituteReason').focus(); return; }
$('#substituteDialog').close();
$('#wednesdayNightShift').textContent = `${$('#substitutePerson').value}（替班草稿）`;
$('#scheduleVersion').textContent = 'v13 草稿';
notify('临时替班已保存到 v13 草稿，发布前不会影响实际通知。');
});
let editingContact = false;
function openContactEditor(key = '') {
editingContact = Boolean(key);
const names = {wang:'王值班员',lin:'林值班员',lead:'校级负责人'};
$('#contactTitle').textContent = editingContact ? `编辑联系人 · ${names[key]}` : '新建联系人';
$('#contactName').value = editingContact ? names[key] : '';
$('#contactPhone').value = '';
$('#contactPhone').placeholder = editingContact ? '留空则保留已验证号码；旧值不回显' : '输入后发送验证码；不回显旧值';
$('#contactDialog').showModal();
}
$('#openContact').addEventListener('click', () => openContactEditor());
$$('[data-edit-contact]').forEach(button => button.addEventListener('click', () => openContactEditor(button.dataset.editContact)));
$('#saveContact').addEventListener('click', () => {
if (!$('#contactName').value.trim()) { notify('请填写联系人姓名。'); $('#contactName').focus(); return; }
const needsPhone = $('#contactSms').checked || $('#contactVoice').checked;
if (!editingContact && needsPhone && !$('#contactPhone').value.trim()) { notify('短信或语音通道需要填写新号码并完成验证。'); $('#contactPhone').focus(); return; }
$('#contactDialog').close();
if (!editingContact) $('#contactCount').textContent = '7';
notify(editingContact ? '联系人主数据已更新；既有投递快照未改变。' : '联系人已保存，短信/语音通道进入验证流程；尚未加入任何班次。');
});
$('#mobileManage').addEventListener('click', () => $('#manageDialog').showModal());
$$('[data-manage-view]').forEach(button => button.addEventListener('click', () => { $('#manageDialog').close(); switchView(button.dataset.manageView); notify(`已进入${button.textContent.trim()}。`); }));
$$('[data-edit-area]').forEach(button => button.addEventListener('click', () => { const isDorm = button.dataset.editArea === 'dorm'; $('#areaName').value = isDorm ? '宿舍卧室' : button.dataset.editArea === 'lab' ? '实验楼入口' : '北围墙'; $('#areaPolicy').value = isDorm ? 'non_imaging_only' : 'video_allowed'; $('#areaDialog').showModal(); }));
$('#newArea').addEventListener('click', () => { $('#areaName').value = ''; $('#areaPolicy').value = 'video_allowed'; $('#areaDialog').showModal(); });
$('#newSite').addEventListener('click', () => notify('新建站点需先填写时区、场景包、配额和管理员，本原型只枚举入口。'));
$('#saveAreaPolicy').addEventListener('click', () => { if (!$('#areaReason').value.trim()) { notify('请填写变更原因。'); $('#areaReason').focus(); return; } if ($('#areaName').value === '北围墙' && $('#areaPolicy').value === 'non_imaging_only') { $('#areaDialog').close(); $('#policyConflictDialog').showModal(); return; } $('#areaDialog').close(); notify('Area 策略新版本已保存，等待 Sense 拉取投影。'); });
$('#confirmPolicyConflict').addEventListener('click', () => { const action = $('input[name="conflictAction"]:checked').value; notify(action === 'move' ? '已创建 4 台设备迁移任务；完成前不会发布策略。' : '已取消策略变更，v42 和已有设备保持不变。'); });
const ruleDialog = $('#ruleDialog');
function openRuleEditor() { ruleDialog.showModal(); }
$('#openRuleDialog').addEventListener('click', openRuleEditor);
$('#continueRuleDraft').addEventListener('click', openRuleEditor);
$$('[data-edit-rule]').forEach(button => button.addEventListener('click', openRuleEditor));
function syncSenseZoneLink() { $('#editRuleZone').href = `../sense/index.html?view=device-detail&camera=${encodeURIComponent($('#ruleCamera').value)}&zone=${encodeURIComponent($('#ruleZone').value)}&return_to=bell-rule`; }
$('#ruleCamera').addEventListener('change', () => { syncSenseZoneLink(); notify('已切换摄像头，请确认检测区域版本与画面仍匹配。'); });
$('#ruleZone').addEventListener('change', syncSenseZoneLink);
$('#simulateRuleConflict').addEventListener('click', () => { $('#ruleConflict').hidden = false; $('#saveRuleDraft').disabled = true; notify('已读取服务端 v8；当前 v7 草稿被阻止覆盖。'); });
$('#saveRuleDraft').addEventListener('click', event => { if (!$('#ruleConflict').hidden) { event.preventDefault(); notify('版本冲突未解决，不能覆盖 v8。'); return; } notify($('#startDryRun').checked ? '规则草稿已保存并进入试运行，不会触发正式预警。' : '规则草稿已保存，尚未开始试运行。'); });
$('#publishTrialRule').addEventListener('click', () => { if (confirm('正式发布后将影响 3 个点位并启动预警链。确认发布当前试运行版本？')) { $('#trialBadge').className = 'badge success'; $('#trialBadge').textContent = '正式生效'; notify('规则版本已正式发布，变更已记录审计并可回滚。'); } });
$('#openRollback').addEventListener('click', () => $('#rollbackDialog').showModal());
$('#confirmRollback').addEventListener('click', () => { $('#rollbackDialog').close(); $('#publishedRuleBadge').textContent = '正式生效 · v8（回滚）'; notify('已创建并发布 v8，其配置等价于 v6；v6、v7 历史保持不变。'); });
let remain = 102;
setInterval(() => { if (ackOwner || remain <= 0) return; remain -= 1; const minutes = String(Math.floor(remain / 60)).padStart(2, '0'); const seconds = String(remain % 60).padStart(2, '0'); $('#countdown').textContent = `${minutes}:${seconds}`; }, 1000);
renderAlerts();
renderRelatedEvents(alerts[0]);
renderEventPage();
renderAuditPage();
const routeParams = new URLSearchParams(location.search);
if (routeParams.get('view')) switchView(routeParams.get('view'));
if (routeParams.get('view') === 'chains' && routeParams.get('section')) switchChainSection(routeParams.get('section'));
if (routeParams.get('view') === 'audit' && (routeParams.has('device') || routeParams.has('site'))) {
const tenant = routeParams.get('tenant') || '当前租户';
const site = routeParams.get('site') || '当前站点';
const device = routeParams.get('device') || '全部设备';
$('#auditContext').hidden = false;
$('#auditTenant').textContent = tenant;
$('#auditSite').textContent = site;
$('#auditDevice').textContent = device;
$('#auditSearch').value = device;
auditRecords.unshift({time:'10:47:36',role:'站点管理员',action:'PAUSE_INFERENCE',object:device,result:'成功',badge:'success',source:'Sense outbox · relay 已送达'});
renderAuditPage();
$('#auditReturn').href = `../sense/index.html?view=device-detail&device=${encodeURIComponent(device)}&return_to=bell-audit`;
notify('已安全应用来自 Sense 的租户、站点和设备审计筛选。');
}
if (routeParams.has('event')) {
switchView('events');
showEventDetail(routeParams.get('event'));
}
if (routeParams.has('alert')) openAlert(routeParams.get('alert'));
if (routeParams.has('camera')) {
switchView('rules');
$('#ruleContext').hidden = false;
const camera = routeParams.get('camera');
if ([...$('#ruleCamera').options].some(option => option.value === camera)) $('#ruleCamera').value = camera;
const zone = routeParams.get('zone');
if (zone && [...$('#ruleZone').options].some(option => option.value === zone)) $('#ruleZone').value = zone;
$('#ruleContextCamera').textContent = $('#ruleCamera').selectedOptions[0].textContent;
$('#ruleContextZone').textContent = zone || $('#ruleZone').value;
syncSenseZoneLink();
notify('已保留摄像头与检测区域上下文，可继续配置规则。');
}
</script>
</body>
</html>
docs/design/sense/index.html
+161
View File
File diff suppressed because one or more lines are too long
docs/raw/02-需求分析.md
+15 -7
View File
@@ -125,8 +125,8 @@ erDiagram
| --- | --- | --- |
| **Tenant 租户** | 计费与数据隔离的最小单位 | 所有查询必须带 tenant_id，无例外 |
| **Site 站点** | 一个物理场所（一户 / 一所学校 / 一个小区） | 升级链、时段策略挂在这一层 |
| **Area 区域** | 站点内的逻辑分区（教学楼 / 单元 / 客厅） | 用于权限范围与报表口径 |
| **Device 设备** | **不叫 Camera**，`device_type` 取 camera/radar/door/button | 为异构传感器预留（继承参考项目 §4.5） |
| **Area 区域** | 站点内的逻辑分区（教学楼 / 单元 / 客厅），由 Bell 统一管理 | 用于权限范围、报表口径与设备准入；`capture_policy` 表达是否仅允许非成像设备，Sense 只消费带版本的策略投影 |
| **Device 设备** | **不叫 Camera**；`modality` 表达 video/radar/contact/button/wearable/other，`capabilities` 表达成像、媒体、遥测等具体能力 | 模态负责稳定分类，能力负责决定字段与操作，避免接入新设备时重做台账和页面 |
| **Zone 画面区域** | 画在某路画面上的多边形或警戒线 | 与 Area 是两回事：Area 是物理概念，Zone 是像素坐标 |
| **Rule 规则** | 「主体 × 条件 × 时空 × 动作」的可配置组合 | 三级覆盖：租户默认 → 站点 → 设备 |
| **Event 事件** | 一次被判定成立的客观发生 | **不可变**。误判只能被标记，不能被删改 |
@@ -608,21 +608,27 @@ GPU 型号和数量不在需求阶段写死。M1 用 5 路打通，M3 以 16 路
在参考项目基础上扩展多租户与规则/事件。**字段级设计见《03》，此处只给结构与关键约束。**
```sql
-- ── 组织（Bell 为真相源；Sense 只读配额投影）────────
-- ── 组织（Bell 为真相源；Sense 不直接写这些表）────────
tenants(id, code, name, status, plan, created_at)
sites(id, tenant_id, code, name, scene_pack, subnet CIDR, timezone, status,
max_video_channels INT NOT NULL DEFAULT 16 CHECK (max_video_channels BETWEEN 1 AND 128))
areas(id, site_id, name, parent_id)
areas(id, site_id, name, parent_id,
capture_policy) -- video_allowed | non_imaging_only
-- ── 设备（不叫 cameras，为异构传感器预留）────
-- ── Sense 只读投影（来源版本与同步时间必须可追溯）────
site_quota_projections(site_id, max_video_channels, source_version, synced_at)
area_policy_projections(area_id, site_id, capture_policy, source_version, synced_at)
-- ── Sense 设备（不叫 cameras，为异构传感器预留）────
devices(
id, tenant_id, site_id, area_id,
device_type, -- camera | radar | door | button
modality, -- video | radar | contact | button | wearable | other
device_kind, -- camera | mmwave_radar | door_contact | panic_button | ...
capabilities JSONB, -- captures_image / media_stream / telemetry / battery / spatial_config / ...
serial UNIQUE, -- ⚠️ 身份用序列号，不用 IP
vendor, model,
onvif_addr, onvif_user, onvif_secret, -- secret 加密存储
state, -- pending_activation | active | offline | disabled
privacy_flag, -- 隐私区域标记，为 true 时拒绝 camera 类型
last_seen_at
)
stream_bindings(id, device_id, mtx_instance, inference_shard, path_name, rtsp_url, profile_token, enabled,
@@ -701,6 +707,8 @@ CREATE INDEX ON alerts(state) WHERE state NOT IN ('closed','suppressed');
7. 人脸相关表独立 schema、独立加密、独立审计；`persons.valid_until` 必填，无"永久有效"选项
8. `sites.max_video_channels` 默认 16、最大 128；配额在写入设备时校验，分片容量由运行时配置与压测决定
9. `sites.max_video_channels` 由 Bell 持有，Sense 通过版本化内部 API 或只读投影校验设备新增/启用；不得跨 schema 直接写入
10. Tenant/Site/Area/RBAC、配额与全局审计属于 Bell；Sense 仅使用稳定逻辑 ID 关联并保存带 `source_version` / `synced_at` 的执行投影
11. 高风险设备写操作与本地审计 outbox 在 Sense 同一事务提交，再由幂等 relay 异步汇入 Bell；审计接口字段、签名和重放规则另立契约任务冻结
---
docs/raw/03-通用场景应用方案.md
+8 -5
View File
@@ -921,7 +921,7 @@ scene_packs/campus@1.2/
| 约束 | 实现 |
| --- | --- |
| 卧室、卫生间**禁装摄像头** | `devices.privacy_flag = true` 时系统拒绝创建 `device_type = camera`（代码级硬约束） |
| 卧室、卫生间**禁装摄像头** | `areas.capture_policy = non_imaging_only` 时，Sense 在设备新增/启用写路径拒绝具有 `captures_image` 能力的设备（代码级硬约束）；策略读取失败时拒绝新变更并告警，不静默切断已有链路 |
| 平时不解码不上传 | 触发式推理 + `record: no` + 边缘环形缓冲 |
| 家属只能看自己家的告警关联片段 | RBAC：`family` 角色的证据访问范围 = `site_id` ∩ `alert_events` |
| 3 分钟内必有真人接手 | 4 级升级链（30s/60s/90s → 呼叫中心） |
@@ -1067,7 +1067,7 @@ capacity:
`stream_bindings` 同时记录 `mtx_instance` 与 `inference_shard`。默认按 `site_id + device_id` 稳定分配；扩容时允许迁移，但同一设备任一时刻只能归属一个有效媒体分片和一个推理分片。
`sites.max_video_channels` 的唯一真相源在 Bell；Sense 在设备新增/启用写路径通过版本化内部 API 或只读投影执行配额校验，不跨 schema 直接写入。配额依赖暂时不可用时只拒绝新的容量变更，已有视频链路继续运行。
`sites.max_video_channels`、Site/Area 层级和 `areas.capture_policy` 的唯一真相源在 Bell；Sense 在设备新增/启用写路径通过版本化内部 API 或带 `source_version` / `synced_at` 的只读投影执行校验，不跨 schema 直接写入。配额或 Area 策略依赖暂时不可用时只拒绝相关新变更，已有视频链路继续运行并产生运维告警。
> **不要单实例硬扛 128 路**：扩容必须通过增加分片与 Worker 完成。单分片故障只允许影响该分片，不能拖垮整个站点。GPU 型号与数量不在架构文档写死，M1 用 5 路打通，M3 建立 16 路基线，M4/M5 再验证 64/128 路。
@@ -1115,7 +1115,8 @@ OpenTelemetry → Jaeger，排查单帧处理延迟与端到端事件链路。
| 端 | 核心功能 |
| --- | --- |
| **管理系统（Web）** | 租户/站点/设备管理、批量开通、规则配置（含试运行）、Zone 画图、升级链配置、事件看板与筛选、事件详情（视频+观测回放）、处置与工单、误报标记、统计报表、审计查询、RBAC |
| **Sense 接入工作台（Web）** | 当前租户/站点上下文、设备台账与批量开通、能力探测、Zone 画图、对账/分片/边缘隧道/补传/运维告警；不管理 Tenant/Site/Area/RBAC 或全局审计 |
| **Bell 统一管理端（Web）** | Tenant/Site/Area/配额/`capture_policy`、RBAC、规则配置（含试运行）、升级链、事件看板与筛选、事件详情（视频+观测回放）、处置与工单、误报标记、统计报表、全局审计；设备操作日志从 Sense 汇入并可深链返回 |
| **App（家属/值班员）** | 预警接收与 ack、事件详情与视频回看、一键呼叫、误报反馈、限时静默、设备状态、（家属）多老人切换 |
| **大屏/值班台** | 实时事件流、地图/平面图点位、声光联动、当班交接 |
| **Webhook/开放 API** | 对接客户既有平台、门禁、消防、工单系统 |
@@ -1144,7 +1145,9 @@ OpenTelemetry → Jaeger，排查单帧处理延迟与端到端事件链路。
| --- | --- | --- | --- | --- | --- |
| **Sense** | 感知系统 | L1 接入 | Go | 有（设备台账） | M1 |
| **Brain** | 推理系统 | L2 流水线 + L3 算法 | Python / CUDA | **无状态** | M3 |
| **Bell** | 管理系统 | L4 业务 + L0 基座 | Go + 前端 | 有（事件、告警） | M3 → M4 |
| **Bell** | 管理系统 | L4 业务 + L0 基座 | Go + 前端 | 有（事件、告警、组织与策略真相） | M3 → M4 |
Sense 的高风险设备操作不能采用“先执行、再尽力记录审计”。实现时应在本地事务内同时写期望态与持久化 outbox，再由幂等 relay 异步汇入 Bell 全局审计。该跨系统接口的字段、签名、重放和留存必须另立 API/契约任务，不在 UI 原型任务中顺带冻结。
三者之间只有一条契约——**事件实例 JSON**（§2.6，规范本体见 `contracts/event-v0.1.schema.json`）。Sense 向 Brain 供流与信号，Brain 产出事件，Bell 消费事件。这条边界让推理侧换模型、换框架（Savant → Pipeless、YOLO → YOLOX）时，另两个系统一行不改。
@@ -1228,7 +1231,7 @@ redis 消息总线
- [ ] 终止服务时的底库彻底删除义务与证明方式已约定
## 架构
- [ ] `devices` 表而非 `cameras`，含 `device_type`
- [ ] `devices` 表而非 `cameras`，含 `modality + capabilities`；Bell 持有 Area 与 `capture_policy`，Sense 只存带版本的准入投影
- [ ] 设备身份用序列号
- [ ] 触发入口独立成 handler
- [ ] `sync_state` 每系统一行
docs/raw/08-三系统职责划分.md
+10 -7
View File
@@ -23,7 +23,7 @@
**Sense —— 把现场的流和信号稳定地拿进来并管住**
- 设备台账（`devices`，含 `modality`：video / radar / contact / button / wearable）
- 设备台账（`devices`，含 `modality`：video / radar / contact / button / wearable / other，以及决定成像、媒体、遥测、空间配置等页面与操作的 `capabilities`）
- ONVIF 客户端：连接、GetProfiles、GetStreamUri、SetSystemDateAndTime
- mediamtx API 客户端（**自行用 oapi-codegen 从其 OpenAPI 生成**，不依赖第三方 SDK）
- **对账器**：水平触发、`sync_state`、独立信号量、10% 孤儿删除安全闸、只收敛不回滚
@@ -31,6 +31,7 @@
- WireGuard 控制面隧道
- mediamtx 鉴权回调（401 + 踢流是四种停用粒度之一）
- 容量配额执行：设备新增/启用时读取 Bell 的站点配额，只拒绝超额变更；配额服务暂时不可用时不影响已有流
- Area 准入执行：消费 Bell 的版本化 `capture_policy` 投影；策略不可用时只拒绝相关新写入，不静默中断已有设备
- 流绑定与媒体分片调度：维护 `mtx_instance`，默认 16 路交付；扩到 128 路时按 `media_shard.max_streams` 横向分片
- 边缘节点 agent：推流、本地环形缓冲、断网续传
- **设备型触发源**：雷达、门磁、按钮、ONVIF 事件订阅
@@ -54,8 +55,8 @@
- 告警状态机：升级链、ack、抑制、静默（**≤4h，无永久选项**）
- 投递：push / 短信 / 语音，**双供应商**
- 误报反馈闭环：`outcome` 回写 Brain
- 多租户 RBAC、`tenant_features`（人脸授权开关：未授权时能力在 API 与 UI 中**不可见**，不是禁用）
- 审计日志
- Tenant/Site/Area、`capture_policy`、多租户 RBAC、`tenant_features`（人脸授权开关：未授权时能力在 API 与 UI 中**不可见**，不是禁用）
- 全局审计日志；接收 Sense 设备操作审计并保留来源上下文
- 站点容量配额的唯一真相源：`site.max_video_channels` 默认 16、上限 128；提供版本化内部读取接口/投影给 Sense 执行
- 管理后台前端 + 大屏：按 128 路设计分页/虚拟列表、筛选与批量操作，不一次性加载全部视频
@@ -80,7 +81,7 @@ Sense/
│ ├── sense-api/ 控制面服务：设备台账、鉴权回调、对账器
│ └── sense-agent/ 边缘节点：推流、环形缓冲、隧道
├── internal/
│ ├── device/ 设备台账（devices，含 modality）
│ ├── device/ 设备台账（devices，含 modality + capabilities）
│ ├── onvif/ 连接、GetProfiles、GetStreamUri、SetSystemDateAndTime
│ ├── mtx/ oapi-codegen 生成的 mediamtx 客户端 + 薄封装
│ ├── reconcile/ 对账循环（幂等 + 退避 + 安全闸）
@@ -138,7 +139,7 @@ Bell/
---
## 3. 七条边界（不写死就会漂）
## 3. 八条边界（不写死就会漂）
| # | 边界 | 定论 |
| --- | --- | --- |
@@ -149,8 +150,10 @@ Bell/
| 5 | 一个 PostgreSQL 还是三个 | **一个实例，schema 分离**（`sense` / `bell`），Brain 无 schema。"DB 是唯一真相源"是对账器成立的前提，拆库即失效 |
| 6 | 16 路与 128 路分别指什么 | **16 路是默认交付规格，128 路是本阶段单逻辑站点上限**，都不是“单进程/单服务器保证值”。媒体与推理必须横向分片；单机承载量由分辨率、码率、帧率、模型和硬件基准测试决定 |
| 7 | 站点配额谁拥有、谁执行 | **Bell 拥有 `sites.max_video_channels`，Sense 在设备新增/启用写路径执行**。通过版本化内部 API 或只读投影同步，不允许 Sense 直接写 Bell schema；依赖暂时不可用时拒绝新变更，但已有视频链路继续运行 |
| 8 | 设备模态与隐私准入怎么建模 | 台账使用 `modality + capabilities`，不以摄像头作为唯一根实体；**Bell 拥有 Area 与 `capture_policy`，Sense 消费带版本投影并按设备 `captures_image` 能力在新增/启用写路径执行**。策略不可用时拒绝相关新变更并告警，已有链路不静默停用；M1 固化模型，M6 再增加非视频适配器 |
| 9 | 接入操作审计怎么进入 Bell | Sense 在同一事务写设备期望态和持久化 outbox，再由幂等 relay 异步汇入 Bell 全局审计；不得先执行高风险操作再尽力入队。字段、签名、重放和留存由独立 API/契约任务冻结 |
第 2、3、6、7 条是本文档新定的，若实施中发现更合适的切法，改这里并同步《02》《03》。
第 2、3、6、7、8、9 条是本文档新定的，若实施中发现更合适的切法，改这里并同步《02》《03》。
---
@@ -179,6 +182,6 @@ DB schema sense — bell
| **M3** 默认 16 路推理 + 规则引擎 + 事件预警 | **Brain + Bell 同时起步**，契约在此首次被真实使用 |
| **M4** 64 路分片 + 灰度 + 管理系统 | Sense 与 Brain 完成横向分片，Bell 完成 128 路规模下的列表与批量交互；验证单分片故障隔离 |
| **M5** 128 路容量验收 + 第二三场景包 + 触发式推理 + 人脸 | Sense/Brain 验证扩容不改业务代码；Bell 的 `packs/`（**纯配置**）+ Brain 的模型与触发 |
| **M6** 异构传感器 + 两级判定 | Sense 的 `trigger/` 与 `device/`（modality 扩展）+ Brain 两级判定 |
| **M6** 异构传感器 + 两级判定 | Sense 的 `trigger/` 与 `device/` 增加非视频协议适配器与能力实现（`modality + capabilities` 模型已从 M1 保留）+ Brain 两级判定 |
> M3 是契约第一次被真实使用的时刻。**在此之前契约允许原地修订，之后版本递增规则绝对生效**（契约 README §1）。
docs/raw/09-Sense原型评审-IX草稿.md
+148
View File
@@ -0,0 +1,148 @@
# Sense 原型评审 → IX 修订稿
> 评审对象：`docs/design/sense/index.html`（T-004）
> 初始输入：Claude 评审草稿，2026-08-04
> 复核：Codex 从产品、全栈架构与 UI/UX 角度对照《02》《03》《08-三系统职责划分》、US/IX 和当前原型核验
> 状态：项目负责人已确认按本修订稿继续；最终行为已同步到 `docs/08-interaction-checklist.md`
> 后续：第二轮缺口复核与最终 IA 见 `11-Sense原型-第二轮缺口.md`、`12-Sense原型-待办清单.md`；若与本文原型范围冲突，以第二轮修订为准
---
## 1. 评审结论
初始评审指出的五类缺口方向成立：设备模态、停用收敛、隐私准入、检测区域几何编辑、草稿与跨系统上下文都需要进入正式交互清单。但原稿不能直接合入，原因有三类：
1. 部分证据与当前代码不一致：Sense 页内导航不会清空几何点，Sense→Bell 已携带 `camera + zone`，单媒体分片 32 路已有架构来源。
2. 部分方案把后端字段直接等同产品能力：非视频设备仍需要连接与健康，隐私准入不能只看显示名称或单一模态。
3. 部分行为不符合审计和草稿体验：幂等不等于不记审计，避免丢草稿应优先自动保存，而不是每次导航都弹确认。
原产品边界保持不变：
- Sense 管设备接入、健康、媒体与设备空间配置。
- 视频设备的检测区域继续位于设备详情，不恢复一级“区域规则”。
- Bell 管场景、继承、时段、持续时间、试运行、发布和升级链。
- 两个系统通过稳定深链和可恢复草稿保持连续体验。
---
## 2. 最终新增 IX
| ID | 场景 | 最终约定 | 关联 US | 阶段 |
| --- | --- | --- | --- | --- |
| IX-014 | 设备模态与能力 | 一级入口为“设备”；列表可按 `modality` 筛选，添加时先选模态，详情按 `capabilities` 渐进展示；视频设备显示画面/媒体/检测区域，非视频设备保留连接与健康并显示对应遥测，不用禁用的视频页签占位 | US-008 | M2/M6 |
| IX-015 | 停用与收敛 | 明确区分暂停推理、停用设备接入和仅踢当前会话；操作前展示对观看、推理、录制与证据回捞的影响并二次确认；期望态立即改变、实际态经对账收敛，部分失败可逐项重试；重复请求不产生重复副作用，但每次请求均留审计结果 | US-001、US-002 | M2 |
| IX-016 | 隐私区域设备准入 | `capture_policy = non_imaging_only` 的 Area 不允许新增/启用具有成像能力的设备；前端就地禁用并解释，后端返回稳定错误码；策略读取失败时拒绝新变更并告警，已有设备遇到区域策略变化时进入显式处置流程，不静默留存或停用 | US-008 | M2/M6 |
| IX-017 | 检测区域几何编辑 | 多边形和方向警戒线支持绘制、显式完成、撤销、清空、顶点编辑；警戒线在草稿/已保存态均显示方向箭头并可反转；鼠标与键盘坐标操作等效；画面参数变化后标记待校准且不自动改坐标；区域版本与规则版本独立 | US-005 | M3 |
| IX-018 | 草稿与跨系统上下文 | 几何草稿自动保存并可恢复；只有持久化失败或切换空间类型等会破坏草稿的动作才拦截确认；Sense↔Bell 双向携带并消费 `camera + zone + return_to` 上下文；返回后恢复草稿，版本已被他人更新时提示冲突且不覆盖 | US-005 | M3 |
`IX-003` 已覆盖设备列表分页/筛选/批量选择和 128 路按需加载，因此分页属于原型漏画，不新增 IX。
---
## 3. 关键设计修订
### 3.1 设备使用 `modality + capabilities`
`modality` 用于稳定分类：video / radar / contact / button / wearable / other。`capabilities` 决定字段、页签和动作，例如：
- `captures_image`
- `media_stream`
- `telemetry`
- `battery`
- `spatial_config`
- `directional_line`
M2 的一级导航与台账统一使用“设备”，默认筛选视频设备；M1～M5 只完整实现 video 适配器。M6 增加非视频协议适配器，不重新设计根实体与页面层级。
非视频设备不展示画面、Profile 和媒体分片，但仍展示“连接与健康”，并根据能力显示最后上报、信号质量、电量、遥测或传感器校准。
### 3.2 隐私策略属于 Area
隐私是物理位置的准入策略，不是设备已经创建后的标签。统一模型为：
```text
Area.capture_policy = video_allowed | non_imaging_only
Device.modality
Device.capabilities.captures_image
```
Sense 在新增/启用写路径执行校验。后端返回稳定错误码，前端负责本地化说明。策略不可读取时对新成像变更 fail closed 并告警；已有链路保持当前状态并进入待处置/未收敛列表，不能因一次依赖失败被静默切断。
### 3.3 停用动作不能混为一个开关
| 用户动作 | 期望效果 |
| --- | --- |
| 暂停推理 | 卸载推理 source；接入和授权观看按策略保留 |
| 停用设备接入 | 踢当前发布会话、拒绝后续发布、卸载推理；期望态先变，实际态由对账收敛 |
| 仅踢当前会话 | 运维诊断动作；客户端可能重连，不改变持久期望态 |
每种动作展示独立影响范围。重复请求不得生成重复资源变更或状态副作用，但所有操作尝试都应进入审计并标明“已处于目标状态”或实际结果。
### 3.4 几何编辑提供显式完成与等效操作
- 多边形至少 3 点，方向警戒线恰好 2 点。
- 双击可作为快捷方式，但必须有可见的“完成绘制”按钮；双击事件不得额外追加顶点。
- 警戒线草稿和保存态都渲染方向箭头，并提供“反转方向”。
- 顶点列表支持添加、编辑、删除、撤销，键盘与鼠标结果等效。
- 画面分辨率或旋转变化后标记待校准，不自动修改坐标，也不自动发布 Bell 规则。
### 3.5 草稿优先自动保存
页内导航不应反复打断用户。几何草稿在本地/服务端自动保存并显示状态；只有自动保存失败、切换不兼容空间类型或明确放弃草稿时才确认。关闭标签页使用平台允许的离开保护作为兜底，不能把它当主保存机制。
深链统一携带并消费：
```text
camera=<stable-device-id>
zone=<zone-id>
return_to=<trusted-route-token>
```
`return_to` 只能使用受信路由 token，不能接受任意外部 URL。保存时使用区域版本做乐观并发校验；发现他人已保存新版本时提示重新加载或另存草稿，不覆盖。
---
## 4. 对初始评审事实的纠正
| 初始判断 | 核验结果 | 最终处理 |
| --- | --- | --- |
| 128 路列表缺分页需要新 IX | `IX-003` 已覆盖 | 只补原型分页 |
| 单媒体分片 32 路无出处 | 《03》§4.2 已定义 `media_shard_max_streams: 32`，128 路建议 4 个 32 路分片 | 保留 32；原型标明当前启用数与可扩展上限 |
| 侧栏/面包屑会清空草稿 | 当前 `switchView()` 不清空 `points` | 不作为现状缺陷；仍要求跨刷新/跨系统恢复 |
| Sense→Bell 缺少 camera/zone | Sense 已发送两者，但 Bell 未消费 `zone`；Bell→Sense 缺 `zone` | 修复双方生成与消费 |
| 非视频设备不展示健康页签 | 非视频设备仍有连接、上报、信号、电量与故障状态 | 使用通用“连接与健康”，能力驱动内容 |
| 幂等操作不生成重复审计 | 不符合审计目标 | 幂等只约束副作用，每次请求保留审计结果 |
---
## 5. 无障碍与安全收紧
- 正文、按钮文字和关键状态对比度不低于 4.5:1；大字号不低于 3:1；非文本控件、状态边界和焦点指示器不低于 3:1。
- 当前导航显式设置 `aria-current="page"`，不能用空值属性表示当前页。
- 响应式隐藏可见文字时，按钮仍保留 `aria-label` 等稳定可访问名。
- Tab 必须完整实现 `tablist` / `tab` / `tabpanel`、关联属性、单一 Tab 停靠点与方向键；否则不声明 tab 角色。
- 移动端主要操作目标不小于 44×44px，输入正文不小于 16px；几何绘制提供不依赖精确点击的表单等效路径。
---
## 6. 原型落地范围
Sense 原型重新生成并覆盖：
1. 一级“设备”入口、模态筛选、分页和视频/雷达示例。
2. 能力驱动详情：视频显示画面与检测区域，雷达显示遥测，二者都有连接与健康。
3. 添加设备先选模态，隐私 Area 对成像设备就地拒绝。
4. 暂停推理、停用接入、踢当前会话的独立影响确认与期望/实际收敛反馈。
5. 显式完成绘制、方向箭头/反转、顶点编辑、自动草稿与冲突状态。
6. Sense/Bell 双向 `camera + zone + return_to` 深链。
7. 对比度、可访问名、完整 Tab 模式、44px 移动触控目标。
Bell 原型只调整深链消费和返回上下文，不改变“规则业务归 Bell、空间几何归 Sense”的产品边界。
---
## 7. 后续兼容债务（不在本原型任务改契约）
事件 v0.1 的 schema 描述与契约 README 仍使用 `privacy_flag` 表示区域是否允许视频模态，而本次领域模型已收敛为 Area 的 `capture_policy`。两者当前语义可一一映射：`privacy_flag = true` 等价于 `capture_policy = non_imaging_only`，但不能长期保留两套真相源。
M2 开始 schema/API 实现前应单独建立契约任务，选择“保持 v0.1 线格式并在投影层兼容”或“按版本治理规则新增字段/版本”，同步《06》与 `docs/raw/contracts/` 后再写代码。T-004 只更新产品与架构决策，不修改已经声明为既有契约的 event v0.1。
docs/raw/11-Sense原型-第二轮缺口.md
+139
View File
@@ -0,0 +1,139 @@
# Sense 原型第二轮评审复核版
> 原始输入：Claude《Sense 原型第二轮评审》，2026-08-04
> 复核基准：`docs/design/sense/index.html`，提交 `e18a1ea`
> 复核视角：产品边界、全栈架构、M2 用户流程与 UI/UX
> 状态：项目负责人已确认按本复核结论继续修改
---
## 1. 总结
Claude 指出的对账运维、设备能力来源、非视频适配器阶段、待激活、凭据恢复、写入降级和边缘隧道等缺口方向成立；但原稿不能直接作为执行清单，主要有三类问题：
1. **基准落后**：设备分页和推理收敛成功态已经实现，分片数据也不再是原稿引用的 `8 / 32`。
2. **范围扩大**：T-004 当前关联 US-001、US-002、US-008 和部分 US-005，并未承诺一次画完完整 M2/M4 管理端。新增 P0 页面必须先同步 US/IX 与任务范围。
3. **系统归属混淆**：`routes.md` 的 `/sites`、`/operations`、`/audit` 是统一管理 Web 的候选页面职责，不等于都应成为 Sense 一级导航。Bell 拥有租户/RBAC、审计、配额真相源和管理端；Sense 负责设备接入与运行态运维。
因此，本轮采纳“补核心流程、收敛导航、冻结归属”的方案，不采用“Sense 导航机械扩为 8 项”。
---
## 2. 对原评审事实的纠正
| 原判断 | 当前事实 | 处理 |
| --- | --- | --- |
| 设备列表分页未实现 | 已有 5 条/页、上一页/下一页、页数和总数 | 标记完成；批量选择未来新增时再定义跨页语义 |
| “推理绑定 16/16”仍是紫色满格 | 已改为“推理配置收敛 16/16”绿色成功态 | 标记完成 |
| 分片仍显示 `8 / 32` | 当前为 `16 / 32`，并显示“当前 1 / 最多 4” | 只补“32 是可配置建议值、最终由压测确定” |
| T-004 `write_paths` 只有三个文件 | 已扩展到需求、架构、US/IX、评审稿和两个原型 | 更新清单基准 |
| modality 筛选包含 ONVIF/MQTT | modality 是 video/radar；ONVIF/RTSP/MQTT 属于 protocol | 文档严格区分模态、设备种类、协议和能力 |
---
## 3. 最终产品信息架构
### 3.1 Sense Edge Console
Sense 保持最多五个一级入口，移动端底部导航不超过五项：
```text
运行总览
实时监控
设备
接入任务
运维
├─ 对账与孤儿资源
├─ 媒体分片
├─ 边缘节点与隧道
├─ 运维告警
└─ 系统状态
```
原“系统状态”并入“运维”。总览的待收敛项、设备告警和分片状态均可下钻到运维的对应子页。Sense 顶栏显示当前租户、站点、用户和角色，并消费 Bell 下发的授权上下文，但不自建租户/RBAC 真相源。
### 3.2 Bell / 统一管理端
以下能力归 Bell/统一管理端，而不是在 Sense 重复建设一级页面：
- Tenant、Site、Area 管理和 RBAC。
- Area 的 `capture_policy` 编辑与已有成像设备的显式处置流程。
- 全局审计查询；Sense 设备操作记录只提供带设备筛选的深链。
- `site.max_video_channels` 的配置与真相源。
Area 与策略由 Bell 持有，Sense 使用带版本的只读投影执行新增/启用准入；投影未知或过期时 fail closed，只阻止新的成像变更，不中断已有链路。
---
## 4. 采纳的真实缺口
### 4.1 对账与运维中心（P0）
- 未收敛项展示期望态/实际态具体差异、重试次数、退避间隔和下次重试时间。
- 手动动作语义为“提高优先级并重新触发收敛”，不能绕过对账器直接修改实际资源。
- 展示孤儿资源、占比、10% 安全闸及人工处置提示；不提供绕过安全闸的一键删除。
- 展示媒体分片、边缘节点、控制隧道、数据面、补传队列和独立运维告警。
- 明确“控制隧道断开但已有视频数据面仍正常”的组合态。
### 4.2 设备能力来源（P0）
`capabilities` 必须来自探测/适配器结果并保存来源、探测时间与版本，不能由前端名称猜测。详情展示“已探测能力”和“当前生效能力”；重新探测显示新增/消失差异，能力降级时列出受影响的触发、Profile 或空间配置。
US-007 的采购白名单当前仍是版本化测试文档，无产品 UI；运行设备可只读显示“白名单型号/未验证型号”，不把白名单管理升级成 M2 P0 页面。
### 4.3 非视频适配器阶段态（P0）
M1～M5 可登记 radar 等模态以验证信息架构和隐私准入，但实际态必须是 `adapter_not_ready`（用户文案“适配器未就绪 · M6”），不得显示在线/离线或模拟 MQTT 遥测连接，也不计入视频配额。
### 4.4 设备生命周期（P0）
- 待激活作为可筛选状态，支持重新探测、校时、配额/策略复核、激活和逐项失败原因。
- 认证失败与离线分开；更新凭据只写不读、不回显旧值，更新后显示重试结果。
- 批量凭据仅允许安全导入逐设备凭据，不提供把同一密码覆盖到多台设备的一键操作。
- Profile 切换展示对当前观看、推理、区域校准与短暂中断的影响。
### 4.5 写入降级与权限（P0）
- 配额不可读：列表与已有视频可用，新增/启用被阻止。
- Area 策略投影不可读/过期：只阻止新的成像变更，已有链路保持现状并告警。
- 只读角色隐藏写操作；越权或资源不存在的深链使用统一安全拒绝态。
- 原型角色切换器只用于枚举状态，不代表 Sense 拥有账号或权限数据。
### 4.6 措辞与可观察结果（P0）
“暂停推理”统一为：
> 解除推理侧对该路的订阅；有其他观看者时上游继续拉流，无其他 reader 时上游按需停止。
执行结果同时显示推理订阅、reader 数和上游拉流状态，避免实现成推理插件内部直接 `return` 而持续浪费带宽。
---
## 5. 降级或后置的建议
| 原建议 | 最终处理 |
| --- | --- |
| Sense 新增“站点与区域”一级导航 | 不采纳；Bell/统一管理端持有管理页，Sense 顶栏只做站点上下文切换 |
| Sense 新增“审计”一级导航 | 不采纳；保留设备操作记录并深链 Bell 全局审计 |
| 直接批量覆盖同一设备密码 | 不采纳；仅做逐设备写入或安全文件导入 |
| M2 提供跨媒体分片迁移 | 后置 M4；本轮只展示分片详情与影响范围 |
| M2 提供节点升级/重启 | 后置独立高风险运维任务；本轮只展示状态 |
| 提前为推理绑定、pre-roll、设备型触发创建空页面 | 不采纳；能力模型与运维子导航已保留扩展，不创建无操作价值的占位页 |
---
## 6. 审计接口的独立架构任务
Bell 是全局审计真相源，但 T-004 不修改 `docs/api.md`。后续任务需要冻结 Sense → Bell 审计投递或等价投影契约，至少包含：
- Sense 在执行高风险写操作前，把操作意图与审计 outbox 在本地持久化；不能“先执行后尝试记录”。
- Bell 不可达时，只要本地 outbox 已持久化，业务操作可继续；恢复后幂等补投。
- 明确租户/站点范围、事件 ID、操作者、目标、请求结果、重试与保留策略。
此项属于 API/一致性设计，不用原型中的 toast 代替契约。
---
## 7. 本轮实施边界
T-004 重新生成 Sense 原型并补 Bell 管理端入口，同时更新正式 US/IX 和本复核稿。`docs/api.md`、生产代码、事件 v0.1 与真实认证实现不在本任务修改；人工确认前 T-004 继续保持 `DOING`。
docs/raw/12-Sense原型-待办清单.md
+189
View File
@@ -0,0 +1,189 @@
# Sense 原型待办清单（第二轮复核后执行版）
> 来源：《09-Sense原型评审-IX草稿》《10-Sense原型-功能模块缺口》《11-Sense原型-第二轮缺口》
> 基准：Sense 提交 `e18a1ea`
> 适用任务：T-004
> 原则：按产品边界执行，不把 Sense 一级导航扩成 8 项
---
## 1. 状态说明
- `本轮`：T-004 第三轮原型必须完成。
- `后置`：已确认方向，但不在本轮画完整动作。
- `独立任务`：写路径或契约不同，不在 T-004 顺带修改。
- `完成`：当前原型已有，不重复实现。
---
## 2. 最终导航与系统归属
### Sense（五个一级入口）
```text
运行总览 · 实时监控 · 设备 · 接入任务 · 运维
```
“运维”内部使用二级 Tab：对账、分片、边缘节点、运维告警、系统状态。移动端底部导航保持五项。
### Bell / 统一管理端
- Tenant / Site / Area 与 `capture_policy` 管理。
- RBAC 与当前用户授权上下文。
- 全局审计查询和设备筛选深链。
- 站点视频配额真相源。
Sense 只消费上述上下文和带版本投影，不复制真相源。
---
## 3. 本轮执行项
### S-01 运维中心与对账队列 · P0 · 本轮
- 总览“待收敛项”可下钻。
- 展示期望态/实际态差异、重试次数、退避间隔、下次重试时间。
- “重新触发收敛”只提高任务优先级，不直接绕过对账器修改资源。
- 展示孤儿资源与 10% 安全闸；安全闸触发时禁止删除并说明人工恢复路径。
- 分片、边缘节点、运维告警和系统状态作为运维二级页。
验收：能打开某个未收敛项并查看差异；能看到安全闸和下一次重试时间。
### S-02 角色与安全拒绝态 · P0 · 本轮
- 顶栏显示当前用户和角色，提供“站点管理员/只读”原型切换。
- 只读模式隐藏新增、激活、停用、更新凭据、保存区域等写操作。
- 越权深链显示统一拒绝态，不泄露资源是否存在。
- 角色切换只是原型演示，授权真相源仍在 Bell。
### S-03 租户/站点上下文与 Area 归属 · P0 · 本轮
- Sense 顶栏显示当前租户并支持站点切换；切换后示例列表与计数同步更新。
- Bell 增加站点/Area 管理入口，展示配额来源与 `capture_policy`。
- 把已有视频设备的 Area 改为 `non_imaging_only` 时，要求先迁移设备、取消修改或进入显式处置流程，不静默停用。
### S-04 全局审计深链 · P1 · 本轮
- Sense 不新增一级审计页。
- 设备详情“操作记录”增加“在 Bell 查看全部审计”，携带 tenant/site/device 筛选上下文。
- Bell 审计页消费这些参数并显示来源为 Sense。
### S-05 capabilities 探测与差异 · P0 · 本轮
- 详情显示厂商、型号、固件、认证方式、Profile、校时与 ONVIF 事件订阅能力。
- 区分已探测能力与当前生效能力，记录上次探测时间。
- “重新探测”显示新增/消失能力及受影响配置，不自动覆盖。
- 只读显示采购白名单结果；白名单维护继续使用 M0 文档，不新增管理页。
### S-06 适配器未就绪 · P0 · 本轮
- radar 可登记并进入台账，但实际态为“适配器未就绪 · M6”。
- 不显示在线/离线、MQTT 实时遥测或测试连接成功。
- 不计入视频配额，仍参与 `non_imaging_only` 准入判断。
### S-07 待激活闭环 · P0 · 本轮
- 状态筛选包含待激活，列表至少有一条示例。
- 详情提供重新探测、校时、配额/区域策略复核和激活。
- 批量激活展示逐项成功/失败及可重试原因。
### S-08 认证失败与凭据更新 · P0 · 本轮
- 认证失败作为独立实际态。
- 凭据更新只写不读，不回显旧值；更新后自动重试并显示结果。
- 批量场景仅演示安全文件逐设备导入，不提供同一密码批量覆盖。
### S-09 写入降级态 · P0 · 本轮
- 状态演示新增“配额不可读”和“区域策略不可读”。
- 两态下实时监控和设备读取保持可用；新增/启用等相关写操作禁用并就地解释。
- 已有设备不被伪装为停用或已收敛。
### S-10 边缘节点与隧道 · P1 · 本轮
- 展示节点版本、在线时长、承载数、控制隧道、视频数据面和补传队列。
- 至少演示“隧道断开 / 视频数据面正常”和“恢复后补传”组合态。
- 节点升级/重启只显示为后置能力，不提供可执行按钮。
### S-11 Profile 切换 · P1 · 本轮
- 展示主/子 Profile 和当前用途。
- 切换前说明短暂中断、reader、推理和区域待校准影响。
- 原型不执行真实媒体操作。
### S-12 分片详情 · P1 · 本轮（迁移后置）
- 展示承载设备、实际码率、重连历史与单分片故障影响范围。
- 标注 32 为可配置建议容量，最终由压测确定。
- 跨分片迁移动作后置 M4，本轮不提供按钮。
### S-13 批量任务与逐项结果 · P0 · 本轮
- 任务列表、预校验结果、逐行失败原因、单行/失败项重试、错误清单导出。
- 明确部分成功语义：成功项已经生效，失败项可重试，不做整体回滚。
### S-14 运维告警 · P1 · 本轮
- 展示离线、认证失败、时间漂移、收敛失败、分片异常和隧道断开。
- 明确运维告警不会进入 Bell 业务预警队列或通知家属。
- 运维静默/通知配置后置，原型只显示入口归属。
### S-16 时间显示口径 · P1 · 本轮
- 默认显示服务器时间与时区。
- 相对时间同时提供完整时间戳；设备时间只在漂移语义中出现。
- 审计和对账示例使用同一口径。
### S-17 当前租户 · P1 · 本轮
- 顶栏显示当前租户；首期私有部署不提供租户切换器。
- 原型文案说明列表已经按认证上下文的 tenant/site 过滤。
### S-18 暂停推理措辞与结果 · P0 · 本轮
- 文案改为“解除推理侧订阅；无其他 reader 时上游按需停止”。
- 结果展示推理订阅、reader 数和上游拉流状态。
### S-19 分片容量标注 · P2 · 本轮
- `32` 标注为“当前配置/建议容量”，不是产品硬上限。
---
## 4. 已完成，不重复执行
| 编号 | 状态 | 证据 |
| --- | --- | --- |
| S-15 设备分页 | 完成 | 5 条/页、上一页/下一页、页数和总数已实现 |
| S-20 推理收敛视觉 | 完成 | 已改为绿色“推理配置收敛 16/16” |
| 第一轮 IX-014～IX-018 | 完成 | 模态/能力、三种停用、隐私准入、几何方向、草稿和深链均已落地 |
---
## 5. 后置与独立任务
| 编号 | 处理 |
| --- | --- |
| S-21 Sense → Bell 审计契约 | 独立任务修改 `docs/api.md`；采用本地持久化 transactional outbox + 幂等补投 |
| S-22 推理绑定运维 | M3 在“运维”内新增二级能力，不预建空页面 |
| S-23 pre-roll 运维 | M3 需求稳定后新增，不预建空页面 |
| S-24 设备型触发配置 | M6 随非视频适配器实现，不预建空页面 |
| 跨媒体分片迁移 | M4 容量/分片任务 |
| 节点升级/重启 | 独立高风险运维任务，需要权限、回滚和维护窗口 |
---
## 6. 总验收
- [x] Sense 一级导航保持 5 项，移动端不出现第 6 个底部入口。
- [x] 运维中心可查看未收敛差异、退避、孤儿与安全闸。
- [x] 只读角色下所有写操作消失，越权深链显示安全拒绝态。
- [x] radar 显示“适配器未就绪 · M6”，不显示在线或模拟遥测成功。
- [x] 能力重新探测显示差异，能力降级不自动覆盖依赖配置。
- [x] 待激活、认证失败、凭据更新和逐项激活结果可演示。
- [x] 配额/策略不可读时只阻止相关写操作，已有流与读取可用。
- [x] “暂停推理”展示订阅、reader 和上游拉流结果。
- [x] Bell 可管理 Site/Area 策略并显式处理已有成像设备。
- [x] Sense 设备审计深链到 Bell，并保留 tenant/site/device 筛选。
- [x] 1440×900、375×812、812×375 无页面级横向溢出；主要移动控件不小于 44px。
- [x] 运行时无异常，`git diff --check` 与 `./init.ps1` 通过。
docs/raw/14-Bell原型评审.md
+57
View File
@@ -0,0 +1,57 @@
# Bell 原型评审（复核定稿）
> 评审对象：`docs/design/bell/index.html`
> 输入：Claude 首轮评审草稿；YoVision 需求、架构、US、IX 与路由文档
> 复核日期：2026-08-04
## 1. 结论
Claude 指出的投递状态、Event↔Alert 关系、交接班、分页、规则回滚和验收报表缺口成立，应在 T-004 内修复。Area 归属、并发 ack、失败态和重启可观测性的部分结论需要校正；另外原评审遗漏了移动端管理入口与审计深链注入风险。
## 2. 本轮采纳
| 优先级 | 项目 | 最终要求 |
| --- | --- | --- |
| P0 | 投递事实 | `sent`、`delivered`、`seen`、`ack` 分开；不支持回执、状态未知、可重试失败和最终失败不得伪装为成功。ack 属于 Alert 处置事实，不是通道投递状态。 |
| P0 | Event↔Alert | Alert 详情展示关联 Event 与聚合原因；Event 详情展示触发的 Alert 与最终状态；两边可导航。抑制可能不创建 Alert，不能把“已处置抑制”误写成聚合原因。 |
| P1 | 并发 ack | 首个服务端成功者成为处置人；后到者看到当前处置人与确认时间，不能覆盖，也不能显示双成功。 |
| P1 | 交接班 | 展示未 ack、处置中和升级中的 Alert；明确交出人、接手人、备注和确认审计；交接期间升级链不中断。 |
| P1 | 局部失败 | 保留弱网证据降级；新增会话过期、ack 竞争结果、规则版本冲突，以及投递的可重试/最终失败。失败应靠近对应操作，不扩展成无意义的全页状态集合。 |
| P1 | 分页 | 事件中心和审计日志均提供总数、页码、上一页与下一页，不一次加载全部记录。 |
| P2 | 规则回滚 | 查看版本差异与影响范围；回滚通过创建并发布新版本完成，历史版本不可变。 |
| P2 | 验收报表 | 按规则版本和冻结样本窗口报告召回率、每路每天误报数及样本量；明确不提供跨场景统一“准确率”。 |
## 3. 校正与不采纳
1. Area 已在 `raw/12`、US-010、IX-016 和架构文档中冻结为 Bell 管理，Sense 只消费版本化投影；“重写 S-03”属于过期建议，本轮不重复修改。
2. 《13》A-2 的同库只读视图是独立架构裁决，不因原型评审直接采用。本轮继续保持 Bell 真相源与受控 API/投影边界，不修改 schema、API 或跨库访问方式。
3. 原型已有并发 ack 文案，但没有可演示的竞争结果，因此补交互而不是从零新增概念。
4. `weak` 已覆盖结构化事件成功、视频证据失败的部分成功态；“一个失败态都没有”不准确。本轮补操作级失败和会话过期，不机械增加三个全局错误页。
5. 进程重启续跑是后端恢复、指标和测试要求。正常值班时间线不展示内部服务重启；只有确实影响用户的异常恢复才进入业务时间线，本轮不添加常态重启节点。
## 4. 原评审遗漏
- 移动端底部主导航继续限制为 5 项，但通过顶部“管理”入口访问站点与 Area、审计日志，避免管理能力在窄屏不可发现。
- 桌面侧栏分成“值班与业务”和“管理”两组，避免权限与运营入口混在同一层级。
- Sense→Bell 审计深链的 `device` 参数不得通过 `innerHTML`/`insertAdjacentHTML` 拼接；必须按文本节点写入并对返回链接编码，防止原型把不可信查询参数变成 DOM 注入。
## 5. 实施顺序
1. 修复审计深链注入。
2. 补投递状态模型和 Event↔Alert 双向关系。
3. 补并发 ack、交接班与操作级失败。
4. 补事件/审计分页和移动端管理入口。
5. 补规则回滚与按规则版本的验收报表。
6. 用桌面、竖屏手机和横屏手机验证可访问性、无横向溢出及运行时安全；人工确认前 T-004 继续保持 `DOING`。
## 6. 产品裁决补充：联系人、排班与升级策略
采纳“联系人管理和排班一次设计到位”的方向，但将“同源”修正为“共享主数据、分对象建模”：
- 联系人/成员保存身份、角色、值班组和已验证通知通道，不承载班次与轮换字段。
- 值班排班引用联系人或值班组，保存站点时区、班次、周轮换、生效日期、临时替班、版本和冲突校验，不复制手机号。
- 升级策略的每一步使用 `person / team / on_call_schedule` 类型化目标，不直接写号码；界面提供当前解析人与通道预览。
- 每次投递创建时固化实际收件人、通道与排班版本快照，后续联系人或排班变更不改写历史事实。
- 交接班只转移进行中 Alert 的处置责任；未来班次变化必须走临时替班并发布新排班版本。
信息架构继续保留一级“升级链”，内部以“升级策略 / 值班与排班 / 联系人与通道”三个二级模块渐进披露。M3 原型覆盖周轮换、时区、生效日期、替班、空档/重叠冲突、值班人预览、版本发布和审计；自动排班优化、外部日历同步、工时合规与自助换班后置，不在 T-004 扩展。
docs/routes.md
+9 -6
View File
@@ -9,13 +9,14 @@
| `/overview` | 站点、设备、事件和预警摘要 | 业务预警与运维告警分区 |
| `/sites` | 站点列表、配额与状态 | 显示 16 默认/128 上限，不暗示单机能力 |
| `/sites/:siteId/devices` | 设备列表、批量导入/启停、健康 | 分页/虚拟列表、逐项结果、不泄露凭据 |
| `/events` | 事件筛选与批量处置入口 | 事件与预警状态分开显示 |
| `/events/:eventId` | 事实、证据、时间线、outcome | 权限最小化；弱网渐进加载 |
| `/alerts` | 待 ack、升级中、已结束预警 | 清楚区分投递/送达/看到/ack |
| `/rules` | 场景包、规则继承、区域/时段配置 | 显示继承来源与试运行状态 |
| `/escalations` | 联系人、通道、超时与静默 | 双路径；静默 ≤4h，无永久项 |
| `/events` | 事件筛选与批量处置入口 | 事件与预警状态分开显示；服务端分页，不一次加载全量 |
| `/events/:eventId` | 事实、证据、时间线、outcome 与触发的 Alert | 权限最小化；弱网渐进加载；与 Alert 双向导航 |
| `/alerts` | 待 ack、升级中、已结束预警 | 清楚区分已发出/已送达/已看到/ack；支持值班交接 |
| `/alerts/:alertId` | Alert 处置、投递/升级事实与关联 Event | 展示聚合原因；ack 竞争不覆盖；与 Event 双向导航 |
| `/rules` | 场景包、规则继承、区域/时段配置 | 显示继承来源、试运行、不可变版本和回滚状态 |
| `/escalations` | 升级策略、值班排班、联系人和通道 | 一个一级入口下渐进展示三个二级模块；共享人员/值班组/已验证通道主数据但分对象建模；策略使用人员/组/排班类型化目标，支持解析预览、排班版本/替班/冲突与投递快照；双路径，静默 ≤4h，无永久项 |
| `/operations` | 设备/流/分片/对账运维 | 不与业务预警混在同一队列 |
| `/audit` | 审计查询 | 只读、分页、按权限脱敏 |
| `/audit` | 审计查询 | 只读、服务端分页、按权限脱敏；深链筛选参数仅按文本渲染 |
这些是页面职责占位，不等于已冻结 URL；实现任务须更新本文件后再编码。
@@ -26,6 +27,8 @@
- 设备：最小健康状态，不提供未经授权的常态监控。
- 我的：联系人、通知偏好和限时静默。
Bell 响应式管理端的底部主导航最多 5 项；Site/Area、RBAC 与审计通过顶部“管理”菜单进入，不能因为窄屏隐藏侧栏而失去入口。桌面侧栏把值班/事件/规则/升级/报表与 Site/Area/审计分组显示。
## 值班台/大屏
- 实时事件流与高优先级预警。
docs/tasks/T-004.md
+116 -17
View File
@@ -3,47 +3,67 @@ id: T-004
title: 设计 Sense 与 Bell 交互原型
phase: 0
deps: [T-002]
status: TODO
status: DONE
created: 2026-08-03
issue: 6
context_ref: null
claim_branch: null
work_branch: null
context_ref: 32b9859a405a4d64c03b6d3ae765340bc37fdfa0
claim_branch: claims/T-004
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
---
## 问题 / 背景
Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前，需要用两个零构建依赖的单文件 HTML 原型枚举导航、控件、主要状态与高频工作流，避免直接从实现代码猜交互。Sense 可参考 MiBeeNvr 的监控、摄像头与仪表盘信息架构，但必须补齐 YoVision 的设备健康、分片/期望态、批量开通和区域/警戒线编辑；Bell 必须体现事件与 Alert 分离、ack、升级链、证据、误报和权限边界。
产品评审进一步区分“检测区域”和“告警规则”：前者依附具体摄像头画面、分辨率与坐标系，应在摄像头详情中编辑；后者包含场景、继承、时段、持续时间、试运行、发布与升级链，应由 Bell 管理。后端系统边界不得迫使用户丢失当前摄像头或规则草稿上下文。
## 关联需求与交互（如适用）
- 用户故事：Sense 关联 US-001、US-002、US-005；Bell 关联 US-003～US-006。
- 交互清单：Sense 关联 IX-001～IX-004、IX-010～IX-011；Bell 关联 IX-005～IX-013。
- 相关页面 / 路由：原型阶段为 `docs/design/sense/index.html` 与 `docs/design/bell/index.html`，不定义生产路由。
- 用户故事：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。
## 方案
1. 使用统一的 YoVision 深色安防控制台设计系统，Sense 与 Bell 保持品牌、状态色、控件和导航规律一致。
2. Sense 制作为单页可交互工作台：总览、监控墙、设备、区域规则、接入任务和系统状态；区域编辑器支持多边形、警戒线、撤销、清空、键盘替代和保存反馈。
3. Bell 制作为单页可交互值班台：预警队列、事件证据、ack/处置、升级时间线、误报反馈、规则和升级链概览。
4. 两个原型均内联 CSS/JS，使用假数据，不加载真实视频、客户信息、生产地址或外部依赖；顶部固定标注原型用途。
5. 完成桌面、窄屏、键盘焦点、加载/空态/错误切换和 `prefers-reduced-motion` 检查，提交人工评审；产品确认前不把任务标为 `DONE`。
2. Sense 制作为单页可交互工作台：总览、监控墙、设备、接入任务和运维中心，移动端也固定为这 5 个入口；不设置一级“区域规则”或全局管理页。运维中心聚合对账、分片、边缘/隧道、运维告警和系统状态。统一设备台账使用 `modality + capabilities` 决定详情页和操作，M1～M5 完整展示视频设备，非视频设备在 M6 前明确显示 `adapter_not_ready`，不得虚构遥测。
3. 视频设备在“画面与检测区域”页签完成多边形、方向警戒线、显式完成、方向反转、逐点编辑、会话草稿恢复、乐观并发冲突和待校准反馈；Sense 只保存空间几何并只读显示关联规则，不提供业务规则绑定、时段、持续时间、试运行或正式发布。
4. Bell 制作为单页可交互值班台和统一管理端：通道的已发出/已送达/已看到与 Alert ack 分开，Event↔Alert 可双向导航；并发 ack 显示真实处置人，班次交接不暂停升级链；规则编辑必须选择摄像头与检测区域版本，并负责继承、时段、持续时间、试运行、发布和以新版本完成回滚；Bell 同时管理 Site/Area/配额/`capture_policy`，策略与已有成像设备冲突时必须显式迁移或取消。
5. Sense 摄像头详情与 Bell 规则草稿通过可演示的相对深链互相进入，携带摄像头/区域上下文；原型可以跨文件，但生产产品不得要求用户重新查找同一摄像头或丢失未完成草稿。
6. 两个原型均内联 CSS/JS，使用假数据，不加载真实视频、客户信息、生产地址或外部依赖；顶部固定标注原型用途。
7. 添加设备时先选择类型，依据能力渐进展示字段；区域的 `capture_policy` 负责隐私准入，视频设备在“仅非成像设备”区域中的新增或启用必须被阻止，策略不可用时对新写入失败关闭。
8. 全局头部展示租户、站点、账号和角色；只读角色隐藏写操作，深链越权不泄露资源是否存在。Sense 设备日志带租户/站点/设备条件跳到 Bell 全局审计并可返回。
9. 完成桌面、窄屏、横屏、键盘焦点、加载/空态/错误/依赖降级切换和 `prefers-reduced-motion` 检查，提交人工评审；产品确认前不把任务标为 `DONE`。
10. Bell 事件与审计列表必须分页；规则验收报表按规则版本和冻结样本窗显示召回率与每路每天误报数，不提供跨场景统一准确率；移动端底部主导航保持 5 项，通过顶部“管理”入口访问 Site/Area 与审计。
11. Bell 一级“升级链”内部统一设计升级策略、值班与排班、联系人和通道三个二级模块：共享人员/值班组/已验证通道主数据但分对象维护；升级步骤引用人员/组/排班类型化目标，排班支持时区、周轮换、生效日期、临时替班、冲突检查、解析预览、版本发布和审计，投递保留解析快照。
## 不可变约束
- 阈值 / 数值边界：默认 16 路、单站点上限 128 路；静默最长 4 小时；原型不得暗示 128 路同时播放主码流。
- 判定式 / 状态转换：事件事实不可被处置改写；Alert 的首次投递、送达、看到、ack 和升级必须分开展示；区域规则正式发布与试运行必须可区分。
- 阈值 / 数值边界：默认 16 路视频、单站点视频上限 128 路；非视频设备不占视频路数；单媒体分片初始配置建议 `max_streams=32`、当前示例承载 16、最多 4 个分片，最终以压测为准；静默最长 4 小时；原型不得暗示 128 路同时播放主码流。
- 判定式 / 状态转换：事件事实不可被处置改写；Alert 的首次投递、送达、看到、ack 和升级必须分开展示；检测区域版本与告警规则版本是不同对象；规则正式发布与试运行必须可区分，保存区域不得自动发布规则。
- 安全边界：不得展示摄像头密码、完整 RTSP/ONVIF 地址、token、真实客户/未成年人数据或人脸入口；破坏性动作须确认。
- 既有契约：原型不修改事件 v0.1、API、路由和生产技术栈，不作为生产实现代码。
- 既有契约：原型不修改事件 v0.1、API、schema、生产路由实现和生产技术栈；仅补充候选路由职责，不作为生产实现代码。
## 验收要点
- 任务相关验证：两个 HTML 可本地打开、无外部依赖；关键按钮和状态切换可用；运行 HTML 结构检查、`git diff --check` 与 `./init.ps1`。
- 完整门禁：本任务不修改 schema/API/路由，因此不触发契约与导航实现门禁；若范围变化则先更新任务。
- 任务相关验证：两个 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`；双击浏览器打开，零构建依赖。
@@ -56,13 +76,92 @@ Sense 与 Bell 尚无可供产品确认的页面结构。生产 UI 开工前，
- 责任 Agent：codex。
- 唯一写入者：codex。
- 委派：不启用。
- Gitea：主 Issue 为 #6；领取必须从精确 `context_ref` 建立 claim 与工作分支。
- Gitea：主 Issue 为 #6；`context_ref` 为 `32b9859a405a4d64c03b6d3ae765340bc37fdfa0`，claim 为 `claims/T-004`，工作分支为 `agent/codex/T-004`。
任何新增写路径先检查与其他活跃任务是否重叠；同一时刻只有一个 Agent 修改本任务的 `write_paths`。
## 执行记录
### 2026-08-04 人工验收通过与任务完成
- 项目负责人确认 Sense 与 Bell 原型均可接受，人工验收门禁通过；确认范围包括最终页面信息架构、控件集合、主要工作流，以及 Bell 最新的“升级策略 / 值班与排班 / 联系人和通道”分对象设计。
- 两份原型的任务相关自动化验证已在前述执行记录中完成：HTML/脚本静态检查、桌面与窄屏浏览器交互、无横向溢出、运行时无异常、`git diff --check` 与 `./init.ps1` 均通过。
- T-004 状态更新为 `DONE`。本次确认冻结原型阶段的产品方向；后续生产实现、API/schema 契约和高级排班能力仍须另立任务，不由本任务隐含扩展。
### 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 注入。
- Bell 桌面侧栏分为“值班与业务”和“管理”，移动端底部导航继续固定 5 项并增加顶部“管理”菜单。投递时间线分开展示已发出、已送达、已看到、无回执、通道不支持、可重试与最终失败，Alert ack 继续独立。
- Alert 详情与 Event 详情支持双向打开并展示聚合/未触发原因；补齐服务端首个成功者语义的并发 ack 演示、值班交接、事件/审计分页、会话过期、规则版本冲突、不可变新版本回滚和按规则版本的验收效果表。
- 审计深链不再把 `device` 查询参数拼入 HTML，改为 `textContent` 与 DOM 节点构造；恶意 `<img onerror>` 参数专项验证未创建节点、未执行脚本且保持安全文本显示。本轮不采纳 A-2 数据库视图，不修改 API/schema，也不在正常值班时间线展示内部服务重启。
- Node.js 内联脚本语法、124 个唯一 ID、按钮可访问名、外部依赖和危险 DOM API 静态检查通过。Edge/CDP 在 1440×900、375×812、812×375 验证投递事实、双向关系、并发 ack、交接、分页、规则冲突/回滚、验收报表、会话过期、移动管理与深链注入：页面级无横向溢出，移动导航与管理入口不小于 44px，运行时 0 exception；桌面值班台和窄屏管理页已目检，临时 QA 脚本未写入仓库。
- 自动化验收完成后任务仍保持 `DOING`；项目负责人必须打开 Bell 原型确认信息架构、投递语义和交接/回滚流程，确认前不合并 PR、不标记 `DONE`。
### 2026-08-04 第二轮缺口复核与最终实现
- 复核 `raw/11`、`raw/12` 后保留对账、能力探测、设备生命周期、RBAC、写入降级、边缘隧道与运维告警等真实缺口；纠正“原型无分页”“分片 8 / 32”“雷达已有真实能力”“T-004 只允许 3 个写路径”等过期事实，并把 M4/M6 能力标为后续阶段而非本轮失败。
- 产品 IA 冻结为 Sense 5 个一级入口：运行总览、实时监控、设备、接入任务、运维中心。Tenant/Site/Area/RBAC/配额/全局审计归 Bell；Sense 仅呈现当前管理上下文并消费版本化配额/Area 策略投影。该决定已同步 US-009/US-010、IX-019/IX-020、正式需求、架构及三份原始分析文档。
- Sense 按显著改版规则整页重新生成：补齐待激活、认证失败、写入型凭据更新、能力探测来源/时间/生效差异、`adapter_not_ready`、逐项任务结果、暂停推理 reader/upstream 结果、对账差异/退避/孤儿安全闸、16/32 分片注释、边缘隧道/补传、独立运维告警、配额/策略不可用时只禁用相关写入，以及只读/越权状态。
- Bell 增加 Site/Area 管理、配额/策略投影状态与策略冲突显式迁移/取消；审计页能消费 Sense 的 `tenant + site + device + return_to` 上下文并返回设备详情。跨系统审计实现约定为 Sense 本地事务 outbox + 幂等 relay，但具体 API/签名/重放/留存仍需独立契约任务，本任务不修改 `docs/api/`。
- Node.js 内联脚本语法、唯一 ID、表单标签、按钮可访问名、Tab 契约和外部资源静态检查通过。Edge Headless/CDP 在 1440×900、375×812、812×375 验证上述关键流程：两页页面级无横向溢出，移动端可见主要控件不小于 44×44px，控制台与运行时均 0 exception；运维中心与 Bell Site/Area 页面截图已人工目检，临时 QA 文件未写入仓库。
- `./init.ps1` 通过：上下文/治理检查、16 个治理单测全部成功；`git diff --check` 通过。自动化验收已完成，任务继续保持 `DOING`，等待项目负责人打开原型进行必需人工确认；确认前不合并 PR。
### 2026-08-04 Claude 评审续修立项
- 项目负责人提供 `docs/raw/09-Sense原型评审-IX草稿.md` 并确认按复核后的最终建议继续修改。复核结论为：设备模态、停用收敛、隐私准入、几何编辑、草稿恢复与无障碍问题方向成立，但分片容量来源、页内草稿丢失和双向深链现状等证据需纠正。
- T-004 继续保持唯一活跃任务；dispatcher 已在 Issue #6 发布 `CLAIM RENEWAL`，将本轮涉及的评审稿、US/IX、需求/架构与 Sense/Bell 原型加入 `write_paths`。当前没有其他活跃任务占用这些路径。
- 本轮按 `docs/design/README.md` 的显著改版规则重新生成 Sense 页面结构，不恢复一级“区域规则”；一级入口改为“设备”，详情按 `modality + capabilities` 渐进展示，视频设备仍在详情中维护画面检测区域，Bell 继续独占业务规则与发布。
### 2026-08-04 Claude 评审续修实现与自测
- 将评审结论回写到需求、架构、用户故事和 IX：设备以 `modality + capabilities` 建模，隐私策略归属 Area；M2 冻结通用信息架构与视频准入，M6 再实现非视频适配器。明确幂等只消除重复副作用，每次请求仍写审计；暂停推理、停用接入和断开会话为三个不同动作。
- Sense 已重构为通用设备台账：17 台示例设备、5 条/页、类型/状态/搜索筛选，视频配额单独显示为 16 / 128；雷达详情展示遥测能力和通用健康且隐藏视频区域页签。添加设备对话框按能力切换字段，并验证视频设备会被“仅非成像设备”区域阻止、雷达仍可接入。
- 区域编辑补齐显式完成、警戒线箭头与方向反转、逐点键盘编辑/删除、双击防重复顶点、`sessionStorage` 会话草稿恢复、版本冲突阻止覆盖；工具切换会先确认，页内导航不清除草稿。Sense 与 Bell 双向链接统一携带 `camera + zone + return_to`，Bell 会读入并保留区域上下文。
- Node.js 内联脚本编译、唯一 ID/标签目标/外部资源静态审计均通过；关键前景/背景组合对比度为 5.93～16.43:1。Edge Headless/CDP 在 1440×900、375×812 与 812×375 实测设备筛选、雷达详情、隐私准入、区域方向与冲突、Tab 方向键、停止操作收敛和双向深链；页面级无横向溢出、移动端无低于 44px 的可见主要控件、运行时 0 exception。截图已人工检查且未写入仓库。
- 任务仍保持 `DOING`：需项目负责人打开两份原型确认最终信息架构与主要工作流，确认前不合并 PR、不标记 `DONE`。
### 2026-08-03 任务定义
- 依据用户请求、US-001～US-006、IX-001～IX-013 和 MiBeeNvr 本地只读截图定义两个单文件原型范围。
- 人工验收为必需门禁；原型完成后先进入评审，不自动视为最终设计。
### 2026-08-03 领取与基线
- 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`。
### 2026-08-04 产品评审修订
- 项目负责人指出 Sense 的区域规则没有融合到摄像头模块。复核 US-001/US-002 与 US-005 的角色和任务后，确认原型把“摄像头空间几何”和“业务告警规则”混为同一一级模块，且让微服务边界影响了用户操作路径。
- 采纳“领域分离、体验连续”的产品方案：Sense 摄像头详情维护检测区域与校准状态；Bell 维护业务规则、试运行和正式发布；通过携带摄像头/区域上下文的深链连接两个原型。
- `ui-ux-pro-max` 的导航层级、渐进披露、深链与状态保持原则用于本轮修订；默认 16 路从摄像头详情进入，128 路仍通过设备列表的筛选、分页与区域状态列治理，不恢复独立的一级区域编辑入口。
### 2026-08-04 修订后自测
- 标准库 HTML 审计通过：Sense 69 个唯一 `id`、40 个有名称按钮、16 个有标签控件；Bell 67 个唯一 `id`、50 个有名称按钮、21 个有标签控件；两页均无外部 HTTP 资源。专项断言确认 Sense 不再存在一级 `zones` 页面、规则发布按钮或试运行开关。
- Node.js 对两个内联脚本执行语法编译检查通过。Edge Headless/CDP 在 1440×900 与 375×812 验证摄像头详情、坐标绘制、区域保存、画面参数变化后待校准、Sense→Bell 深链、Bell 规则草稿、Bell→Sense 返回链和正式发布确认；页面无横向溢出，控制台 0 error，运行时 0 exception。
- 浏览器测试首次发现 Sense 移动端区域画布受 `min-height + aspect-ratio` 影响发生横向溢出，并发现条件上下文条的 `hidden` 被组件 `display` 覆盖；两项均已修复并重新通过桌面/移动截图人工检查。临时 QA 截图未写入仓库。
- `./init.ps1` 通过：上下文校验、16 个治理单测与完整治理检查均成功；`git diff --check` 通过。任务继续保持 `DOING`，等待项目负责人确认修订后的信息架构与工作流。