# 飞书通知视图原型设计

## 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。
