From 2b222ffc8c2d943fa2a27d9e28ffaf4896143950 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Wed, 12 Aug 2026 18:14:54 +0800 Subject: [PATCH] docs: record Bell event and alert lifecycle rules (#36) --- Business-Rules-and-Glossary.-.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Business-Rules-and-Glossary.-.md b/Business-Rules-and-Glossary.-.md index f33bc25..8bdecbe 100644 --- a/Business-Rules-and-Glossary.-.md +++ b/Business-Rules-and-Glossary.-.md @@ -72,3 +72,19 @@ - **播放会话**：由当前 Sense 用户创建，最长两分钟；设备分页和媒体路径不以 16 路作为硬上限，页面一次只打开一路流。 - **区域版本**：坐标为 0..1 归一化值，并绑定 Device、Profile、宽高。每次发布或停用形成新版本；范围、点数、自交、退化、方向和期望版本由后端校验。Profile 分辨率变化后旧版本必须标记为需要重新校准。 + + + +## Bell MVP 业务与安全规则 + +- **独立身份**：Bell 仅接受自己的 `bell_session`；管理员管理用户、角色与规则，操作员读取事件/预警并处置，只读用户仅查询。后端权限是最终边界。 +- **安全初始化**：系统没有默认用户、密码或签名密钥；首次管理员密码只通过一次性进程环境传入，密码至少 12 位且包含大小写字母和数字。 +- **Event 与 Receipt**：Event 正文不可更新或删除。相同 `(producer_id, source_event_id)` 与相同 payload 返回原回执；相同键但不同 payload 返回冲突，跨进程重启仍成立。 +- **合成事件**：只在 development/test 注册，使用虚构匿名 fixture，并走与未来生产者适配器相同的 Event/Receipt 服务；production 直接请求返回 404。 +- **规则评估**：每个已接收 Event 都记录匹配或未匹配解释。匹配时固化实际规则快照；未匹配 Event 保持可查询，不能标成已通知或已处置。 +- **Alert 关联**：同一 Event 可产生多个 Alert；同一规则与地点的多个 Event 可聚合到同一未关闭 Alert，Event 与 Alert 双向可追溯。 +- **处置状态**：界面“待处理”对应新 Alert，“处理中/已看到”对应首个成功 ack，“已完成”对应记录现场结果后的 close。普通用户不需要理解 Event/Alert 内部模型，技术详情仍保留完整事实链。 +- **并发 ack**：PostgreSQL 条件更新只允许首个操作员成为处置人；后来者得到真实处置人，不能覆盖。 +- **close**：只有处置人或管理员可以完成；必须选择“确认有危险、误报、现场正常、无法确认”之一，可附备注。相同重复请求幂等，其他改变结果的请求被拒绝。 +- **审计事实**：成功生命周期事实只追加；失败、重复和拒绝尝试写入安全审计，但不记录令牌、密码或连接密钥。 + \ No newline at end of file