From 3327861dbd77ae63fd10246533b87e0b99a69220 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Mon, 31 Aug 2026 09:36:43 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20#148=20#149=20?= =?UTF-8?q?=E5=86=BB=E7=BB=93=E5=A5=91=E7=BA=A6=E8=BE=B9=E7=95=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Architecture-and-Code-Map.-.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/Architecture-and-Code-Map.-.md b/Architecture-and-Code-Map.-.md index ba20b34..dfcd3e4 100644 --- a/Architecture-and-Code-Map.-.md +++ b/Architecture-and-Code-Map.-.md @@ -288,3 +288,27 @@ Brain 解码层位于 `Brain/src/yovision_brain/decode/`，只依赖 #11 的内 内部候选包含逻辑输入引用、规则/模型版本、发生时间、匿名框和解释原因，不包含摄像头凭据、客户隐私、人脸、生物特征、机器绝对路径或证据引用。该格式不是 Brain→Bell 共享契约；Bell API、Outbox、机器身份、证据和跨项目投递必须由协调工单另行实现。 + + +## Sense↔Brain v1 契约边界 + +- Sense→Brain 配置：`contracts/source-config/v1/source-config.schema.json`；版本 `yovision.source-config/v1`。 +- Brain→Sense 状态：`contracts/runtime-status/v1/runtime-status.schema.json`；版本 `yovision.runtime-status/v1`。 +- 共同测试：`contracts/tests/source-config-v1/`、`contracts/tests/runtime-status-v1/`。 +- 生产者/消费者 mapper 责任分别记录在 `mapper-fields.md` 与 `mapping.md`；产品 adapter 后续由 #152 实现。 + +数据流固定为： + +```text +Sense Device/Profile/Area 内部事实 + → source-config/v1 mapper + → Brain adapter（后续 #152） + → Brain 内部配置与运行 + → runtime-status/v1 mapper + → Sense 只读运维投影（后续 #152） +``` + +共享契约统一使用 snake_case 与 `schema_version: yovision./v1`。源配置使用 `config_id + integer revision`；运行状态以 `configurations[]` 按 `config_id` 回报实际应用 revision。未知主版本、重复配置 ID、倒序状态、摘要失败或敏感字段必须拒绝，且不得覆盖最后已知有效配置/投影。 + +协议不得包含摄像头凭据、RTSP URL、query token、内部绝对路径、数据库模型、用户/JWT/Cookie 或 Bell Alert 语义。当前只冻结契约，没有新增网络端点、机器身份或跨端 connector。 +