diff --git a/docs/原型设计/1.1.资料包导入页原型设计.md b/docs/原型设计/1.1.资料包导入页原型设计.md index cbf383b..cf6dbfd 100644 --- a/docs/原型设计/1.1.资料包导入页原型设计.md +++ b/docs/原型设计/1.1.资料包导入页原型设计.md @@ -4,6 +4,8 @@ 把注册申报资料的导入、解包、扫描、目录汇总和章节点识别结果集中展示出来，让用户第一眼就明白本平台的输入对象是“资料包”，不是单篇文档。 +本页还需要明确表达：资料包不是孤立文件集合，而是会与一个审核会话绑定，对话标题默认采用解析后的产品名称。 + ## 2. 适用角色 - 注册资料专员 @@ -69,6 +71,8 @@ 表格列建议： +- 产品名称 +- 关联会话 - 原始相对路径 - 文件名 - 文件类型 @@ -86,6 +90,8 @@ 关键字段： - `batch_id` +- `product_name` +- `conversation_id` - `file_count` - `supported_file_count` - `failed_file_count` @@ -112,6 +118,8 @@ - 点击目录树节点，可在右侧高亮对应文件。 - 点击异常项，可筛选下方表格。 - 点击单个文件行，可打开“文档详情抽屉”，展示页数统计方式和章节点识别结果。 +- 点击资料包标题或“查看对话”，跳转到关联会话。 +- 页面顶部搜索框支持按产品名称或批次号搜索资料包。 - 点击“进入法规完整性检查”，跳转下一页。 ## 7. 与上下游页面的数据关系 @@ -127,6 +135,7 @@ ## 8. 演示话术重点 - 强调本平台处理的是整套注册资料，不是单文档聊天。 +- 强调资料包会与会话绑定，用户后续是围绕该产品资料持续对话和追溯。 - 强调压缩包、目录层级、页数和章节点是后续审核的事实基础。 - 强调异常箱的价值在于把“资料问题”前置，而不是等到审核后才发现。 diff --git a/docs/原型设计/1.2.审核任务工作台原型设计.md b/docs/原型设计/1.2.审核任务工作台原型设计.md deleted file mode 100644 index ea2f69e..0000000 --- a/docs/原型设计/1.2.审核任务工作台原型设计.md +++ /dev/null @@ -1,120 +0,0 @@ -# 审核任务工作台原型设计 - -## 1. 页面目标 - -作为整套原型的首页，先把当前批次的审核进度、任务状态、关键风险和操作入口集中展示，让用户在 10 秒内理解平台价值和当前处理位置。 - -## 2. 适用角色 - -- 注册申报负责人 -- 项目经理 -- 复试演示讲解人 - -## 3. 页面布局分区 - -页面建议采用“总览头图 + 流程卡片 + 风险与待办双栏”。 - -分区如下： - -- 顶部 Hero：批次、产品、流程、总体结论 -- 中部七卡任务区 -- 下方左侧：风险总览 -- 下方右侧：待办动作与推荐下一步 - -## 4. 核心卡片 / 表格 / 状态区 - -### 4.1 批次总览 Hero - -展示： - -- 批次编号 -- 产品名称 -- 当前流程类型 -- 当前审核阶段 -- 最高风险等级 -- 是否允许正式导出 - -### 4.2 七个流程任务卡片 - -固定七张卡片： - -1. 资料包导入 -2. 目录汇总 -3. 法规完整性检查 -4. 字段抽取 -5. 一致性核查 -6. 风险预警 -7. Word 回填导出 - -每张卡片展示： - -- 任务名称 -- 当前状态 -- 关键指标 -- 最近执行时间 -- 进入页面按钮 - -### 4.3 风险总览区 - -展示： - -- 高 / 中 / 低风险数量 -- 当前阻断原因 -- 需要人工复核的字段数 - -### 4.4 待办动作区 - -展示： - -- 缺失项补充建议 -- 字段冲突待确认项 -- 推荐下一步操作 - -## 5. 关键字段定义 - -建议聚合使用以下对象： - -- `registration_overview_report` -- `registration_completeness_report` -- `registration_field_extraction_report` -- `registration_consistency_report` -- `registration_risk_report` -- `registration_word_export_report` - -工作台摘要字段： - -- `task_name` -- `task_status` -- `last_run_at` -- `summary_label` -- `summary_value` -- `entry_target` - -## 6. 关键交互 - -- 点击任务卡片进入对应页面。 -- 点击“查看总体风险”滚动到风险区。 -- 点击“打开治理台”查看规则版本、字段 Schema、模板版本。 -- 鼠标悬浮卡片显示“本任务输入来自哪里，输出流向哪里”。 - -## 7. 与上下游页面的数据关系 - -上游：汇总所有页面结果。 - -下游：为各页面提供统一入口，不产生独立业务结果。 - -## 8. 演示话术重点 - -- 先讲“流程闭环”，再讲某个点上的智能能力。 -- 突出这不是自由问答，而是受控的任务执行工作台。 -- 强调每个任务卡片都有状态、有输入输出、有结构化结果。 - -## 9. 与知识库 / 治理台的关联入口 - -工作台页右上角提供： - -- `规则版本总览` -- `模板版本总览` -- `责任人映射总览` - -适合作为讲解治理能力的总入口。 diff --git a/docs/原型设计/1.2.审核智能体页原型设计.md b/docs/原型设计/1.2.审核智能体页原型设计.md new file mode 100644 index 0000000..1b7cc87 --- /dev/null +++ b/docs/原型设计/1.2.审核智能体页原型设计.md @@ -0,0 +1,162 @@ +# 审核智能体页原型设计 + +## 1. 页面目标 + +作为整套原型的主入口，以 Agent 对话为核心承接资料上传、任务模板触发、节点式审核推进和结构化结果讲解，让用户在 10 秒内理解“这是一个审核智能体，而不是传统报表后台”。 + +## 2. 适用角色 + +- 注册申报负责人 +- 项目经理 +- 复试演示讲解人 + +## 3. 页面布局分区 + +页面建议采用“顶部对话上下文 + 三栏工作区”。 + +分区如下： + +- 顶部：产品定位、提示词模板、当前会话摘要 +- 左栏：对话历史 +- 中栏：对话区 + 节点导航 +- 右栏上部：上传栏 +- 右栏下部：任务能力卡 / 结构化结果卡 + +## 4. 核心卡片 / 表格 / 状态区 + +### 4.1 顶部对话上下文区 + +展示： + +- 批次编号 +- 产品名称 +- 当前流程类型 +- 当前审核阶段 +- 当前最高风险等级 +- 是否允许正式导出 +- 推荐提问模板 + +### 4.2 左栏对话历史 + +展示： + +- 历史会话标题 +- 会话对应产品名称 +- 风险状态 +- 最近更新时间 +- 资料包绑定标记 + +交互： + +- 点击某条会话，切换到对应产品资料的审核上下文。 +- 会话标题默认采用解析后的 `product_name`。 + +### 4.3 中栏对话区与节点导航 + +展示： + +- 用户问题 +- Agent 执行计划 +- 节点结果消息 +- 结构化摘要片段 +- RAG 命中依据提示 + +节点条固定包含： + +1. 资料包导入 +2. 目录汇总 +3. 法规完整性检查 +4. 字段抽取 +5. 一致性核查 +6. 风险预警 +7. Word 回填导出 +8. 飞书通知 + +交互： + +- 点击节点，定位到该阶段的消息和结构化结果。 +- 当前执行节点状态实时变化为 `处理中 / 已完成 / 待复核 / 已阻断`。 + +### 4.4 右栏上传区 + +展示： + +- 当前资料包上传入口 +- 最近上传文件 +- 文件解析状态 +- 支持格式说明 + +### 4.5 右栏任务能力卡 + +根据当前选中的节点或任务模板，展示不同信息： + +- 目录汇总时展示文件数、页数、章节点覆盖 +- 完整性检查时展示缺失项、错放项、法规依据摘要 +- 字段抽取时展示字段数、低置信度、待复核状态 +- 一致性核查时展示冲突字段、混档风险 +- 风险预警时展示总风险等级、是否允许导出、整改建议 +- Word 导出时展示回填字段、拦截项和导出状态 +- 飞书通知时展示 `@` 处理人、通知原因和 Web 详情链接 + + +## 5. 关键字段定义 + +建议聚合使用以下对象： + +- `registration_overview_report` +- `registration_completeness_report` +- `registration_field_extraction_report` +- `registration_consistency_report` +- `registration_risk_report` +- `registration_word_export_report` + +工作台摘要字段： + +- `conversation_id` +- `product_name` +- `batch_id` +- `task_name` +- `task_status` +- `last_run_at` +- `summary_label` +- `summary_value` +- `entry_target` +- `notify_reason` + +## 6. 关键交互 + +- 点击历史会话切换产品审核上下文。 +- 点击预设提问模板，自动填充对话输入框。 +- 点击节点条跳转到对应执行阶段。 +- 上传附件后，右栏任务卡片按 `文档解析中 -> 解析完成 -> 数据处理中 -> 处理完成` 实时更新。 +- 点击能力卡查看来源证据、结构化结果或治理入口。 +- 点击“打开治理台”查看规则版本、字段 Schema、模板版本和责任人映射。 + +## 7. 与上下游页面的数据关系 + +上游： + +- 资料包页提供当前 `batch_id`、`product_name` 和会话绑定关系。 +- 知识库页提供法规、模板、字段和飞书配置能力。 + +下游： + +- 本页串联所有审核节点结果，是主执行页面。 +- 处理历史页回看本页产生的节点消息、结构化结论和通知记录。 + +## 8. 演示话术重点 + +- 先讲“对话驱动的审核闭环”，再讲某个点上的智能能力。 +- 突出这不是传统分页后台，而是带任务节点和结构化结果的审核智能体。 +- 强调每个节点都有状态、有输入输出、有结构化结果，并且能追溯到知识库依据和资料包。 + +## 9. 与知识库 / 治理台的关联入口 + +本页右侧或右上角提供： + +- `规则版本总览` +- `模板版本总览` +- `责任人映射总览` +- `飞书配置总览` + +适合作为讲解治理能力的总入口。 diff --git a/docs/原型设计/1.8.飞书通知视图原型设计.md b/docs/原型设计/1.8.飞书通知视图原型设计.md index cb6e397..da423a9 100644 --- a/docs/原型设计/1.8.飞书通知视图原型设计.md +++ b/docs/原型设计/1.8.飞书通知视图原型设计.md @@ -2,7 +2,9 @@ ## 1. 页面目标 -把风险预警和导出状态转成一张可发送的飞书消息卡片，展示责任人 `@`、消息摘要、Web 详情链接和发送回执，形成工作台外部协同闭环。 +把风险预警和导出状态转成一张可发送的飞书消息卡片，展示责任人 `@`、消息摘要、Web 详情链接和发送回执，形成审核智能体之外的协同闭环。 + +当前 Demo 固定口径为：任务执行完成后直接通知，或在执行异常后直接通知，并 `@` 对应处理人。 ## 2. 适用角色 @@ -37,6 +39,7 @@ 展示： - 触发来源 +- 通知原因 - 飞书群聊 ID - 消息类型 - 是否包含责任人通知 @@ -58,6 +61,7 @@ 关键字段： - `send_status` +- `notify_reason` - `message_type` - `mentioned_users[]` - `web_detail_url` @@ -76,6 +80,7 @@ - 点击“发送通知”切换为已发送状态。 - 点击责任人标签，查看角色映射详情。 - 点击 Web 详情按钮，跳转到 mock 审计详情链接。 +- 点击“切换通知原因”，在 `task_completed / task_failed` 两类消息之间切换。 ## 7. 与上下游页面的数据关系 @@ -89,7 +94,7 @@ ## 8. 演示话术重点 - 强调平台不止有 Web 界面，还有飞书协同入口。 -- 强调系统可以把风险结果直接转换成责任人可执行的通知载荷。 +- 强调系统可以在任务完成或异常后，直接把结果转换成责任人可执行的通知载荷。 - 强调通知里保留 Web 详情链接，便于追溯。 ## 9. 与知识库 / 治理台的关联入口 diff --git a/docs/原型设计/1.整体原型设计.md b/docs/原型设计/1.整体原型设计.md index af53e5b..57b0e84 100644 --- a/docs/原型设计/1.整体原型设计.md +++ b/docs/原型设计/1.整体原型设计.md @@ -19,18 +19,17 @@ ## 2. 演示总动线 -推荐演示顺序： +最新版原型采用“顶层 4 个 Tab + 对话内节点推进”的组织方式，推荐演示顺序如下： -1. 从“审核任务工作台”进入，先看 7 个流程任务卡片和当前批次状态。 -2. 跳到“资料包导入页”，解释资料包、目录、页数和章节点识别。 -3. 进入“法规完整性检查页”，展示缺失项、错放项和法规依据。 -4. 进入“字段抽取与字段池页”，展示统一字段池、置信度和待复核字段。 -5. 进入“一致性核查页”，展示字段冲突和混档风险。 -6. 进入“风险预警页”，说明总风险等级、是否通过、整改建议和责任角色。 -7. 进入“Word 回填导出页”，说明自动回填、导出拦截和下载入口。 -8. 最后展示“飞书通知视图”，形成协同闭环。 +1. 先进入 `审核智能体`，展示左侧会话历史、中间对话区、右侧上传区和任务卡片区。 +2. 在对话页上传资料包，触发目录汇总、完整性检查、字段抽取、一致性核查和风险结论节点。 +3. 点击对话节点，解释每一步的结构化结果如何在右侧卡片实时更新状态。 +4. 切换到 `资料包`，展示资料包列表、按产品名称搜索、资料包与会话绑定关系，以及目录、页数、章节点结果。 +5. 切换到 `知识库`，说明法规资料、业务资料、RAG 切片、字段 Schema、模板映射、责任人映射和飞书配置如何治理。 +6. 切换到 `处理历史`，说明如何按批次、产品和风险状态回看历史会话、资料规模和通知留痕。 +7. 返回对话中的风险与导出节点，最后展示飞书完成通知或异常通知如何直接 `@` 处理人并携带 Web 详情链接。 -知识库与治理台不作为独立主线页面插入，而是作为上述页面的配置入口、侧边抽屉或管理弹层出现，用来回答“规则从哪里来、谁来维护、如何增删改查”。 +法规依据不再以单独一级页面存在，而是作为知识库中的法规资料，由 RAG 在对话节点中返回依据说明。 ## 3. 统一视觉风格 @@ -44,8 +43,8 @@ ### 3.2 色彩建议 -- 主背景：浅灰蓝与米白渐变，形成轻量但不空泛的工作台底色。 -- 主强调色：深青蓝，用于导航、主按钮、激活态和重点数值。 +- 主背景：以白色为主，辅以极浅灰蓝，保证整体简洁和专业。 +- 主强调色：克制的深青蓝，用于导航、主按钮、激活态和重点数值。 - 风险色：铜橙、深红，用于缺失、冲突、高风险、阻断状态。 - 成功色：低饱和绿色，用于完成、可通过、已同步状态。 - 中性色：冷灰，用于说明文字、边框、标签和禁用态。 @@ -60,16 +59,19 @@ ### 4.1 全局导航 -- 顶部固定展示：平台名称、当前批次、产品名称、流程类型、全局风险状态。 -- 左侧流程导航固定展示 8 个主页面入口。 -- 每个页面右上角保留“打开治理台”入口。 +- 顶部固定展示：平台名称、顶层 Tab、右上角用户信息。 +- 顶层 Tab 固定为：`审核智能体 / 资料包 / 知识库 / 处理历史`。 +- `审核智能体` 内部采用三栏布局，不再使用左侧 8 页面流程导航。 +- 每个页面保留“打开治理台”或同等治理入口。 ### 4.2 统一交互规则 -- 所有结果页都支持“查看来源证据”。 +- 对话是主执行入口，页面切换是不同信息视角，而不是不同执行系统。 +- 所有结果区都支持“查看来源证据”。 - 所有关键对象都支持“打开详情抽屉”。 - 所有治理对象都遵循“列表 -> 详情 -> 新增 / 编辑 / 启停 / 删除”的统一 CRUD 结构。 -- 风险阻断项必须在 Word 导出页和飞书通知视图里继续可见，保证前后呼应。 +- 风险阻断项必须在对话节点、Word 导出区和飞书通知视图里持续可见，保证前后呼应。 +- 资料包必须可跳转到关联会话，会话标题默认采用解析后的 `product_name`。 ### 4.3 状态规范 @@ -99,6 +101,7 @@ - `batch_id`: `SUB-20260603-001` - `workflow_type`: `registration` - `product_name`: `新型冠状病毒 2019-nCoV 核酸检测试剂盒` +- `conversation_id`: `conv-001` - `applicant_name`: `示例生物科技（上海）有限公司` - `chapter_scope`: `CH1 ~ CH6` @@ -111,7 +114,7 @@ 3. 说明书与申请表中的产品名称存在文本不一致。 4. 储存条件字段存在待人工复核状态。 5. 风险等级为高，当前批次不允许正式导出，仅允许生成草稿。 -6. 飞书通知需要 `@注册资料负责人` 和 `@注册申报负责人`。 +6. 飞书通知在任务完成或出现异常后直接 `@注册资料负责人` 和 `@注册申报负责人`。 ### 5.3 共用对象定义 @@ -137,17 +140,23 @@ ## 6. 页面跳转关系 -主页面跳转关系如下： +主页面关系调整为： ```text -审核任务工作台 - -> 资料包导入页 - -> 法规完整性检查页 - -> 字段抽取与字段池页 - -> 一致性核查页 - -> 风险预警页 - -> Word 回填导出页 - -> 飞书通知视图 +顶部导航 + -> 审核智能体 + -> 资料包 + -> 知识库 + -> 处理历史 + +审核智能体内部节点 + -> 资料包导入 + -> 法规完整性检查 + -> 字段抽取与字段池 + -> 一致性核查 + -> 风险预警 + -> Word 回填导出 + -> 飞书通知 ``` 跨页关系约束： @@ -173,16 +182,19 @@ ### 7.2 HTML 结构要求 - 一个全局 App Shell -- 八个主页面 section +- 四个顶层页面 section +- 一个以对话节点为核心的审核智能体 section - 一个治理台抽屉层 - 一份统一 mock 数据对象 - 一组轻量 JavaScript 交互 ### 7.3 必备交互 -- 切换 8 个页面视图 +- 切换 `审核智能体 / 资料包 / 知识库 / 处理历史` 视图 +- 切换会话历史 +- 点击对话节点定位到对应执行阶段 - 展开 / 收起目录树 -- 切换流程任务卡片选中态 +- 资料包按产品名称或批次号搜索 - 打开治理台抽屉 - 切换治理对象 CRUD 子视图 - 模拟 Word 导出状态切换 @@ -193,7 +205,7 @@ 本轮分页文档如下： 1. [1.1.资料包导入页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.1.资料包导入页原型设计.md) -2. [1.2.审核任务工作台原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.2.审核任务工作台原型设计.md) +2. [1.2.审核智能体页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.2.审核智能体页原型设计.md) 3. [1.3.法规完整性检查页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.3.法规完整性检查页原型设计.md) 4. [1.4.字段抽取与字段池页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.4.字段抽取与字段池页原型设计.md) 5. [1.5.一致性核查页原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.5.一致性核查页原型设计.md) @@ -225,7 +237,12 @@ 这套原型的核心讲法应统一为： ```text -资料包治理 -> 法规完整性核查 -> 字段池沉淀 -> 一致性检查 -> 风险预警 -> Word 回填导出 -> 飞书协同闭环 +以对话为核心的审核智能体 + -> 资料包解析与会话绑定 + -> 节点式审核推进 + -> 知识库 / RAG 解释 + -> 风险与导出决策 + -> 飞书协同闭环 ``` -治理台负责回答“规则和知识如何维护”，工作台负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。 +治理台负责回答“规则和知识如何维护”，审核智能体负责回答“这一批资料现在审核到了哪里、为什么这样判断、下一步谁来处理”。