yovision/Sense/AGENTS.md

Sense 目录规则

• Sense 是独立销售和部署的智能 NVR/视频感知产品管理面。
• 主实现技术栈为 Go 后端与 Vue 3 + Element Plus 管理端；正式数据库为 PostgreSQL。
• MediaMTX 保持独立二进制，Sense 只管理配置、生命周期与对账，不把媒体内核写进 HTTP handler 或 ORM model。
• Sense 不读取 Bell 数据库、不接受 Bell 用户会话，也不依赖 Bell 才能启动。
• 摄像头凭据只能从仓库外安全配置读取，日志、工单、测试夹具和 URL 不得包含明文凭据。
• 修改 contracts/、Brain/Bell 消费接口或根级部署文件前，必须转为跨项目协调工单。
• Sense agent 默认写路径仅为 Sense/ 及工单明确列出的共享文件。

独立建单职责

• Sense agent 负责建立独立登录/RBAC、设备台账、ONVIF/RTSP、MediaMTX、实时监看、区域配置、本地事件、运维中心、容量和本地 Outbox 等 Sense 单项目工单。
• 每个工单必须写明任务类型、主项目 Sense、主 agent、精确 write_paths、独立运行方式、测试命令和在 Bell/Brain 未启动时的验收标准。
• 首轮并行建单只创建 Sense 独立工单；发现需要 Sense→Brain 源/配置契约、Sense/Brain→Bell 事件/证据契约、根级部署或端到端测试时，停止扩写本工单，向主 agent 提交协同需求摘要。
• 协同需求摘要至少包含生产者、消费者、接口目的、候选事实源、阻塞的 Sense 工单和建议验证；Sense agent 不直接创建契约实现或取得 contracts/、Brain/、Bell/ 的写入权。

go-admin / go-admin-ui 约束

• Sense 管理面只启用智能 NVR、视频感知和本地运维所需的默认能力；框架演示页和无关管理模块优先通过配置、菜单权限或路由开关隐藏。
• 涉及权限或安全的不用模块不能只隐藏菜单，必须同时验证前端入口和后端接口均不可访问；永久删除默认模块必须单独建立清理工单。
• 新页面优先复用 Sense/go-admin-ui 已有的布局、表格、表单、弹窗、上传、权限控制和请求封装；新增组件前在工单中说明现有组件为何不能满足需求。
• 新增组件沿用 Sense 现有颜色、字号、间距、状态反馈、交互方式、命名和目录结构，并验证没有多余入口、失效入口或重复组件。
• 修改底层公共组件的全局行为时，必须单独建单并列出所有受影响页面；同时影响 Bell 或共享基线时升级为协同工单。

GoAdmin 技术基线

• 初始化或升级 Sense 前必须读取根 goadmin-baseline.json，按其中的 go-admin、go-admin-ui commit 和 Go/Node/pnpm 精确版本实施。
• D:\github\goadmin 下的仓库仅可只读参考；Sense 产品代码只能写入 Sense/ 或工单授权路径，不得在参考仓库原地开发。
• 派生上游代码必须保留 MIT 许可证和版权声明；上游 go-admin-doc 只作框架用法参考，不覆盖 yovision Wiki 和本目录规则。
• 变更冻结基线必须升级为 Sense/Bell 协同工单；Sense 可以独立发布，但不得单独漂移上游或工具链版本。