110 lines
2.4 KiB
Markdown
110 lines
2.4 KiB
Markdown
# 飞书通知视图原型设计
|
|
|
|
## 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。
|