# 疑点详情页新增字段筛选 - 页面改动说明

## 1. 文档目的

本文档用于记录本次“疑点详情页新增字段筛选”在原型 Demo 中涉及的页面范围、具体改动点与交互变化，便于后续继续讨论和复用。

---

## 2. 本次改动概述

本次优化在疑点详情页中增加了一个轻量级字段筛选能力，重点解决“是否完成”“是否作废”两个固定字段的结构化筛选问题。

本次采用方案：

- `字段筛选` 按钮
- 页面内展开式筛选面板
- 两个固定字段下拉框
- 已生效条件标签展示

---

## 3. 涉及页面范围

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

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

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

- `疑点详情页新增字段筛选-PRD.md`
- `疑点详情页新增字段筛选-页面改动说明.md`

---

## 4. 各页面改动说明

## 4.1 疑点派发-疑点详情.html

### 改动类型

- 筛选区增强
- 列表记录属性增强
- 过滤逻辑增强

### 具体改动

#### 4.1.1 新增字段筛选入口

在现有筛选区中新增按钮：

- `字段筛选`

#### 4.1.2 新增展开面板

点击按钮后，页面内展开字段筛选面板。

面板中新增固定筛选项：

- 是否完成：全部 / 是 / 否
- 是否作废：全部 / 是 / 否

并新增按钮：

- 应用筛选
- 清空字段筛选

#### 4.1.3 新增已生效条件标签

当字段筛选生效时，页面中显示标签，例如：

- 是否完成：是
- 是否作废：否

支持点击标签中的关闭图标删除条件。

#### 4.1.4 为表格记录补充字段数据

为每一条疑点记录补充前端数据标识：

- `data-complete`
- `data-void`

用于支撑筛选逻辑。

#### 4.1.5 统一过滤逻辑

将以下条件并入同一套过滤逻辑：

- 派发状态
- 数据范围
- 搜索
- 是否完成
- 是否作废

这些条件统一按 AND 生效。

---

## 4.2 疑点处置-疑点详情.html

### 改动类型

- 筛选区增强
- 列表记录属性增强
- 过滤逻辑增强

### 具体改动

与 `疑点派发-疑点详情.html` 保持同口径：

- 增加 `字段筛选` 按钮
- 增加展开面板
- 增加“是否完成 / 是否作废”两个固定字段筛选
- 增加已生效条件标签
- 为每条记录补充 `data-complete`、`data-void`
- 将字段筛选与现有状态筛选、搜索统一并入一套过滤逻辑

不同点仅在于：

- 处置页没有现成的数据范围筛选项
- 因此逻辑链路是：
  - 处置状态 + 搜索 + 字段筛选

---

## 5. 交互变化总结

## 5.1 原流程

- 用户通过状态筛选和搜索缩小结果范围
- 无法对“是否完成”“是否作废”做明确结构化筛选

## 5.2 新流程

- 用户点击 `字段筛选`
- 展开筛选面板
- 选择：
  - 是否完成
  - 是否作废
- 点击 `应用筛选`
- 页面列表按新条件重新过滤
- 条件标签在页面上可见并可单独移除

---

## 6. 数据口径说明

### 6.1 字段范围

本次仅纳入两个字段：

- 是否完成
- 是否作废

暂不扩展其他业务字段。

### 6.2 取值范围

两个字段统一使用：

- 全部
- 是
- 否

### 6.3 空值口径

本轮按字段都有值处理，不单独设计空值筛选逻辑。

---

## 7. 验收检查点

### 7.1 页面入口

- 两张页面都出现 `字段筛选` 按钮
- 点击后能展开筛选面板

### 7.2 面板内容

- 面板中仅有两个固定字段：
  - 是否完成
  - 是否作废

### 7.3 筛选逻辑

- 字段筛选与现有筛选统一按 AND 生效
- 清空字段筛选后，只清除字段筛选条件，不清空其他筛选条件

### 7.4 页面反馈

- 生效条件能展示为标签
- 删除标签后能重新刷新筛选结果

---

## 8. 一句话总结

本次页面改动在疑点详情页中增加了一个轻量、可扩展的字段筛选入口，先以“是否完成”“是否作废”两个固定字段落地，帮助用户更快缩小疑点范围，提高筛选效率。
