# 风险监控区块链配套功能一期 PRD ## 1. 文档信息 - 文档名称：风险监控区块链配套功能一期 PRD - 所属模块：全知平台 / 风控模块 / 风险规则 / 风险疑点 / 风险处置 - 文档类型：阶段性功能 PRD - 建设阶段：一期 - 主要目标：将已有区块链存证能力在页面中以“状态可见、记录可查、轨迹可看”的方式呈现出来 --- ## 2. 背景说明 当前平台在风险监控相关业务中已经具备区块链存证能力： - 风险规则从创建、审核到上线的关键节点已支持链上存证 - 风险疑点从生成到处置过程中的关键节点已支持链上存证 但现阶段这些能力主要停留在后台，页面侧缺少直接展示与查看入口，导致： - 业务人员无法快速识别哪些规则或疑点已经上链 - 业主方在查看页面时，无法直观看到区块链建设成果 - 汇报、验收、抽查场景中缺少页面支撑 因此，一期需要补充页面级的区块链配套功能。 --- ## 3. 本期目标 本期目标为： - 在规则列表页增加上链状态展示与筛选能力 - 在规则详情页增加 `区块链信息` Tab - 在疑点派发详情页和疑点处置详情页增加上链状态列与链上详情入口 - 增加规则链上详情弹窗和疑点链上详情弹窗 - 在 Demo 中体现不同上链状态下不同的弹窗内容与不同的 Tab 内容 本期明确不做： - 一键验真 - 区块链管理独立页面 - 统计看板 - 存证证明导出 - 链上失败重试 - 批量一致性校验 --- ## 4. 状态口径 本期页面统一采用以下状态口径： - `未上链` - `上链中` - `已上链` - `上链异常` ### 4.1 状态定义 | 状态值 | 定义 | 页面说明 | |---|---|---| | 未上链 | 当前未发起上链 | 不可查看链上详情 | | 上链中 | 当前上链任务处理中 | 列表点击后提示“正在上链中，请稍后查看” | | 已上链 | 当前记录已成功上链 | 可查看链上详情 | | 上链异常 | 当前节点上链异常，或当前链上状态与最新数据不完全一致 | 可查看链上详情，并在详情中展示异常原因 | ### 4.2 特殊口径说明 对于“历史已成功上链，但本次最新上链异常”的情况： - 列表主状态显示为：`上链异常` - 弹窗或详情页中展示：`当前节点上链异常，以下展示最近一次成功链上记录` - 异常原因不在列表中单独增加字段，只在弹窗或详情页中展示 --- ## 5. 页面范围 本期页面范围如下： - `风险规则-我的规则.html` - `规则详情.html` - `疑点派发-疑点详情.html` - `疑点处置-疑点详情.html` 本期配套文档： - `风险监控区块链配套功能一期-PRD.md` - `风险监控区块链配套功能一期-页面改动说明.md` 本期不纳入： - `风险规则-公共规则库.html` - `疑点派发.html` - `疑点处置.html` - `疑点派发-场景疑点.html` - `疑点处置-场景疑点.html` - 区块链管理页 - 风险监控大屏 --- ## 6. 页面功能方案 ## 6.1 风险规则列表页 对应页面：`风险规则-我的规则.html` ### 页面目标 - 让用户快速识别每条规则的上链状态 - 支持按上链状态快速筛选 ### 新增内容 | 类型 | 功能项 | 说明 | |---|---|---| | 列表字段 | 上链状态 | 展示当前规则是否已上链 | | 列表字段 | 唯一访问码 | 展示当前规则的唯一访问码 | | 查询条件 | 上链状态筛选 | 支持按已上链、未上链、上链中、上链异常筛选 | | 行操作 | 查看链上记录 | 已上链、上链异常可打开规则链上详情弹窗 | ### 交互规则 - `已上链`：点击状态标签或 `查看链上记录`，打开规则链上详情弹窗 - `上链异常`：点击状态标签或 `查看链上记录`，打开规则链上详情弹窗 - `上链中`：点击后提示“正在上链中，请稍后查看” - `未上链`：不可打开弹窗 --- ## 6.2 规则链上详情弹窗 ### 页面定位 - 用于规则列表页快速查看链上信息 - 与规则详情页的 `区块链信息` Tab 区分：弹窗强调“快速查看”，Tab 强调“完整查看” ### 建议展示字段 #### 1）基础信息 - 上链状态 - 唯一访问码 - 上链节点 #### 2）链上信息 - 交易哈希 #### 3）校验信息 - 验真状态 #### 4）异常补充（仅上链异常时显示） - 异常原因 #### 5）链上存证轨迹 每条轨迹展示： - 事件名称 - 时间 - 交易哈希 说明： - 轨迹中**不重复展示唯一访问码** - 默认展示最新 `3` 条记录 - 历史记录折叠，可展开查看全部历史 ### 状态内容差异 - `已上链`：展示完整成功态内容 - `上链异常`：展示异常原因，并说明“以下展示最近一次成功链上记录” - `上链中`：本期不打开完整弹窗，只提示 - `未上链`：本期不打开弹窗 --- ## 6.3 规则详情页 `区块链信息` Tab 对应页面：`规则详情.html` ### 页面定位 - 规则链上信息的完整查看页 ### 建议展示字段 #### 1）存证汇总 - 上链状态 - 唯一访问码 - 上链节点 - 链上记录数量 #### 2）链上信息 - 交易哈希 #### 3）校验信息 - 验真状态 #### 4）异常补充（仅上链异常时显示） - 异常原因 #### 5）链上存证轨迹 每条轨迹展示： - 事件名称 - 时间 - 交易哈希 说明： - 轨迹中**不重复展示唯一访问码** - **不展示摘要哈希** - 默认展示最新 `3` 条记录 - 历史记录折叠，可展开查看全部历史 ### 不同状态下的 Tab 内容 #### 已上链 - 展示正常存证汇总 - 展示交易哈希、验真状态、完整轨迹 #### 上链异常 - 顶部增加异常提示 - 展示异常原因 - 展示最近一次成功链上记录的交易哈希 - 轨迹中保留异常节点 #### 上链中 - 顶部展示处理中提示 - 上链状态：上链中 - 交易哈希：待生成 - 验真状态：待验真 - 链上记录数量：如有历史记录则展示“共 N 条（含 1 条处理中）” - 轨迹中增加 `处理中` 节点 #### 未上链 - 展示未上链状态 - 交易哈希为空 - 验真状态显示 `暂不可验真` - 轨迹区域展示空状态提示 --- ## 6.4 疑点详情展示方式 > 说明：疑点没有独立详情页。疑点最详细的信息展示在以下两个页面的列表中： > - `疑点派发-疑点详情.html` > - `疑点处置-疑点详情.html` > > 因此，疑点链上信息通过“列表状态 + 行操作 + 链上详情弹窗”的方式承接。 ### 列表新增内容 | 类型 | 功能项 | 说明 | |---|---|---| | 列表字段 | 上链状态 | 展示当前疑点是否已上链 | | 查询条件 | 上链状态筛选 | 支持按状态筛选 | | 行操作 | 查看链上记录 | 已上链、上链异常可打开疑点链上详情弹窗 | ### 交互规则 - `已上链`：可打开疑点链上详情弹窗 - `上链异常`：可打开疑点链上详情弹窗 - `上链中`：点击后提示“正在上链中，请稍后查看” - `未上链`：不可打开弹窗 --- ## 6.5 疑点链上详情弹窗 适用页面： - `疑点派发-疑点详情.html` - `疑点处置-疑点详情.html` ### 建议展示字段 #### 1）基础信息 - 上链状态 - 唯一访问码 - 上链节点 #### 2）链上信息 - 交易哈希 #### 3）校验信息 - 验真状态 #### 4）异常补充（仅上链异常时显示） - 异常原因 #### 5）链上存证轨迹 每条轨迹展示： - 事件名称 - 时间 - 交易哈希 说明： - 疑点轨迹采用垂直时间轴展示 - 轨迹中**不重复展示唯一访问码** - 默认展示最新 `3` 条记录 - 历史记录折叠，可展开查看全部历史 - 退回或异常节点使用红色区分 ### 状态内容差异 - `已上链`：展示完整成功态内容 - `上链异常`：展示异常原因，并说明“以下展示最近一次成功链上记录” - `上链中`：本期不打开完整弹窗，只提示 - `未上链`：本期不打开弹窗 --- ## 7. 页面字段统一建议 建议页面统一使用以下字段口径： | 字段名 | 用途 | |---|---| | `chainStatus` | 上链状态 | | `evidenceNo` | 唯一访问码 | | `txHash` | 交易哈希 | | `verifyStatus` | 验真状态 | | `chainNode` | 上链节点 | | `chainErrorMsg` | 上链异常原因 | | `retryCount` | 重试次数（本期可不展示） | --- ## 8. Demo 示例要求 本期 Demo 需体现以下示例： ### 8.1 弹窗示例 - 规则 `已上链` 弹窗示例 - 规则 `上链异常` 弹窗示例 - 疑点 `已上链` 弹窗示例 - 疑点 `上链异常` 弹窗示例 ### 8.2 Tab 示例 - 规则 `已上链` Tab 示例 - 规则 `上链异常` Tab 示例 - 规则 `上链中` Tab 示例 - 规则 `未上链` Tab 示例 --- ## 9. 验收口径 - 页面状态统一使用：`未上链 / 上链中 / 已上链 / 上链异常` - 异常原因只在弹窗或详情页中展示，不在列表中单独加字段 - 规则与疑点弹窗字段结构一致，但规则有专门详情页 Tab，疑点无专门详情页 - 轨迹中不重复展示唯一访问码 - 规则详情 Tab 不展示摘要哈希 - 规则详情 Tab 展示链上记录数量 --- ## 10. 一句话总结 本期通过规则列表、规则详情页 `区块链信息` Tab、疑点详情列表及两类链上详情弹窗，完成区块链能力的一期可见化，并在 Demo 中体现不同上链状态下不同的弹窗内容和不同的 Tab 内容。