# 风险监控区块链配套功能分阶段上线方案

## 1. 背景说明

- 当前风险规则从新增到上线，以及上线后的关键状态，已经完成区块链存证。
- 当前风险疑点的处置过程也已经完成区块链存证。
- 根据业主方要求，前端界面需要补充配套功能，使用户能够直观看到“哪些数据已上链、何时上链、如何验证、如何追溯”。

## 2. 建设目标

本次配套建设建议围绕以下四个目标展开：

- 可见：用户能在列表、详情、流程页面直接看到数据已上链。
- 可查：用户能查询到具体的链上记录。
- 可验：用户能验证当前数据与链上存证是否一致。
- 可溯：用户能基于时间轴追踪规则和疑点处置的链上过程。

## 3. 总体实施策略

建议采用“先展示、后验真、再统计增强”的分阶段建设方式：

- 一期优先做低成本、高感知、可快速上线的功能。
- 二期补充验真、时间轴、失败补偿等能力。
- 三期再建设统计看板、版本比对、链上链下一致性分析等增强能力。

## 4. 分阶段上线方案

### 4.1 一期：快速上线、低改造成本

#### 4.1.1 建设目标

- 让业主和业务人员在现有页面中能够直接看到“数据已经上链”。
- 尽量不改动原有主业务流程，以列表字段、详情展示、弹窗查看为主。

#### 4.1.2 建议功能清单

| 功能项 | 改造页面 | 功能说明 | 实现难度 | 用户感知 |
|---|---|---|---|---|
| 上链状态展示 | 风险规则列表、风险疑点列表 | 增加`上链状态`列，展示未上链、上链中、已上链、上链失败 | 低 | 高 |
| 上链时间展示 | 风险规则列表、风险疑点列表、详情页 | 展示最近一次上链时间 | 低 | 高 |
| 存证编号展示 | 规则详情、疑点详情、处置详情 | 展示对应链上存证编号 | 低 | 高 |
| 链上详情弹窗 | 规则详情、疑点详情、处置详情 | 点击“查看链上记录”后弹出链上信息 | 低 | 高 |
| 上链状态筛选 | 风险规则列表、风险疑点列表 | 按已上链、未上链、失败状态进行筛选 | 低 | 中高 |

#### 4.1.3 页面改造建议

**风险规则列表**

- 增加字段：`上链状态`、`上链时间`、`存证编号`
- 增加筛选：`全部`、`已上链`、`未上链`、`上链失败`
- 状态标签建议：
  - `已上链`
  - `上链中`
  - `未上链`
  - `上链失败`

**风险规则详情**

- 新增`区块链信息`区域或页签
- 展示字段：
  - 存证编号
  - 交易哈希
  - 区块高度
  - 上链时间
  - 摘要哈希
  - 当前验证状态
- 增加按钮：`查看链上记录`

**风险疑点列表**

- 增加字段：`处置上链状态`、`最近上链节点`、`上链时间`
- 支持按上链状态筛选

**风险疑点/处置详情**

- 新增`区块链信息`区域
- 展示当前疑点处置过程是否已完成链上存证
- 支持查看当前记录对应的链上详情

#### 4.1.4 一期最小接口字段建议

为降低改造成本，后端优先补充以下字段即可：

| 字段名 | 含义 |
|---|---|
| `chainStatus` | 上链状态 |
| `chainTime` | 上链时间 |
| `evidenceNo` | 存证编号 |
| `txHash` | 交易哈希 |
| `blockHeight` | 区块高度 |
| `contentHash` | 摘要哈希 |
| `verifyStatus` | 验真状态 |
| `chainErrorMsg` | 上链失败原因 |

#### 4.1.5 一期价值

- 上线快，开发和测试成本较低。
- 不依赖复杂的链上校验联动逻辑。
- 能快速满足业主“页面上能体现数据已上链”的直接诉求。

### 4.2 二期：补充验真与流程追溯能力

#### 4.2.1 建设目标

- 在“能看到已上链”的基础上，进一步让用户“能验证、能追溯”。

#### 4.2.2 建议功能清单

| 功能项 | 改造页面 | 功能说明 | 实现难度 | 用户价值 |
|---|---|---|---|---|
| 一键验真 | 规则详情、疑点详情、处置详情 | 比对当前业务数据与链上摘要是否一致 | 中 | 高 |
| 链上时间轴 | 规则详情、处置详情 | 展示各关键节点的上链记录 | 中 | 高 |
| 上链失败重试 | 列表页、详情页 | 对失败记录支持手动重试 | 中 | 中高 |
| 失败原因查看 | 列表页、详情页 | 展示失败原因、失败时间、重试次数 | 低 | 中高 |
| 存证证明导出 | 详情页 | 导出PDF/Word存证证明 | 中 | 高 |

#### 4.2.3 页面改造建议

**风险规则详情**

- 新增`版本链上记录时间轴`
- 展示：新增、提交审核、审核通过、上线、变更等节点是否已上链
- 增加`一键验真`按钮

**风险处置详情**

- 新增`链上流转时间轴`
- 展示：分发、签收、退回、协同、办结、关闭等节点的链上记录
- 支持逐节点查看存证信息

#### 4.2.4 二期价值

- 从“静态展示”升级为“可验证、可追责”。
- 更适合面向审计、合规和业主验收场景。

### 4.3 三期：统计分析与增强应用

#### 4.3.1 建设目标

- 形成链上能力的统一运营、分析和汇报能力。

#### 4.3.2 建议功能清单

| 功能项 | 改造页面 | 功能说明 | 实现难度 | 用户价值 |
|---|---|---|---|---|
| 上链统计看板 | 风险监控大屏、区块链管理 | 展示上链总数、今日新增、失败数、验证通过率 | 中 | 高 |
| 版本差异比对 | 风险规则详情 | 对不同版本规则做差异展示并关联链上记录 | 中 | 中高 |
| 链上链下一致性分析 | 区块链管理 | 批量检查链上摘要与业务库数据一致性 | 高 | 高 |
| 二维码存证分享 | 详情页、导出页 | 生成二维码，扫码查看存证详情 | 低 | 中 |
| 部门/业务域上链覆盖率 | 统计页面 | 展示不同部门、业务域的上链情况 | 中 | 中高 |

#### 4.3.3 三期价值

- 支撑日常运营分析、领导汇报和管理驾驶舱展示。
- 将区块链能力从“存证工具”提升为“可信管理能力”。

## 5. 推荐优先级

### 5.1 P0：建议立即纳入一期

- 列表页上链状态展示
- 列表页上链时间展示
- 详情页区块链信息展示
- 查看链上记录弹窗
- 上链状态筛选

### 5.2 P1：建议纳入二期

- 一键验真
- 链上时间轴
- 上链失败原因查看
- 上链失败重试
- 存证证明导出

### 5.3 P2：建议纳入三期

- 上链统计看板
- 规则版本差异比对
- 链上链下一致性分析
- 二维码分享存证详情

## 6. 界面展示字段建议

建议在规则、疑点、处置相关页面统一展示以下字段：

| 字段 | 展示建议 |
|---|---|
| 上链状态 | 列表页标签展示 |
| 存证编号 | 列表简写、详情完整展示 |
| 上链时间 | 列表和详情展示 |
| 交易哈希 | 详情展示，可复制 |
| 区块高度 | 详情展示 |
| 摘要哈希 | 详情展示，可复制 |
| 验真状态 | 详情展示 |
| 最近验证时间 | 详情展示 |
| 上链节点/通道 | 详情展示 |
| 失败原因 | 失败场景展示 |
| 重试次数 | 失败场景展示 |

## 7. 统一交互建议

### 7.1 状态标签建议

- `已上链`：绿色
- `上链中`：蓝色
- `未上链`：灰色
- `上链失败`：红色
- `验真通过`：绿色
- `验真异常`：红色

### 7.2 操作入口建议

- 列表页：适合展示状态、时间、筛选、快捷查看
- 详情页：适合展示完整链上信息、一键验真、导出存证证明
- 时间轴：适合流程类、节点类链上记录查看

### 7.3 展示原则

- 不改变原有核心业务路径
- 优先采用增量式改造
- 用户一眼能识别“是否已上链”
- 复杂链上信息默认折叠，通过弹窗或详情展开

## 8. 方案建议结论

结合当前已完成的区块链建设情况，建议按以下路径实施：

### 第一阶段目标

- 先把“已上链可见化”做出来
- 以低成本、少改动、快上线为原则
- 快速满足业主方展示诉求

### 第二阶段目标

- 再把“可验真、可追溯”做出来
- 让区块链能力从展示升级为可核验能力

### 第三阶段目标

- 最后做统计、看板、比对分析等增强能力
- 提升管理价值和汇报价值

## 9. 推荐的一期最小上线包

如果需要尽快上线，建议一期仅上线以下内容：

1. 风险规则列表增加上链状态、上链时间、存证编号
2. 风险疑点列表增加处置上链状态、上链时间
3. 规则详情增加区块链信息区域
4. 疑点/处置详情增加区块链信息区域
5. 增加查看链上记录弹窗
6. 增加按上链状态筛选功能

该方案具备以下特点：

- 改造面小
- 实现难度低
- 用户感知强
- 适合短周期上线
- 便于后续平滑扩展到验真和统计能力