# 场景疑点页新增业务时间与数据范围筛选 - 页面改动说明

## 1. 文档目的

本文档用于记录本次“场景疑点页新增业务时间与数据范围筛选”在原型 Demo 中涉及的页面范围、具体改动点和实现口径，便于后续继续讨论、回溯或扩展修改。

---

## 2. 本次改动概述

本次改动目标是：

- 在场景疑点页的规则视角和业务视角下，都增加 `业务时间` 与 `数据范围` 两个筛选项
- 两个视角之间共用这两个筛选状态
- 数据范围候选项取自当前场景配置的数据范围
- 两个页面（疑点派发 / 疑点处置）口径完全一致

---

## 3. 涉及页面范围

本次实际改动的页面文件如下：

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

本次新增的说明文档如下：

- `场景疑点页新增业务时间与数据范围筛选-PRD.md`
- `场景疑点页新增业务时间与数据范围筛选-页面改动说明.md`

---

## 4. 页面改动说明

## 4.1 疑点派发-场景疑点.html

### 改动类型

- 筛选区增强
- mock 数据增强
- 筛选逻辑实现
- 视图渲染逻辑增强

### 具体改动

#### 4.1.1 规则视角筛选区新增项

新增：

- 业务时间（日期范围）
- 数据范围（多选下拉）

保留原有：

- 风险等级
- 处置类型
- 搜索
- 查询按钮

#### 4.1.2 业务视角筛选区新增项

新增：

- 业务时间（日期范围）
- 数据范围（多选下拉）

保留原有：

- 风险等级
- 处置类型
- 搜索业务字段
- 查询按钮

#### 4.1.3 新增共享筛选状态

新增共享状态对象，用于在两个视角间同步：

- 开始日期
- 结束日期
- 已选数据范围

#### 4.1.4 新增数据范围候选项来源

为 mock 数据补充了：

- 业务时间字段
- 数据范围字段

并从这些数据中提取出当前场景可用的数据范围候选项，作为筛选控件数据源。

#### 4.1.5 渲染逻辑改造

新增“先筛选，后聚合”的处理逻辑：

- 规则视角：筛选后再按规则聚合
- 业务视角：筛选后再按单据聚合

#### 4.1.6 空状态补充

当筛选后无数据时：

- 列表不报错、不空白
- 显示：`当前筛选条件下暂无疑点数据`

---

## 4.2 疑点处置-场景疑点.html

### 改动类型

- 筛选区增强
- mock 数据增强
- 筛选逻辑实现
- 视图渲染逻辑增强

### 具体改动

#### 4.2.1 规则视角筛选区新增项

新增：

- 业务时间（日期范围）
- 数据范围（多选下拉）

#### 4.2.2 业务视角筛选区新增项

新增：

- 业务时间（日期范围）
- 数据范围（多选下拉）

#### 4.2.3 与派发页完全同口径

与 `疑点派发-场景疑点.html` 保持一致：

- 筛选项一致
- 筛选状态共享规则一致
- 数据范围来源一致
- 筛选顺序一致
- 校验与空状态一致

#### 4.2.4 渲染逻辑改造

同样采用“先筛选，后聚合”逻辑：

- 规则视角：筛选后再按规则聚合
- 业务视角：筛选后再按单据聚合

---

## 5. 新增交互说明

## 5.1 业务时间

- 用户可输入开始日期和结束日期
- 两个视角共用同一份日期范围状态
- 日期非法时提示：`开始日期不能晚于结束日期`

## 5.2 数据范围

- 使用多选下拉形式
- 两个视角共用同一份数据范围状态
- 默认选中当前场景全部数据范围
- 当全部选中时，用“全部数据范围（N）”摘要显示

## 5.3 视角切换

- 从规则视角切到业务视角，不丢失业务时间和数据范围
- 从业务视角切到规则视角，不丢失业务时间和数据范围

---

## 6. 逻辑变化说明

## 6.1 原逻辑

原场景疑点页中的筛选按钮为占位逻辑：

- 规则视角点击“查询”仅提示待实现
- 业务视角点击“查询”仅提示待实现

## 6.2 新逻辑

本次已补充为可工作的原型逻辑：

- 规则视角查询：
  - 先按业务时间、数据范围等条件过滤
  - 再按规则重算列表
- 业务视角查询：
  - 先按业务时间、数据范围等条件过滤
  - 再按单据和规则组重算列表

---

## 7. 数据处理口径

### 7.1 规则视角

- 对原始疑点记录筛选后
- 聚合为规则结果
- 重算：新增数、待分派/待审核数、待处理数（派发页）
- 重算：新增数、待处理数（处置页）

### 7.2 业务视角

- 对原始疑点记录筛选后
- 聚合为单据结果
- 单据下仅保留命中的规则
- 命中规则数和统计数按筛选后结果重算

---

## 8. 验收检查点

### 8.1 控件层

- 两个页面都出现业务时间与数据范围筛选项
- 两个视角都能看到这两个控件

### 8.2 状态共享层

- 在一个视角中修改业务时间和数据范围后，切换视角仍然保留

### 8.3 数据范围来源层

- 数据范围候选项不使用全量组织，而使用当前场景配置的数据范围

### 8.4 查询结果层

- 规则视角和业务视角都能按新增条件筛选
- 两个视角结果口径一致

### 8.5 异常与空状态层

- 日期非法时有提示
- 无结果时显示空状态文案，而不是报错或空白

---

## 9. 一句话总结

本次页面改动让场景疑点页从“基础筛选”升级为“可按业务时间和场景数据范围做细粒度分析”的页面，同时保持两种视角口径统一、状态一致，更符合真实业务使用方式。
