88 lines
4.7 KiB
Markdown
88 lines
4.7 KiB
Markdown
<!-- gitea-wiki-mirror:start -->
|
|
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
|
|
wiki_page: Business-Rules-and-Glossary
|
|
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Business-Rules-and-Glossary.-
|
|
wiki_revision: 85ddfe99c2f9c97b18d5e39849a50b8c5fca276e
|
|
synchronized_at: 2026-08-14T01:17:28Z
|
|
<!-- gitea-wiki-mirror:end -->
|
|
|
|
# 业务规则与术语
|
|
|
|
## 核心术语
|
|
|
|
| 术语 | 定义 |
|
|
|---|---|
|
|
| Sense | 独立销售的视频接入、媒体、区域配置和运维产品 |
|
|
| Brain | 无界面的推理交付单元,输出观测和标准事件 |
|
|
| Bell | 独立销售的事件预警与处置产品 |
|
|
| Device | 设备根实体;通过 modality/capabilities 表达视频、雷达、门磁等能力 |
|
|
| Site | 一个客户部署中的站点边界 |
|
|
| Area | 多边形区域、警戒线及其隐私/准入策略 |
|
|
| Event | 已发生的不可变结构化事实及证据引用 |
|
|
| Alert | Bell 根据一个或多个 Event 和规则创建的处置对象 |
|
|
| ack | 明确由某人接手 Alert,不等同于消息已送达或已看到 |
|
|
| Outbox | 与本地状态同事务持久化、可重试投递的消息队列记录 |
|
|
| producer identity | Bell 为每个外部产品实例分配的机器身份 |
|
|
| 场景包 | 规则模板、升级策略、话术和报表口径的版本化配置包 |
|
|
|
|
## 工单状态
|
|
|
|
- 待确认:需求或方案等待负责人确认。
|
|
- 待实施:方案已确认,但依赖或排期尚未满足。
|
|
- 进行中:主 agent 正在工单声明的写路径内实施。
|
|
- 阻塞:出现计划外且当前无法解除的问题。
|
|
- 待验收:实现、测试和文档证据完成,等待负责人验收。
|
|
- 已完成:负责人明确验收并完成归档、关闭。
|
|
|
|
旧仓库任务的 DONE 不继承到新仓库。所有迁移项初始均为“待迁移”,必须用新代码、新测试和新验收重新证明。
|
|
|
|
## 稳定业务规则
|
|
|
|
1. Sense 与 Bell 完全独立认证;同一自然人在两个产品中是两个账户。
|
|
2. 任一产品可独立部署、升级、备份、恢复和验收,另一产品不作为启动依赖。
|
|
3. Brain 不拥有用户、Alert、通知或业务审计真相。
|
|
4. 产品集成使用机器身份和版本化契约,不共享数据库、用户会话或内部模型。
|
|
5. Bell 以 `(producer_id, source_event_id)` 保持跨重启幂等。
|
|
6. Event 不可变;误报只追加 outcome/反馈,不改写原始事实。
|
|
7. `sent`、`delivered`、`seen`、`ack` 是不同事实;无回执不能当成功。
|
|
8. 未 ack 自动升级且进程重启后续跑;并发 ack 只有首个成功者成为处置人。
|
|
9. 联系人、排班和升级策略共享主数据但分对象、分版本;投递创建时固化实际收件人、通道和解析版本。
|
|
10. 静默必须限时并自动恢复,单次不超过 4 小时。
|
|
11. 默认 16 路,按 32/64/128 横向扩展;128 路不等于单机或单 GPU 承诺。
|
|
12. 首期 S2 民办寄宿学校只做匿名规则,不启用人脸。
|
|
13. 家庭卧室、卫生间禁止摄像头,只能使用非成像传感器。
|
|
14. 摄像头凭据、客户数据、真实视频、JWT secret 和生产配置不得进入仓库、工单或 Wiki。
|
|
15. 业务预警与设备/媒体/推理运维告警使用不同通道和责任人。
|
|
|
|
## 新项目需要补充什么
|
|
|
|
以下事实必须由后续工单和负责人确认后补充:
|
|
|
|
- GoAdmin/go-admin-ui 的固定上游 commit、许可证记录和裁剪模块;
|
|
- Go、Node、Python、CUDA、PostgreSQL、MediaMTX 的精确版本;
|
|
- Sense/Bell 数据库 schema、Cookie 名称、部署域名和备份命令;
|
|
- Brain 模型、推理 FPS、硬件容量和商用许可;
|
|
- 试点最终留存期、通知供应商和验收阈值;
|
|
- 三个交付单元的正式版本与发布流程。
|
|
|
|
未确认项不得从旧代码或模板默认值推断为当前事实。
|
|
|
|
<!-- sense-mvp:start -->
|
|
## Sense 旧 MVP 规则状态
|
|
|
|
2026-08-14 前的 Sense 账户、设备、发现、Profile、MediaMTX、播放会话和区域版本实现规则仅适用于 `explore` 快照,不是新 `main` / `dev` 的运行事实。迁移工单应从这些记录提取已确认业务与安全约束,但认证、RBAC、管理端外壳和通用 CRUD 必须基于冻结 GoAdmin 源码重新实现并重新验收。
|
|
<!-- sense-mvp:end -->
|
|
|
|
|
|
<!-- bell-mvp:start -->
|
|
## Bell 旧 MVP 规则状态
|
|
|
|
2026-08-14 前的 Bell 独立身份、Event/Receipt、规则、Alert、ack/close 和审计实现仅保存在 `explore`。不可变、幂等、并发处置和产品独立边界仍是待迁移业务要求,但新实现必须从冻结 GoAdmin/go-admin-ui 源码派生并重新验收。
|
|
<!-- bell-mvp:end -->
|
|
|
|
|
|
|
|
## 旧实现迁移边界
|
|
|
|
旧 Sense 中已验证的中文设备字段、请求白名单、凭据隔离和媒体链路行为可作为迁移验收用例;不得把旧自研基础框架直接复制到新 `dev`。
|