# 红绿灯响应等级功能 PRD

## 1. 文档信息

| 项目 | 内容 |
|------|------|
| 文档名称 | 红绿灯响应等级功能 PRD |
| 所属模块 | 全知平台 / 风控模块 / 风险规则 / 风险场景 |
| 文档类型 | 功能优化 PRD |
| 版本 | v1.0 |
| 编写日期 | 2026-05-29 |

---

## 2. 功能背景

### 2.1 现状

当前风险规则的处置方式分为两种：
- **提示**：处置人确认已读即可
- **需处置**：处置人提交处理结果，派发人审核

此外还有**Elink消息通知**作为第三种处置方式，疑点生成后自动发送消息并关闭。

### 2.2 问题

1. **命名不直观**："提示"和"需处置"是专业术语，用户需要理解后才能判断处置要求
2. **缺乏紧迫感**：无法直观体现风险的紧急程度
3. **处置方式单一**：只有两种处置流程，无法满足不同风险程度的处置需求

### 2.3 借鉴来源

参考南方电网"模型研发六步法"中的红绿灯响应机制：
- 🟢 绿灯：无需处置
- 🟡 黄灯：核查处理
- 🔴 红灯：限期处置

---

## 3. 功能目标

1. 用红绿灯替代现有的处置方式，提升用户理解效率
2. 细化处置流程，增加"核查反馈"和"限期处置"两种模式
3. 保持与现有功能的兼容，平滑过渡

---

## 4. 功能设计

### 4.1 响应等级定义

| 红绿灯 | 响应等级代码 | 含义 | 适用场景 |
|--------|--------------|------|----------|
| 🟢 绿灯 | `green` | 通知存档，自动发送Elink消息通知 | 数据统计类、趋势分析类规则 |
| 🟡 黄灯 | `yellow` | 核查反馈，填写核查情况后关闭 | 数据异常、流程偏差类规则 |
| 🔴 红灯 | `red_deadline` | 限期整改，超时发送提醒 | 合规风险、流程优化、整改类规则 |

### 4.2 与现有处置方式的映射

| 红绿灯 | 对应现有方式 | 变化说明 |
|--------|--------------|----------|
| 🟢 绿灯 | Elink消息通知 | 保持自动发送消息通知，无需人工处置 |
| 🟡 黄灯 | 提示 | 从"确认已读"升级为"填写核查情况" |
| 🔴 红灯 | 需处置 | 增加时间限制，超时发送提醒 |

### 4.3 配置方式

#### 4.3.1 规则级别配置

在规则创建/编辑页面，设置规则的**默认响应等级**：

- 入口：我的规则 → 创建规则 / 编辑规则
- 字段：响应等级（必填）
- 选项：🟢通知存档 / 🟡核查反馈 / 🔴限期整改

#### 4.3.2 场景级别配置

在风险场景关联规则时，可**灵活调整**响应等级：

- 入口：风险场景详情 → 关联规则 → 编辑规则配置
- 字段：场景响应等级（默认继承规则的响应等级）
- 说明：可根据场景需要调整，如将黄灯提升为红灯，或将红灯降低为黄灯

### 4.4 配置项说明

#### 4.4.1 绿灯配置项（通知存档）

| 配置项 | 必填 | 说明 |
|--------|------|------|
| 消息通知对象 | 否 | 接收Elink消息通知的人员（默认为规则关联人员） |

疑点生成后自动发送Elink消息通知相关人员，并自动记录关闭。

#### 4.4.2 黄灯配置项（核查反馈）

| 配置项 | 必填 | 说明 |
|--------|------|------|
| 处置人 | 是 | 填写核查情况的人员 |

#### 4.4.3 红灯配置项（限期整改）

| 配置项 | 必填 | 说明 |
|--------|------|------|
| 处置人 | 是 | 提交处理结果的人员 |
| 处置时限 | 是 | 处置期限（天数） |

- 处置时限在规则创建时设置默认值
- 在风险场景关联规则时，可根据场景需要调整处置时限
- 超期后系统自动发送Elink消息提醒处置人和派发人

#### 4.4.4 消息通知配置（可选）

| 配置项 | 说明 |
|--------|------|
| 疑点生成时通知 | 发送Elink消息通知处置人 |
| 处置超时时提醒 | 仅限期整改，超时自动发送提醒 |
| 处置完成后通知 | 通知相关人员处置结果 |

---

## 5. 处置流程设计

### 5.1 绿灯流程（通知存档）

```
疑点生成 → 自动发送Elink消息通知 → 自动记录 → 自动关闭
```

- 对应原Elink消息通知方式
- 系统自动发送消息通知相关人员
- 无需人工处置，疑点仅作为记录保留
- 状态流转：`待处理` → `已关闭（自动）`

### 5.2 黄灯流程（核查反馈）

```
疑点生成 → 派发给处置人 → 处置人填写核查情况 → 关闭
```

- 处置人需填写：核查结果、核查说明
- **无需审核**，填写后直接关闭
- 状态流转：`待派发` → `已派发待核查` → `已关闭`

### 5.3 红灯流程（限期整改）

```
疑点生成 → 派发给处置人 → 处置人在限期内提交处理结果 → 派发人审核
                                                          ├─ 通过 → 关闭
                                                          └─ 驳回 → 重新处置
                                              ↓（超期）
                                    自动发送Elink提醒 → 继续等待处置
```

- 处置人需填写：处理结果、处理说明、整改措施
- 派发人需审核：通过/驳回
- 需配置处置时限（如：3天、7天、15天）
- 状态流转：`待派发` → `已派发待处置` → `已处置待审核` → `已关闭`
- **处置时限覆盖范围**：从疑点分派到疑点关闭（含审核环节），即处置人提交审核 + 派发人审核通过，整个流程须在处置时限内完成

### 5.4 限期整改 — 处置时限展示

#### 5.4.1 处置截止时间计算规则

- 处置截止时间 = 派发日期 + 处置时限天数
- 按日期计算，不精确到时分秒，截止日当天 23:59:59 为最终截止
- 截止时间覆盖范围：从分派到关闭的完整流程（含处置 + 审核）
- 示例：派发日期 2026-05-20，处置时限 7 天 → 截止日期 2026-05-27（处置人须在此日期前提交审核，且派发人须在此日期前审核通过）

#### 5.4.2 处置时限展示位置

| 页面 | 展示方式 |
|------|----------|
| 规则详情页 | 基本信息区，响应等级下方显示"处置时限：X天"（配置值） |
| 场景疑点列表（派发+处置） | 响应等级胶囊后紧跟天数标签，如"限期整改 7天" |
| 疑点详情页（派发+处置） | 响应等级旁显示"处置时限：X天"（配置值）；疑点列表中每条疑点行显示"处置截止：YYYY-MM-DD"标签，颜色区分状态 |
| 已关闭/白名单/已排除疑点详情 | 展示处置时限（配置值） |

#### 5.4.3 处置截止时间状态显示

| 状态 | 显示 | 颜色 |
|------|------|------|
| 正常（距截止>2天） | 处置截止：2026-06-06 | 灰色 |
| 即将到期（≤2天） | 处置截止：2026-06-04 | 橙色，行背景浅黄 |
| 已超期 | 处置截止：2026-05-27 已超期 | 红色，行背景浅红 |

### 5.5 限期整改 — 超期处理机制

#### 5.5.1 展示层

- 超期疑点在疑点详情页列表中**高亮标红**（行背景 #fff1f0），**排序置顶**
- 即将到期（≤2天）用**橙色提示**（行背景 #fffde7）
- 疑点详情页每条疑点行显示"处置截止：YYYY-MM-DD"标签，已超期追加"已超期"文字

#### 5.5.2 提醒层

超期时系统自动发送Elink消息通知：
- **处置人**：提醒尽快处理，包含疑点编号、规则名称、已超期天数
- **派发人**：同步通知，关注超期情况

#### 5.5.3 状态层（待客户确认）

暂定方案：不新增独立状态，保持现有状态（已派发待处置/已处置待审核），在UI上用红色标签叠加显示"已超期"。后续根据客户反馈决定是否新增独立状态。

#### 5.5.4 统计层

在疑点统计分析页面新增超期相关指标：
- 超期率：超期疑点数 / 红灯疑点总数
- 平均超期时长：所有超期疑点的平均超期天数
- 超期疑点总数
- 超期趋势图：按月展示超期率变化

---

## 6. 状态流转设计

### 6.1 状态维度

疑点的状态由两个维度共同描述：

| 维度 | 含义 | 视角 |
|------|------|------|
| **派发状态** | 疑点是否已分派出去 | 派发人 |
| **处置状态** | 疑点当前处理到哪一步 | 处置流程 |

### 6.2 派发状态

| 派发状态 | 说明 | 适用等级 |
|----------|------|----------|
| 未派发 | 疑点刚生成，尚未派发 | 全部 |
| 已派发 | 已派发给处置人 | 全部 |
| 派发驳回 | 处置人驳回了疑点，需重新派发 | 红灯 |

### 6.3 处置状态

| 处置状态 | 说明 | 适用等级 | 是否关闭 |
|----------|------|----------|----------|
| （空） | 未派发时 | 全部 | 否 |
| 通知完毕 | 系统已发送Elink消息通知 | 绿灯 | 是 |
| 已派发待核查 | 等待处置人填写核查情况 | 黄灯 | 否 |
| 核查完毕 | 处置人已提交核查结果 | 黄灯 | 是 |
| 已派发待处置 | 等待处置人在限期内提交处理结果 | 红灯 | 否 |
| 已处置待审核 | 处置人已提交处理结果，等待派发人审核 | 红灯 | 否 |
| 处置完毕 | 派发人审核通过 | 红灯 | 是 |
| 自动消除 | 疑点自行消失，系统自动消除 | 全部 | 是 |

> 关闭态：通知完毕（绿灯）、核查完毕（黄灯）、处置完毕（红灯）、自动消除（全部）。放白名单的疑点不算已关闭疑点。

### 6.4 状态流转图

```
【绿灯-通知存档】
派发状态：未派发 → 已派发（系统自动发送Elink消息）
处置状态：空 → 通知完毕（关闭）
          空 → 自动消除（关闭）

【黄灯-核查反馈】
派发状态：未派发 → 已派发
处置状态：空 → 已派发待核查 → 核查完毕（关闭）
          空 → 自动消除（关闭）

【红灯-限期整改】
派发状态：未派发 → 已派发
          未派发 → 已派发 → 派发驳回（处置人驳回）
处置状态：空 → 已派发待处置 → 已处置待审核 → 处置完毕（关闭）
          空 → 已派发待处置 → 已处置待审核 → 已派发待处置（审核驳回，重新处置）
          空 → 自动消除（关闭）
```

---

## 7. 数据模型设计

### 7.1 规则表变更（RISK_RULE_LIST）

| 字段名 | 原字段 | 新字段 | 说明 |
|--------|--------|--------|------|
| 处置类型 | disposal_type | response_level | 值变为：green/yellow/red_deadline |

### 7.2 场景规则配置表变更

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| response_level | VARCHAR(20) | 是 | 响应等级：green/yellow/red_deadline |
| dispose_deadline | INT | 否 | 处置时限（天数），仅限期整改 |

### 7.3 疑点数据表变更

| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| response_level | VARCHAR(20) | 是 | 响应等级：green/yellow/red_block/red_deadline |
| dispose_deadline | DATETIME | 否 | 处置截止时间，仅限期处置 |
| check_result | VARCHAR(500) | 否 | 核查结果，仅黄灯 |
| check_remark | TEXT | 否 | 核查说明，仅黄灯 |

### 7.4 响应等级枚举值

| 代码 | 显示名称 | 颜色 | 图标 |
|------|----------|------|------|
| green | 通知存档 | 绿色 | 🟢 |
| yellow | 核查反馈 | 黄色 | 🟡 |
| red_deadline | 限期整改 | 红色 | 🔴 |

---

## 8. 接口设计

### 8.1 规则相关接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /core/riskRuleController/add | POST | 新增规则（response_level字段） |
| /core/riskRuleController/update | PUT | 更新规则（response_level字段） |

### 8.2 场景规则配置接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /core/riskScene/ruleConfig | POST | 配置场景规则响应等级 |
| /core/riskScene/ruleConfig/{id} | GET | 获取场景规则配置详情 |

### 8.3 疑点处置接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /core/riskDoubt/submitCheck | POST | 提交核查情况（黄灯） |
| /core/riskDoubt/submitDispose | POST | 提交处理结果（红灯） |
| /core/riskDoubt/batchSubmitCheck | POST | 批量提交核查情况 |
| /core/riskDoubt/batchSubmitDispose | POST | 批量提交处理结果 |

---

## 9. 业务流程

### 9.1 规则配置流程

```
1. 用户创建/编辑风险规则
2. 填写规则基本信息
3. 选择响应等级（🟢通知存档/🟡核查反馈/🔴限期整改）
4. 保存规则
```

### 9.2 场景关联规则流程

```
1. 用户进入风险场景详情
2. 点击"关联规则"
3. 选择要关联的规则
4. 系统显示规则的默认响应等级
5. 用户可根据场景需要调整响应等级
6. 配置处置人、处置时限等（根据响应等级）
7. 保存配置
```

### 9.3 疑点处置流程

```
1. 系统检测到风险数据
2. 生成疑点
3. 根据响应等级执行不同流程：
   - 绿灯（通知存档）：自动发送通知，自动关闭
   - 黄灯（核查反馈）：派发给处置人 → 处置人填写核查情况 → 关闭
   - 红灯（限期整改）：派发给处置人 → 处置人在限期内提交处理结果 → 审核 → 关闭
```

---

## 10. 验收标准

### 10.1 规则配置

- [ ] 规则创建/编辑页面可选择响应等级
- [ ] 选择"限期整改"时需配置处置时限
- [ ] 规则列表正确显示响应等级
- [ ] 规则详情页展示处置时限（仅限期整改）

### 10.2 场景关联规则

- [ ] 场景关联规则时显示规则的默认响应等级
- [ ] 可调整响应等级
- [ ] 根据响应等级显示不同的配置项
- [ ] 可调整处置时限（仅限期整改）

### 10.3 疑点处置

- [ ] 绿灯疑点自动发送通知并关闭
- [ ] 黄灯疑点可提交核查情况
- [ ] 红灯疑点可提交处理结果并审核
- [ ] 超期后自动发送Elink提醒处置人和派发人

### 10.4 界面展示

- [ ] 疑点列表用颜色标识响应等级
- [ ] 筛选器支持按响应等级筛选
- [ ] 批量操作支持对应响应等级
- [ ] 场景疑点列表中限期整改后显示天数标签
- [ ] 疑点详情页展示处置时限和剩余/超期天数
- [ ] 超期疑点折叠高亮、排序置顶
- [ ] 疑点统计分析页展示超期率、平均超期时长等指标

---

## 11. 版本历史

| 版本 | 日期 | 修改内容 | 修改人 |
|------|------|----------|--------|
| v1.0 | 2026-05-29 | 初始版本 | 产品经理 |
| v1.1 | 2026-06-01 | 响应等级命名统一为通知存档/核查反馈/限期整改，移除拦截叫停 | 产品经理 |
| v1.2 | 2026-06-01 | 新增限期整改处置时限展示、超期处理机制，移除超时处理方式配置 | 产品经理 |
| v1.3 | 2026-06-02 | 处置时限改为按日期计算（派发日+天数），展示处置截止时间而非剩余天数，超期展示层改为高亮+排序+截止日期标签 | 产品经理 |
| v1.4 | 2026-06-02 | 超期展示层（高亮+排序+截止日期标签）从场景疑点列表-业务视角移至疑点详情页 | 产品经理 |
| v1.5 | 2026-06-02 | 明确处置时限覆盖范围：从分派到关闭（含审核环节），超期文字"临近超期"改为"即将到期" | 产品经理 |
| v1.6 | 2026-06-03 | 第6章状态流转改为派发状态+处置状态双维度框架，新增关闭态定义和自动消除路径，第9.1节修正响应等级术语 | 产品经理 |