yovision/Bell/AGENTS.md

Bell 目录规则

• Bell 是独立销售和部署的事件预警与处置产品。
• 主实现技术栈为 Go 后端与 Vue 3 + Element Plus 管理端；正式数据库为 PostgreSQL。
• Bell 拥有独立账户、角色、会话、数据库角色、审计和密码策略，不信任 Sense 用户 token。
• Event 与 Alert 分离；原始 Event 不可变，Alert 状态迁移、ack/close、投递和升级事实只追加并可审计。
• 外部事件以 (producer_id, source_event_id) 幂等；Bell 不读取 Sense 数据库、摄像头密码或内部文件路径。
• 修改 contracts/、Sense connector 或 Brain 输出语义前，必须转为跨项目协调工单。
• Bell agent 默认写路径仅为 Bell/ 及工单明确列出的共享文件。

独立建单职责

• Bell agent 负责建立独立登录/RBAC、外部事件入站、规则、Event/Alert、ack/close、升级恢复、联系人/排班、通知、审计和合成事件验收等 Bell 单项目工单。
• 每个工单必须写明任务类型、主项目 Bell、主 agent、精确 write_paths、独立运行方式、测试命令和在 Sense/Brain 未启动时使用合成或第三方事件的验收标准。
• 首轮并行建单只创建 Bell 独立工单；发现需要外部事件/证据契约、producer identity、Sense connector、根级部署或端到端测试时，停止扩写本工单，向主 agent 提交协同需求摘要。
• 协同需求摘要至少包含生产者、消费者、接口目的、候选事实源、阻塞的 Bell 工单和建议验证；Bell agent 不直接创建契约实现或取得 contracts/、Sense/、Brain/ 的写入权。