# 风险监控区块链配套功能一期 - 页面改动说明

## 1. 文档目的

本文档用于记录本次“风险监控区块链配套功能一期”在原型 Demo 中涉及的页面范围、具体改动点与交互口径，便于后续继续讨论和复用。

---

## 2. 本次改动概述

本次原型聚焦区块链能力的一期页面配套展示，核心目标是让用户在页面中看见链上状态、打开链上详情、区分不同状态下的展示内容。

核心改动包括：

- 规则列表页增加上链状态、唯一访问码和规则链上详情弹窗入口
- 规则详情页增加 `区块链信息` Tab，并区分不同状态下的 Tab 内容
- 疑点派发详情页增加上链状态列、状态筛选和疑点链上详情弹窗入口
- 疑点处置详情页增加上链状态列、状态筛选和疑点链上详情弹窗入口
- 对 `已上链 / 上链异常 / 上链中 / 未上链` 进行差异化展示

本期统一采用以下状态口径：

- `未上链`
- `上链中`
- `已上链`
- `上链异常`

---

## 3. 涉及页面范围

本次涉及页面如下：

- `风险规则-我的规则.html`
- `规则详情.html`
- `疑点派发-疑点详情.html`
- `疑点处置-疑点详情.html`

本次更新文档如下：

- `风险监控区块链配套功能一期-PRD.md`
- `风险监控区块链配套功能一期-页面改动说明.md`

---

## 4. 页面改动说明

## 4.1 `风险规则-我的规则.html`

### 改动内容

#### 4.1.1 列表状态口径调整

- 将列表状态统一为：
  - `未上链`
  - `上链中`
  - `已上链`
  - `上链异常`

#### 4.1.2 筛选项调整

- `上链状态` 筛选项同步调整为上述四种状态

#### 4.1.3 弹窗入口规则

- `已上链`：点击状态标签或 `查看链上记录` 打开规则链上详情弹窗
- `上链异常`：点击状态标签或 `查看链上记录` 打开规则链上详情弹窗
- `上链中`：点击后提示“正在上链中，请稍后查看”
- `未上链`：不可打开弹窗

#### 4.1.4 规则链上详情弹窗展示内容

**基础信息**

- 上链状态
- 唯一访问码
- 上链节点

**链上信息**

- 交易哈希

**校验信息**

- 验真状态

**异常补充（仅上链异常）**

- 异常原因

**链上存证轨迹**

- 事件名称
- 时间
- 交易哈希

说明：

- 轨迹中不重复展示唯一访问码
- 默认展示最新 `3` 条记录
- 支持展开全部历史记录

### 页面示例体现

- 页面中保留 `已上链` 示例规则
- 页面中保留 `上链异常` 示例规则
- 页面中保留 `上链中` 示例规则
- 页面中保留 `未上链` 示例规则

---

## 4.2 `规则详情.html`

### 改动内容

#### 4.2.1 新增 `区块链信息` Tab

用于规则链上信息的完整查看。

#### 4.2.2 Tab 字段调整

**存证汇总**

- 上链状态
- 唯一访问码
- 上链节点
- 链上记录数量

**链上信息**

- 交易哈希

**校验信息**

- 验真状态

**异常补充（仅上链异常）**

- 异常原因

**链上存证轨迹**

- 事件名称
- 时间
- 交易哈希

说明：

- 轨迹中不重复展示唯一访问码
- 不展示摘要哈希
- 默认展示最新 `3` 条记录
- 支持展开全部历史记录

#### 4.2.3 不同状态下的 Tab 内容差异

**已上链**

- 展示完整成功态信息与轨迹

**上链异常**

- 顶部增加异常提示
- 展示异常原因
- 显示最近一次成功链上记录的交易哈希
- 轨迹中保留异常节点

**上链中**

- 顶部增加处理中提示
- 上链状态显示 `上链中`
- 交易哈希显示 `待生成`
- 验真状态显示 `待验真`
- 链上记录数量显示“共 N 条（含 1 条处理中）”
- 轨迹中增加 `处理中` 节点

**未上链**

- 展示未上链状态
- 轨迹区显示空状态提示
- 验真状态显示 `暂不可验真`

---

## 4.3 `疑点派发-疑点详情.html`

### 改动内容

#### 4.3.1 状态口径调整

- 状态统一为：`未上链 / 上链中 / 已上链 / 上链异常`

#### 4.3.2 筛选项调整

- `上链状态` 筛选同步支持四种状态

#### 4.3.3 弹窗入口规则

- `已上链`：点击状态标签或菜单项打开疑点链上详情弹窗
- `上链异常`：点击状态标签或菜单项打开疑点链上详情弹窗
- `上链中`：点击后提示“正在上链中，请稍后查看”
- `未上链`：不可打开弹窗

#### 4.3.4 疑点链上详情弹窗展示内容

**基础信息**

- 上链状态
- 唯一访问码
- 上链节点

**链上信息**

- 交易哈希

**校验信息**

- 验真状态

**异常补充（仅上链异常）**

- 异常原因

**链上存证轨迹**

- 事件名称
- 时间
- 交易哈希

说明：

- 轨迹中不重复展示唯一访问码
- 默认展示最新 `3` 条记录
- 支持展开历史轨迹

### 页面示例体现

- 页面中展示 `已上链` 示例疑点
- 页面中展示 `上链异常` 示例疑点
- 页面中展示 `上链中` 示例疑点
- 页面中展示 `未上链` 示例疑点

---

## 4.4 `疑点处置-疑点详情.html`

### 改动内容

#### 4.4.1 状态口径调整

- 状态统一为：`未上链 / 上链中 / 已上链 / 上链异常`

#### 4.4.2 筛选项调整

- `上链状态` 筛选同步支持四种状态

#### 4.4.3 弹窗入口规则

- `已上链`：点击状态标签或菜单项打开疑点链上详情弹窗
- `上链异常`：点击状态标签或菜单项打开疑点链上详情弹窗
- `上链中`：点击后提示“正在上链中，请稍后查看”
- `未上链`：不可打开弹窗

#### 4.4.4 疑点链上详情弹窗展示内容

- 与 `疑点派发-疑点详情.html` 保持一致

### 页面作用

- 重点体现处置过程中的链上留痕已经进入业务处理页面

---

## 5. 统一展示原则

### 5.1 规则与疑点的差异

- `规则`：有独立的 `规则详情.html -> 区块链信息 Tab`
- `疑点`：没有独立详情页，因此疑点完整链上信息通过弹窗承接

### 5.2 异常原因展示原则

- 列表中不单独增加 `异常原因` 字段
- `异常原因` 只在：
  - 规则链上详情弹窗
  - 疑点链上详情弹窗
  - 规则详情页 `区块链信息` Tab
  中展示

### 5.3 轨迹展示原则

- 轨迹中不重复展示唯一访问码
- 轨迹统一展示：事件名称、时间、交易哈希

---

## 6. 验收检查点

- 页面统一使用：`未上链 / 上链中 / 已上链 / 上链异常`
- 规则弹窗与疑点弹窗字段结构一致，但规则有独立详情 Tab，疑点无独立详情页
- 规则详情页 `区块链信息` Tab 不展示摘要哈希
- 规则详情页 `区块链信息` Tab 展示链上记录数量
- Demo 中能够看到不同状态下不同的弹窗内容和不同的 Tab 内容

---

## 7. 一句话总结

本次页面改动围绕“规则列表 + 规则详情 Tab + 疑点详情列表 + 两类链上详情弹窗”构建一期最小闭环，并在 Demo 中明确体现不同上链状态下的差异化展示。