ila/yovision
1
0
Fork 0
Code Issues 14 Pull Requests 14 Actions Packages Projects Releases Wiki Activity

[ARCH] 汇总 Sense #80 跨项目契约、机器身份、部署与 E2E 协同需求 #124

New Issue
Closed
opened 2026-08-28 21:37:49 +08:00 by ila · 3 comments
ila commented 2026-08-28 21:37:49 +08:00
Owner
Copy Link
Copy Source

状态

已完成（2026-08-29，用户验收通过）

基本信息

  • 类型：架构协调 / 工单规划
  • 任务类型：跨项目协调
  • 主项目：YoVision
  • 主 agent：dispatcher / 单一协调 agent
  • 来源：Sense MVP #80 及 #72–#79 的协同需求摘要
  • 前置：#72–#79 已全部验收；开始拆分正式协议前仍须核对 Brain、Bell 对应独立任务状态

目标

统一汇总 Sense #80 暴露的跨项目需求，结合 Brain、Bell 已有独立任务去重后，建立各自只有一个事实源、一个协调 agent 和不重叠 write_paths 的正式协调单元工单。

已识别协同需求

  1. Sense→Brain：设备/Profile/媒体源引用与区域版本配置协议；Sense 是配置事实生产者，Brain 是消费者。
  2. Brain→Sense：推理运行、回填或健康状态投影；Brain 是运行事实生产者，Sense 只保存运维投影。
  3. Sense/Brain→Bell：标准事件与证据引用协议；Sense/Brain 是生产者，Bell 是幂等消费者和 Alert 事实源。
  4. 跨项目机器身份与可靠 connector：不得共享用户、JWT、Cookie、数据库或摄像头凭据。
  5. 根级可选部署与 E2E：三端均可独立启动，集成断开不破坏各自核心能力。

本工单范围

  • 只读核对三个项目的独立任务、长期 Wiki 与现有代码边界。
  • 确认生产者、消费者、协议目的、版本/兼容策略、前置依赖和测试责任。
  • 为契约、机器身份/connector、根级部署及 E2E 分别建立必要的协调单元工单，并同步 Epic #7 索引。

非目标

不在本工单直接修改 contracts/**、Sense/**、Brain/**、Bell/** 或根级部署；不实现协议、connector、认证或 E2E；不复制临时 schema 绕过协调门禁。

write_paths

  • 无产品代码写路径；只更新 Gitea 工单及 Epic/MVP 索引。

汇总与去重结果（2026-08-29）

  • 协调 MVP：#156。
  • Sense→Brain 媒体源/Profile/区域规则配置：#148，唯一事实源 contracts/source-config/v1/**。
  • Brain→Sense 推理运行、配置应用和健康投影：#149，唯一事实源 contracts/runtime-status/v1/**。
  • Brain/Sense→Bell 标准事件与证据引用：#150，唯一事实源 contracts/events/v1/** 与 contracts/evidence/v1/**。
  • 三端机器身份与安全传输：#151；禁止复用管理员密码、浏览器 JWT/Cookie 或共享数据库角色。
  • Sense↔Brain 双向 connector：#152；Brain/Sense→Bell 可靠事件 connector：#153。
  • 根级可选部署：#154；跨项目故障隔离 E2E：#155。
  • Brain brain.internal.*、Sense 本地候选/Outbox/节点投影和 Bell Event/Receipt/Alert 保持各项目内部模型，只由显式 mapper/adapter 映射，不提升为共享 schema。
  • #148/#149/#150 的 contracts/** 写路径互不重叠；#151–#155 的产品适配与根级路径也不重叠。connector 必须等待对应契约和机器身份验收后实施。
  • #148–#150 与高风险安全工单 #151 保持“待确认”；本工单不替代字段、兼容或认证机制的人工确认。

验收标准

  • 所有五类协同需求均有明确去重结论或独立协调单元工单编号
  • 每个下游工单声明单一协调 agent、生产者、消费者、精确 write_paths 与真实前置
  • 共享事实只落在版本化 contracts/**，不共享用户、JWT、Cookie、数据库内部模型或凭据
  • 部署/E2E 工单保持三端独立启动与故障隔离
  • Epic #7 获得不重复的协调任务索引

文档影响

本工单只整理任务边界，无长期产品事实变化；下游协议冻结后再更新对应 Wiki。

## 状态 已完成（2026-08-29，用户验收通过） ## 基本信息 - 类型：架构协调 / 工单规划 - 任务类型：跨项目协调 - 主项目：YoVision - 主 agent：dispatcher / 单一协调 agent - 来源：Sense MVP #80 及 #72–#79 的协同需求摘要 - 前置：#72–#79 已全部验收；开始拆分正式协议前仍须核对 Brain、Bell 对应独立任务状态 ## 目标 统一汇总 Sense #80 暴露的跨项目需求，结合 Brain、Bell 已有独立任务去重后，建立各自只有一个事实源、一个协调 agent 和不重叠 write_paths 的正式协调单元工单。 ## 已识别协同需求 1. Sense→Brain：设备/Profile/媒体源引用与区域版本配置协议；Sense 是配置事实生产者，Brain 是消费者。 2. Brain→Sense：推理运行、回填或健康状态投影；Brain 是运行事实生产者，Sense 只保存运维投影。 3. Sense/Brain→Bell：标准事件与证据引用协议；Sense/Brain 是生产者，Bell 是幂等消费者和 Alert 事实源。 4. 跨项目机器身份与可靠 connector：不得共享用户、JWT、Cookie、数据库或摄像头凭据。 5. 根级可选部署与 E2E：三端均可独立启动，集成断开不破坏各自核心能力。 ## 本工单范围 - 只读核对三个项目的独立任务、长期 Wiki 与现有代码边界。 - 确认生产者、消费者、协议目的、版本/兼容策略、前置依赖和测试责任。 - 为契约、机器身份/connector、根级部署及 E2E 分别建立必要的协调单元工单，并同步 Epic #7 索引。 ## 非目标 不在本工单直接修改 `contracts/**`、`Sense/**`、`Brain/**`、`Bell/**` 或根级部署；不实现协议、connector、认证或 E2E；不复制临时 schema 绕过协调门禁。 ## write_paths - 无产品代码写路径；只更新 Gitea 工单及 Epic/MVP 索引。 ## 汇总与去重结果（2026-08-29） - 协调 MVP：#156。 - Sense→Brain 媒体源/Profile/区域规则配置：#148，唯一事实源 `contracts/source-config/v1/**`。 - Brain→Sense 推理运行、配置应用和健康投影：#149，唯一事实源 `contracts/runtime-status/v1/**`。 - Brain/Sense→Bell 标准事件与证据引用：#150，唯一事实源 `contracts/events/v1/**` 与 `contracts/evidence/v1/**`。 - 三端机器身份与安全传输：#151；禁止复用管理员密码、浏览器 JWT/Cookie 或共享数据库角色。 - Sense↔Brain 双向 connector：#152；Brain/Sense→Bell 可靠事件 connector：#153。 - 根级可选部署：#154；跨项目故障隔离 E2E：#155。 - Brain `brain.internal.*`、Sense 本地候选/Outbox/节点投影和 Bell Event/Receipt/Alert 保持各项目内部模型，只由显式 mapper/adapter 映射，不提升为共享 schema。 - #148/#149/#150 的 `contracts/**` 写路径互不重叠；#151–#155 的产品适配与根级路径也不重叠。connector 必须等待对应契约和机器身份验收后实施。 - #148–#150 与高风险安全工单 #151 保持“待确认”；本工单不替代字段、兼容或认证机制的人工确认。 ## 验收标准 - [x] 所有五类协同需求均有明确去重结论或独立协调单元工单编号 - [x] 每个下游工单声明单一协调 agent、生产者、消费者、精确 write_paths 与真实前置 - [x] 共享事实只落在版本化 `contracts/**`，不共享用户、JWT、Cookie、数据库内部模型或凭据 - [x] 部署/E2E 工单保持三端独立启动与故障隔离 - [x] Epic #7 获得不重复的协调任务索引 ## 文档影响 本工单只整理任务边界，无长期产品事实变化；下游协议冻结后再更新对应 Wiki。
ila added the kind/taskproject/senseproject/brainproject/bellscope/coordination labels 2026-08-28 21:37:49 +08:00
ila commented 2026-08-29 21:01:44 +08:00
Author
Owner
Copy Link
Copy Source

开始实施与只读核对（2026-08-29）

  • 前置已满足：Sense #72–#79、Brain #11/#13–#16、Bell #131–#134 均已验收；MVP #8 已关闭。
  • 当前 contracts/ 只有 AGENTS.md，尚无可被三端依赖的冻结协议。
  • 去重边界：Brain brain.internal.input/v1 与 brain.internal.event-candidate/v1、Sense 本地候选/Outbox/边缘节点投影、Bell 内部 Event/Receipt 均继续保持项目内部模型；下游协调工单只能建立显式 mapper/adapter，不得直接共享数据库模型。
  • 规划原则：分别建立源与规则配置、Brain 运行状态、标准事件与证据、机器身份、两类 connector、根级可选部署和跨项目 E2E 工单；每张工单由单一协调 agent 负责并使用不重叠写路径。
  • 文档：本工单只整理任务边界，不产生新的长期产品事实；不修改 Wiki 或 docs/**。
## 开始实施与只读核对（2026-08-29） - 前置已满足：Sense #72–#79、Brain #11/#13–#16、Bell #131–#134 均已验收；MVP #8 已关闭。 - 当前 `contracts/` 只有 `AGENTS.md`，尚无可被三端依赖的冻结协议。 - 去重边界：Brain `brain.internal.input/v1` 与 `brain.internal.event-candidate/v1`、Sense 本地候选/Outbox/边缘节点投影、Bell 内部 Event/Receipt 均继续保持项目内部模型；下游协调工单只能建立显式 mapper/adapter，不得直接共享数据库模型。 - 规划原则：分别建立源与规则配置、Brain 运行状态、标准事件与证据、机器身份、两类 connector、根级可选部署和跨项目 E2E 工单；每张工单由单一协调 agent 负责并使用不重叠写路径。 - 文档：本工单只整理任务边界，不产生新的长期产品事实；不修改 Wiki 或 `docs/**`。
ila commented 2026-08-29 21:07:23 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据（2026-08-29）

状态：待验收。

建单结果

  • 协调 MVP：#156。
  • 协议：#148 源/规则配置、#149 Brain 运行状态、#150 标准事件/证据。
  • 安全与适配：#151 机器身份、#152 Sense↔Brain connector、#153 Brain/Sense→Bell connector。
  • 部署与验收：#154 根级可选部署、#155 跨项目故障隔离 E2E。
  • Epic #7 已新增 #156 索引。

去重与所有权验证

  • 当前 contracts/ 没有已冻结产品协议；新协议均指定唯一版本化目录。
  • Brain brain.internal.*、Sense 本地 candidate/Outbox/edge projection、Bell Event/Receipt/Alert 保持内部模型，只允许 mapper/adapter 对接。
  • #148–#155 均声明单一 coordination agent、生产者/消费者、真实前置和精确 write_paths；路径检查未发现相同或父子目录重叠。
  • #148/#149/#150 与高风险 #151 保持“待确认”，未绕过协议字段、兼容策略和机器认证方案的人工确认。

验证与 Git

  • 通过 Gitea MCP 回读 #148–#156：编号、标签、状态、MVP 归属、依赖和写路径完整。
  • #156 的实施顺序固定为：先契约/安全确认与冻结 → 两类 connector → 根级部署 → E2E。
  • 本工单只修改 Gitea 工单与 Epic 索引，没有产品代码或长期 Wiki 事实变化；按范围跳过 Wiki 同步。
  • Git 工作区无本工单改动，因此不制造空提交、不创建 PR、不执行与规划工单无关的产品测试。
  • 未创建或导出任务归档。

等待用户验收 #124；验收前不关闭。

## 最终实施证据（2026-08-29） 状态：待验收。 ### 建单结果 - 协调 MVP：#156。 - 协议：#148 源/规则配置、#149 Brain 运行状态、#150 标准事件/证据。 - 安全与适配：#151 机器身份、#152 Sense↔Brain connector、#153 Brain/Sense→Bell connector。 - 部署与验收：#154 根级可选部署、#155 跨项目故障隔离 E2E。 - Epic #7 已新增 #156 索引。 ### 去重与所有权验证 - 当前 `contracts/` 没有已冻结产品协议；新协议均指定唯一版本化目录。 - Brain `brain.internal.*`、Sense 本地 candidate/Outbox/edge projection、Bell Event/Receipt/Alert 保持内部模型，只允许 mapper/adapter 对接。 - #148–#155 均声明单一 coordination agent、生产者/消费者、真实前置和精确 write_paths；路径检查未发现相同或父子目录重叠。 - #148/#149/#150 与高风险 #151 保持“待确认”，未绕过协议字段、兼容策略和机器认证方案的人工确认。 ### 验证与 Git - 通过 Gitea MCP 回读 #148–#156：编号、标签、状态、MVP 归属、依赖和写路径完整。 - #156 的实施顺序固定为：先契约/安全确认与冻结 → 两类 connector → 根级部署 → E2E。 - 本工单只修改 Gitea 工单与 Epic 索引，没有产品代码或长期 Wiki 事实变化；按范围跳过 Wiki 同步。 - Git 工作区无本工单改动，因此不制造空提交、不创建 PR、不执行与规划工单无关的产品测试。 - 未创建或导出任务归档。 等待用户验收 #124；验收前不关闭。
ila commented 2026-08-29 21:09:33 +08:00
Author
Owner
Copy Link
Copy Source

用户验收结论（2026-08-29）

用户明确回复“#124通过”。

验收范围：五类协同需求的去重、#148–#155 单元工单、协调 MVP #156、生产者/消费者、依赖、单一协调 agent、精确且不重叠的 write_paths，以及 Epic #7 索引。

结论：#124 验收通过并关闭。本次验收不等于批准 #148–#150 的协议字段或 #151 的高风险机器身份方案；这些工单仍按各自确认门禁处理。没有新的长期 Wiki 事实变化，不重复同步 Wiki，也不创建任务归档。

## 用户验收结论（2026-08-29） 用户明确回复“#124通过”。 验收范围：五类协同需求的去重、#148–#155 单元工单、协调 MVP #156、生产者/消费者、依赖、单一协调 agent、精确且不重叠的 write_paths，以及 Epic #7 索引。 结论：#124 验收通过并关闭。本次验收不等于批准 #148–#150 的协议字段或 #151 的高风险机器身份方案；这些工单仍按各自确认门禁处理。没有新的长期 Wiki 事实变化，不重复同步 Wiki，也不创建任务归档。
ila closed this issue 2026-08-29 21:09:33 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/ux
UI/UX 与交互原型
 kind/epic
长期产品目标
 kind/mvp
可独立验收的最小版本
 kind/task
单元实施任务
 priority/p0
首个纵切必需能力
 project/bell
Bell 项目
 project/brain
Brain 项目
 project/sense
Sense 项目
 scope/coordination
跨项目协调任务
 scope/independent
不依赖其他项目在线的项目内任务
No labels kind/task project/bell project/brain project/sense scope/coordination
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ila/yovision#124