DEMO-AGENT/docs/原型设计/1.8.飞书通知视图原型设计.md

飞书通知视图原型设计

1. 页面目标

把风险预警和导出状态转成一张可发送的飞书消息卡片，展示责任人 @、消息摘要、Web 详情链接和发送回执，形成审核智能体之外的协同闭环。

当前 Demo 固定口径为：任务执行完成后直接通知，或在执行异常后直接通知，并 @ 对应处理人。

2. 适用角色

• 注册申报负责人
• 协同群聊成员
• 演示讲解人

3. 页面布局分区

建议采用“双栏布局”：

• 左侧：飞书消息卡片预览
• 右侧：通知配置与发送回执

底部补一条 Web 详情页入口说明。

4. 核心卡片 / 表格 / 状态区

4.1 飞书消息卡片预览

展示：

• 批次编号
• 风险摘要
• 是否通过
• 责任人 @
• 关键风险条目
• Web 详情按钮

4.2 通知配置区

展示：

• 触发来源
• 通知原因
• 飞书群聊 ID
• 消息类型
• 是否包含责任人通知
• 是否附带 Web 链接

4.3 发送回执区

展示：

• 发送状态
• 消息 ID
• 发送时间
• 失败原因

5. 关键字段定义

页面主要消费 feishu_notification_report。

关键字段：

• send_status
• notify_reason
• message_type
• mentioned_users[]
• web_detail_url
• receipt.message_id
• receipt.sent_at

同时复用风险页中的：

• highest_risk_level
• pass_status
• owner_notifications[]

6. 关键交互

• 点击“切换卡片样式”模拟不同消息模板。
• 点击“发送通知”切换为已发送状态。
• 点击责任人标签，查看角色映射详情。
• 点击 Web 详情按钮，跳转到 mock 审计详情链接。
• 点击“切换通知原因”，在 task_completed / task_failed 两类消息之间切换。

7. 与上下游页面的数据关系

上游：

• 风险预警页提供责任角色和风险摘要
• Word 回填导出页提供导出状态

下游：无，属于主线收尾页。

8. 演示话术重点

• 强调平台不止有 Web 界面，还有飞书协同入口。
• 强调系统可以在任务完成或异常后，直接把结果转换成责任人可执行的通知载荷。
• 强调通知里保留 Web 详情链接，便于追溯。

9. 与知识库 / 治理台的关联入口

本页应提供：

• 维护责任人映射
• 维护飞书机器人配置
• 维护消息模板
• 查看发送日志

这些入口进入治理台中的责任人映射和飞书通知配置 CRUD。