# 疑点甄别功能扩展至普通规则 PRD

## 1. 文档信息

- 文档名称：疑点甄别功能扩展至普通规则 PRD
- 所属模块：全知平台 / 风控模块 / 风险疑点
- 文档类型：功能扩展 PRD
- 前置依赖：AI规则疑点甄别一期（`AI规则疑点甄别-PRD.md`）、AI规则疑点甄别与准确率追踪（`AI规则疑点甄别与准确率追踪PRD.md`）
- 变更记录：
  - 2026-05-09：取消 F1（规则甄别开关），所有规则默认启用甄别
  - 2026-05-09：F4 由"仅运营方"改为"所有用户可访问，按角色控制数据范围"
  - 2026-05-11：F5 去除普通规则"可甄别"标签；F4 新增视图切换、查看详情弹窗、恢复操作、排除人单位列、场景/规则编号展示、搜索简化

---

## 2. 背景

AI 规则疑点甄别一期已落地，业务方可在疑点派发环节对 AI 规则疑点执行"确认疑点/排除疑点"。客户现希望将甄别能力扩展到普通规则。

### 2.1 两类规则甄别的差异

| 维度 | AI 规则 | 普通规则 |
|------|---------|----------|
| 误报来源 | 提示词/模型不确定性 | 数据源质量、边界场景、规则逻辑缺陷 |
| 甄别价值 | 高（反哺提示词调优） | 中（过滤噪音、发现问题规则） |
| 闭环链路 | 甄别 → 准确率追踪 → 调优提示词 → 效果对比 | 甄别 → 发现问题 → 修改规则代码 → 重新发版 |
| 疑点量级 | 相对少 | 通常更多 |

### 2.2 为什么要做

- 普通规则同样存在误报（数据源问题、边界场景），业务方有排除噪音的需求
- 统一操作体验，降低用户心智负担（不需要先判断"这是 AI 规则还是普通规则"再决定能否甄别）
- 为后续全量规则准确率追踪打基础
- 所有用户都需要查看和管理已排除疑点，而非仅限运营方

---

## 3. 设计原则

### 3.1 所有规则统一启用甄别

所有规则（AI规则 + 普通规则）默认启用疑点甄别，不设置启用/关闭开关。简化配置，统一操作体验。

### 3.2 操作体验与 AI 规则统一

业务方在派发详情页的操作逻辑保持一致：确认疑点、排除疑点、查看已排除疑点。

### 3.3 已排除页面继续按规则隔离

现有按规则隔离的"已排除疑点"页面结构不变，同时新增一个跨规则的汇总视图。

### 3.4 不强制先甄别再派发

延续 AI 规则的柔性策略——待甄别状态下允许直接派发，已派发后锁定不可再甄别。

### 3.5 已排除汇总页按角色控制数据范围

所有用户均可访问已排除疑点汇总页，但数据范围按角色区分：管理员看全部，普通用户看自己所属场景。

---

## 4. 功能范围

### 4.1 本次要做

| 序号 | 功能项 | 说明 |
|------|--------|------|
| ~~F1~~ | ~~规则甄别开关~~ | **已取消**。所有规则默认启用甄别，不设开关 |
| F2 | 派发环节甄别 | 所有规则的疑点在派发详情页均展示甄别状态和甄别操作 |
| F3 | 普通规则已排除疑点页 | 已排除疑点页面支持承接普通规则的已排除数据（按规则隔离） |
| F4 | 已排除疑点汇总页 | 新增跨场景、跨规则的汇总视图，所有用户可访问，按角色控制数据范围 |
| F5 | 场景疑点页标识 | 普通规则在场景疑点页不显示标签（去除"可甄别"），仅保留AI规则标签 |

### 4.2 本次不做

- 规则验证环节的普通规则甄别（当前无承载页面，且普通规则无试跑概念）
- 普通规则准确率看板（后续独立迭代）
- 普通规则调优记录（调优链路不同，走代码发版而非提示词修改）
- 处置环节的甄别反馈（后续迭代，本期聚焦派发环节）

---

## 5. 详细方案

### ~~5.1 F1：规则甄别开关~~ — 已取消

> **决策说明**：所有规则（AI规则 + 普通规则）默认启用疑点甄别，不设置启用/关闭开关。理由：
> 1. 简化配置，减少管理员操作负担
> 2. 统一操作体验，用户无需判断规则是否启用了甄别
> 3. 甄别功能本身是轻量的（选填排除原因），开启不会增加额外负担

---

### 5.2 F2：派发环节甄别

#### 适用页面

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

#### 改动内容

当前逻辑：

```
AI 规则疑点 → 显示 疑点甄别 + 甄别状态
普通规则疑点 → 不显示 疑点甄别
```

新逻辑：

```
AI 规则疑点 → 显示 疑点甄别 + 甄别状态（不变）
普通规则疑点 → 显示 疑点甄别 + 甄别状态（新增）
```

#### 甄别弹窗

与 AI 规则共用同一个弹窗，字段一致：

- 疑点编号
- 触发规则
- 规则类型（**AI规则** / **普通规则**，动态显示）
- 疑点描述（AI规则：AI生成；普通规则：疑点描述模板生成）
- 排除原因（选填）

操作按钮：确认疑点 / 排除疑点

#### 操作列菜单

操作列采用三点悬浮菜单样式，菜单项根据派发状态动态调整：

| 派发状态 | 菜单项（从上到下） |
|----------|-------------------|
| 未派发 | 疑点派发、放白名单、疑点甄别、查看链上记录、查看完整流程 |
| 已派发 | 放白名单、疑点甄别、查看链上记录、查看完整流程 |

> 已派发的疑点不显示"疑点派发"选项，其余菜单项与未派发一致。

#### 状态与操作规则

完全复用 AI 规则一期逻辑：

| 条件 | 行为 |
|------|------|
| 未派发 | 可甄别 |
| 已派发 | 不可甄别，锁定 |
| 确认疑点 | 状态 → 已确认疑点，可正常派发 |
| 排除疑点 | 从主列表移出，进入已排除疑点页 |
| 从已排除恢复 | 回到主列表，状态 → 待甄别 |

#### 批量甄别

在疑点派发详情页底部批量操作栏中，提供"批量甄别"按钮。选中多条疑点后，可对所选疑点执行批量甄别操作。

**适用条件**：仅"需处置"类型场景，选中组别为 A 组（未派发/派发驳回）时显示。

**批量甄别弹窗**：

- 弹窗标题：批量甄别
- 提示信息：已选择 X 条疑点，请选择甄别结果
- 排除原因：选填文本框，若执行排除操作可填写原因
- 操作按钮：
  - **确认疑点**（btn-success）—— 将所选疑点全部标记为"已确认疑点"
  - **排除疑点**（btn-danger）—— 将所选疑点全部标记为"已排除"，从主列表移出并进入已排除疑点页

**与单个甄别的差异**：

| 维度 | 单个甄别 | 批量甄别 |
|------|----------|----------|
| 弹窗内容 | 展示疑点编号、触发规则、规则类型、疑点描述 | 展示选中数量、排除原因输入框 |
| 排除原因 | 选填 | 选填（共用） |
| 操作按钮 | 确认疑点 / 排除疑点 | 确认疑点 / 排除疑点（一致） |
| 作用范围 | 单条疑点 | 所选全部疑点 |
| 执行后效果 | 更新单条状态 / 移除单行 | 批量更新状态 / 批量移除行 |

**操作规则**：与单个甄别一致——已派发的疑点不可甄别，确认后状态更新为"已确认疑点"，排除后移入已排除列表。

---

### 5.3 F3：普通规则已排除疑点页

#### 适用页面

`疑点派发-疑点详情-已排除疑点.html`

#### 改动

当前页面限定"当前场景 + 当前规则"下查看被排除的 AI 疑点。扩展后同时承接普通规则的已排除疑点。

**页面结构不变**：场景信息卡片 + 规则信息卡片 + 搜索区 + 列表区。

**列表字段**沿用现有（疑点编号、排除时间、排除原因、疑点描述等），其中"疑点描述"字段：
- AI 规则：AI 生成
- 普通规则：疑点描述模板生成

**操作不变**：恢复到疑点列表。

---

### 5.4 F4：已排除疑点汇总页（新增）

#### 页面定位

所有用户均可查看和管理已排除疑点，支持二次确认。数据范围按角色区分。

#### 入口

风控运营管理 → 已排除疑点汇总（新增子菜单）。

#### 数据权限模型

| 用户角色 | 数据范围 | 说明 |
|----------|----------|------|
| 管理员 | 全部场景 | 可查看所有场景、所有规则的已排除疑点 |
| 普通用户 | 所属场景 | 仅可查看自己被分配或负责的场景下的已排除疑点 |

> 后端根据当前登录用户的角色和场景归属自动过滤数据。前端筛选区中的"业务域"和"风险场景"下拉选项也按角色范围加载。

#### 页面结构

##### 视图切换

页面右上角提供视图切换按钮，支持管理员与普通用户视角切换：

| 视图 | 标识 | 数据范围 |
|------|------|----------|
| 管理员视图 | 绿色标签"管理员视图 - 全部场景" | 全部场景数据 |
| 普通用户视图 | 蓝色标签"普通用户视图 - 所属场景" | 仅所属场景数据 |

切换后同步更新：页面提示文字、筛选区下拉选项范围、列表数据范围。

##### 顶部筛选区

| 筛选项 | 类型 | 说明 |
|--------|------|------|
| 业务域 | 下拉单选 | 管理员：全部业务域；普通用户：仅所属业务域 |
| 风险场景 | 下拉单选 | 管理员：全部场景；普通用户：仅所属场景；选项展示"场景名称 (编号)"格式 |
| 规则类型 | 下拉单选 | 全部 / AI规则 / 普通规则 |
| 排除时间 | 日期范围 | 开始日期 + 结束日期 |
| 搜索 | 文本输入 | 不选字段，统一搜索规则名称、规则编号、疑点编号、排除人；输入框悬浮展示完整提示 |

##### 列表区

| 列字段 | 说明 |
|--------|------|
| 疑点编号 | 疑点唯一标识 |
| 所属场景 | 场景名称 + 场景编号（小字灰色） |
| 触发规则 | 规则名称 + 规则编号（小字灰色） |
| 规则类型 | AI规则 / 普通规则 |
| 疑点描述 | 疑点的业务描述信息 |
| 排除人 | 执行排除的业务方 |
| 排除人单位 | 排除人所属单位 |
| 排除时间 | 执行排除的时间 |
| 操作 | 悬浮三点菜单，包含：查看详情、恢复到疑点列表 |

##### 操作说明

| 操作 | 效果 |
|------|------|
| 查看详情 | 弹窗展示疑点基本信息、业务信息（横向表格，支持水平滚动）、排除信息 |
| 恢复到疑点列表 | 确认后将疑点从已排除状态恢复到原规则主疑点列表 |

操作列采用三点悬浮菜单样式（参考风险规则-我的规则.html），鼠标悬浮展开操作项。

---

### 5.5 F5：场景疑点页标识

#### 适用页面

`疑点派发-场景疑点.html`

#### 改动

当前仅对 AI 规则显示 `AI` 标识。扩展后：

| 规则类型 | 标识 |
|----------|------|
| AI 规则 | `AI` 标签（蓝色） |
| 普通规则 | 不显示标签（所有规则统一启用甄别，"可甄别"标签无实际区分意义） |

> 决策说明：普通规则统一显示"可甄别"标签没有实际意义，已去除。保留 AI 标签是因为 AI 规则是用户特别关注的类型。

---

## 6. 页面改动汇总

| 页面 | 改动类型 | 改动内容 |
|------|----------|----------|
| ~~`规则详情.html`~~ | ~~修改~~ | ~~普通规则基本信息区新增"启用疑点甄别"开关~~ **（已取消，无需改动）** |
| `疑点派发-场景疑点.html` | 修改 | 去除普通规则"可甄别"标签，仅保留AI规则标签 |
| `疑点派发-疑点详情.html` | 修改 | 所有普通规则显示甄别状态列 + 疑点甄别操作 + 新增批量甄别功能（确认疑点/排除疑点） |
| `疑点派发-疑点详情-已排除疑点.html` | 修改 | 同时承接普通规则已排除疑点 + 新增排除人/排除人单位列 |
| `已排除疑点汇总.html` | **新增** | 全用户跨规则汇总视图 + 视图切换 + 恢复操作 + 查看详情弹窗 + 排除人单位 + 场景/规则编号 + 搜索简化 |

---

## 7. 数据模型变更

### 7.1 RISK_RULE_LIST 表

~~新增 `ENABLE_SCREENING` 字段~~ **已取消**，所有规则默认启用甄别，无需此字段。

### 7.2 疑点甄别相关字段（已有）

现有 AI 规则甄别的疑点数据字段直接扩展至普通规则，无需新增列：

- `SCREENING_STATUS`（甄别状态）
- `SCREENING_SOURCE`（甄别来源）
- `SCREENING_USER`（甄别人）
- `SCREENING_TIME`（甄别时间）
- `SCREENING_REASON`（排除原因）
- `CONFIRM_USER`（确认人）
- `CONFIRM_TIME`（确认时间）
- `CONFIRM_OPINION`（确认意见）

---

## 8. 关键边界

| 场景 | 处理 |
|------|------|
| 所有普通规则 | 统一启用甄别，场景页不显示标签，派发页显示甄别状态和操作 |
| AI 规则 | 场景页始终显示 AI 标识，派发页显示甄别状态和操作（不变） |
| 已派发的疑点 | 无论 AI 还是普通规则，均不可再执行甄别 |
| 普通规则未配置疑点描述模板 | 甄别弹窗中"疑点描述"使用兜底文案 `命中规则：${ruleName}` |
| 已排除汇总页 - 管理员 | 查看全部场景数据 |
| 已排除汇总页 - 普通用户 | 仅查看所属场景数据，筛选区下拉选项同步过滤 |
| 已排除汇总页 - 视图切换 | 页面右上角提供切换按钮，可模拟管理员/普通用户视角 |
| 已排除汇总页 - 查看详情 | 弹窗展示基本信息、业务信息（横向表格+水平滚动）、排除信息 |
| 已排除汇总页 - 恢复操作 | 确认后疑点回到原规则主疑点列表 |
| 已排除汇总页 - 场景/规则编号 | 列表中场景名和规则名下方显示对应编号；场景筛选下拉显示"名称 (编号)"格式 |
| 已排除汇总页大量数据 | 默认分页，支持按排除时间缩小范围 |

---

## 9. 验收标准

### ~~9.1 规则配置~~ （已取消）
- ~~普通规则详情页出现"启用疑点甄别"开关~~
- ~~仅管理员可操作，仅已上线规则可开启~~
- ~~AI 规则详情页不展示该开关~~

### 9.2 派发环节
- 所有普通规则的疑点，派发详情页均出现"甄别状态"列
- 未派发疑点均显示"疑点甄别"操作按钮
- 操作列菜单项正确：未派发显示"疑点派发、放白名单、疑点甄别、查看链上记录、查看完整流程"；已派发不显示"疑点派发"
- "确认疑点"后状态更新
- "排除疑点"后从主列表移出并进入已排除页面
- 批量甄别弹窗同时包含"确认疑点"和"排除疑点"两个按钮
- 批量确认疑点后所选行甄别状态批量更新为"已确认疑点"
- 批量排除疑点后所选行从主列表批量移除并进入已排除列表

### 9.3 已排除页面（规则级）
- 同时展示 AI 规则和普通规则的已排除疑点
- 普通规则疑点描述为模板生成内容
- 支持恢复到疑点列表

### 9.4 已排除汇总页（全用户）
- 所有用户均可访问
- 管理员可查看全部场景数据
- 普通用户仅可查看所属场景数据
- 右上角视图切换按钮可切换管理员/普通用户视角
- 筛选区场景/业务域下拉选项按角色过滤，场景下拉显示"名称 (编号)"
- 搜索框统一搜索规则名称、规则编号、疑点编号、排除人
- 列表显示场景编号和规则编号
- 列表新增"排除人单位"和"疑点描述"列
- 操作列采用三点悬浮菜单样式
- 支持"查看详情"弹窗（业务信息横向表格+水平滚动）
- 支持"恢复到疑点列表"操作

### 9.5 场景疑点页
- 普通规则不显示标签（去除"可甄别"标识）
- AI 规则仍显示 AI 标识

---

## 10. 一句话总结

本次扩展将疑点甄别能力从 AI 规则延伸至普通规则，所有规则统一启用甄别（不设开关），在保持现有操作体验统一的前提下，为所有用户新增跨规则的已排除疑点汇总页，按角色控制数据范围（管理员看全部，普通用户看所属场景），并提供视图切换、查看详情弹窗、恢复操作、场景/规则编号展示等交互能力。