From 7a9645a7ca7f4b3478d27afb2d441238431f501e Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Tue, 11 Aug 2026 18:29:06 +0800
Subject: [PATCH] docs: initialize YoVision project documentation

---
 Business-Rules-and-Glossary.-.md | 60 ++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 Business-Rules-and-Glossary.-.md

diff --git a/Business-Rules-and-Glossary.-.md b/Business-Rules-and-Glossary.-.md
new file mode 100644
index 0000000..ccb8865
--- /dev/null
+++ b/Business-Rules-and-Glossary.-.md
@@ -0,0 +1,60 @@
+# 业务规则与术语
+
+## 核心术语
+
+| 术语 | 定义 |
+|---|---|
+| 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、硬件容量和商用许可；
+- 试点最终留存期、通知供应商和验收阈值；
+- 三个交付单元的正式版本与发布流程。
+
+未确认项不得从旧代码或模板默认值推断为当前事实。