# 场景疑点页导出异步化 - 页面改动说明 ## 1. 文档目的 本文档用于记录本次“场景疑点页导出异步化”在原型 Demo 中涉及的页面范围、具体改动点与交互变化，便于后续继续讨论和复用。 --- ## 2. 本次改动概述 本次优化将场景疑点页中的导出能力由同步模式改为异步模式，主要体现为： - 点击导出后不立即返回文件 - 改为创建导出任务 - 新增导出记录页，用于查看状态并手动下载 - 导出记录页以新页面 / 新页签方式打开 本次明确不包含： - 消息通知 - 自动下载 --- ## 3. 涉及页面范围 本次实际改动的页面文件如下： - `疑点派发-场景疑点.html` - `疑点处置-场景疑点.html` - `导出记录.html`（新增） 本次新增的说明文档如下： - `场景疑点页导出异步化-PRD.md` - `场景疑点页导出异步化-页面改动说明.md` --- ## 4. 各页面改动说明 ## 4.1 疑点派发-场景疑点.html ### 改动类型 - 导出入口增强 - 异步导出任务提交逻辑新增 - 新页签打开导出记录 ### 具体改动 #### 4.1.1 保留原有导出按钮 规则视角与业务视角中的原有 `导出` 按钮保留。 #### 4.1.2 新增“导出记录”按钮 在规则视角和业务视角内容区的 header 中，新增： - `导出记录` #### 4.1.3 导出记录打开方式 点击 `导出记录` 时： - 使用新页面 / 新页签打开 `导出记录.html` #### 4.1.4 导出按钮行为改造 点击 `导出` 后： - 不再直接下载文件 - 改为创建导出任务 - 记录当前： - 场景信息 - 视角 - 筛选条件 - 提示用户任务已提交 - 用户可选择是否立即在新页签打开导出记录 #### 4.1.5 导出任务本地存储 原型中通过浏览器本地存储记录导出任务列表，用于模拟异步导出任务机制。 --- ## 4.2 疑点处置-场景疑点.html ### 改动类型 - 导出入口增强 - 异步导出任务提交逻辑新增 - 新页签打开导出记录 ### 具体改动 与 `疑点派发-场景疑点.html` 保持同口径： - 保留导出按钮 - 新增导出记录按钮 - 点击导出时创建任务，不直接下载 - 导出记录在新页签打开 - 记录当前视角与筛选条件 说明： - 两个页面的异步导出交互规则完全一致 - 仅 `来源模块` 不同：一个是疑点派发，一个是疑点处置 --- ## 4.3 导出记录.html ### 页面类型 - 新增页面 ### 页面定位 导出记录页用于承接场景疑点页异步导出后的任务查看与手动下载。 ### 页面能力 - 查看导出任务列表 - 状态筛选 - 关键字搜索 - 刷新状态 - 下载成功任务文件 - 查看失败原因 ### 页面改动重点 #### 4.3.1 在新页签中打开 该页面设计为从场景疑点页以新页面 / 新页签方式打开。 #### 4.3.2 增加典型示例数据 页面中补充了多种异步导出任务示例，包括： - 来源模块为 `疑点派发` 的成功示例 - 来源模块为 `疑点处置` 的成功示例 - 导出失败示例 - 已过期示例 - 排队中 / 导出中示例 #### 4.3.3 列表列精简 删除以下列表列： - `导出视角` - `导出范围` 保留以下列： - 任务编号 - 来源模块 - 场景名称 - 状态 - 提交时间 - 文件大小 - 失效时间 - 操作 #### 4.3.4 操作列精简 删除操作项： - `查看条件` 保留操作项： - `下载`（成功任务） - `失败原因`（失败任务） - `处理中` / `已过期`（只读状态） --- ## 5. 交互变化总结 ## 5.1 原流程 - 用户点击导出 - 页面同步等待后台返回文件 - 大数据量下容易超时失败 ## 5.2 新流程 - 用户点击导出 - 系统创建异步导出任务 - 用户可选择立即在新页签打开导出记录 - 用户在导出记录页中查看状态并手动下载 --- ## 6. 数据记录口径 每个导出任务记录了： - 任务编号 - 来源模块 - 页面名称 - 场景 ID - 场景名称 - 导出视角 - 导出范围 - 筛选条件快照 - 状态 - 提交时间 - 失效时间 - 文件名 - 文件大小 - 失败原因 说明： - `导出视角` 与 `导出范围` 仍作为任务元数据保留 - 但在导出记录页列表中不直接展示 --- ## 7. 验收检查点 ### 7.1 场景疑点页 - 导出按钮仍然存在 - 导出记录按钮已新增 - 点击导出后不会直接下载文件 - 点击导出记录后会在新页签打开导出记录页 ### 7.2 导出记录页 - 页面存在且可打开 - 列表中不展示导出视角与导出范围 - 操作中不展示查看条件 - 成功任务可点击下载 - 失败任务可查看失败原因 - 页面中包含疑点处置来源、已过期等示例任务 ### 7.3 范围口径 - 导出任务基于当前视角与当前筛选条件生成 --- ## 8. 一句话总结 本次页面改动把场景疑点页导出升级为“异步任务 + 新页签导出记录 + 手动下载”的原型闭环，同时精简了导出记录页展示信息，并补充了更贴近真实业务的任务示例。