docs(design): close Sense second-review gaps
This commit is contained in:
QiuSW
@@ -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`，含 `modality + capabilities`；Area 持有 `capture_policy`
|
||||
- [ ] `devices` 表而非 `cameras`，含 `modality + capabilities`；Bell 持有 Area 与 `capture_policy`，Sense 只存带版本的准入投影
|
||||
- [ ] 设备身份用序列号
|
||||
- [ ] 触发入口独立成 handler
|
||||
- [ ] `sync_state` 每系统一行
|
||||
|
||||
Reference in New Issue
Block a user