> **源文件**：仪陇表务管理系统-PRD-04-功能需求说明-09-争议检定-V1.0.docx
> **导出时间**：2026-05-26 10:34


**仪陇表务管理系统
产品需求说明书
04-功能需求说明
争议检定**

文档版本：V1.0

对应 01 版本：仪陇表务管理系统-PRD-01-总体说明-V1.0

模块序号：09

模块名称：争议检定

## 争议检定

本模块覆盖用户水表计量争议引发的检定申请、审批、送检、检定及合格复位/不合格换表处置，含 Web 菜单：争议检定申请、争议检定任务；App 菜单：争议检定任务执行。与工单中心、入库管理、领取管理、水表检定记录联动。

### **争议检定申请**

#### 功能描述

用于营业办 / 供水站抄表员提交水表争议检定申请并查看自己历史提交的申请。完成层级审批后，将争议水表移交分公司库房并统一送至检定中心开展检定；检定合格则原表重新铅封挂接并安装至用户，检定不合格则为用户更换新水表。

#### 菜单权限

表务营业办/供水站职员；表务系统管理员

#### 数据权限

表务营业办/供水站职员：可见本菜单；「工单发起」Tab 可发起申请；「历史记录」Tab 仅展示当前登录账号作为发起人提交的申请工单。

表务系统管理员：可见、可操作全公司范围内争议检定申请数据。

流程中其他岗位人员通过工单中心查看与办理，不直接访问本菜单发起 Tab。

#### 核心逻辑

以争议检定申请工单为业务主体，提交时自动生成关联工单并进入审批流程。

本菜单仅负责发起与进度查询，不在此办理审核（审核在工单中心）。

审批通过后系统自动在「争议检定任务」按水表维度创建待办任务，不在本菜单办理送检与检定。

检定结果联动水表资产状态：合格更新为待铅封号绑定；不合格经分仓入库登记后更新为分公司在库。

#### 业务流程

流程概要

分公司抄表员发起 → 营业办/供水站主任一级审核 → 分公司分管领导二级审核 → 系统自动创建争议检定任务；后续送检、检定、复位/换表在「争议检定任务」及 App 执行菜单办理。

环节说明表

| 序号 | 环节名称 | 环节类型 | 责任岗位 | 须填写 / 处理内容 | 审核结果选项 | 通过后流向 | 驳回 / 其他结果流向 | 抄送 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 争议检定申请发起 | 发起 | 分公司-营业办/供水站抄表员 | 填报争议检定申请基础信息及争议水表明细（见「一级页面：争议检定申请-tab-工单发起」） | 提交 | 争议检定一级审核 | — | — |
| 2 | 争议检定一级审核 | 审核 | 分公司-营业办/供水站主任 | 核对争议事由、户表信息及申请合理性；填写审核意见 | 通过；驳回 | 争议检定二级审核 | 退回争议检定申请发起 | — |
| 3 | 争议检定二级审核 | 审核 | 分公司-领导班子 | 复核争议检定必要性及分公司处置安排；填写审核意见 | 通过；驳回 | 流程通过（系统自动处理） | 退回争议检定一级审核 | — |
| 4 | 自动生成争议检定任务 | 系统自动 | 系统 | 审批通过后按水表维度自动创建争议检定待办任务，进入「争议检定任务」菜单 | — | 流程完结 | — | — |

审核通过后数据影响

- 生成 / 更新争议检定申请记录及关联工单，工单状态为「已通过」。

- 按水表维度自动创建争议检定任务，初始状态为「待送总公司」。

- 同步更新争议水表业务状态，进入争议检定流程中状态。

- 驱动「争议检定任务」可跟踪进度；现场执行由「争议检定任务执行（App）」承接。

关联界面逻辑闭环

- 发起侧：「历史记录」Tab 与详情展示工单状态、当前节点；通过后展示关联任务编号及任务状态。

- 办理侧：「去处理」仅在审批中且当前用户为当前节点处理人时显示，跳转工单中心「二级页面：工单办理」。

- 任务侧：「争议检定任务」列表自动出现审批通过生成的任务；任务状态与 App 执行登记、检定结果回写一致。

- 检定侧：总公司检定完成后结果回写任务状态（已检定合格 / 检定不合格），并联动资产状态与「入库管理」「领取管理」后续办理。

- 跨菜单一致：工单状态、任务状态、水表状态文案在各菜单及工单中心保持一致。

审核界面说明

- 标准界面：复用工单中心「二级页面：工单办理」；含申请信息只读区、争议水表信息只读区、审批记录、审核意见（驳回时必填）、通过 / 驳回按钮。

- 本业务差异：各审核环节只读展示户号、户名、表号、争议事由及申请附件；无额外填报区块。

#### 功能需求

##### **一级页面：争议检定申请-tab-工单发起**

#整体布局

-- 菜单入口：Tab 页结构；Tab 列表：工单发起（本 Tab，默认选中）、历史记录（见「一级页面：争议检定申请-tab-历史记录」）

-- 本 Tab 内容：争议检定申请表单区 + 争议水表信息区；底部常驻「提交」「重置」

#信息展示

-- 申请基础信息区

-- 申请部门：只读，默认当前用户所属营业办 / 供水站

-- 申请人：只读，默认当前登录用户

-- 申请日期：只读，默认当前日期

-- 争议事由：必填，下拉单选（用户质疑读数、表计异常、其他）

-- 户号：必填，文本，支持从营销系统选择用户

-- 户名：只读，选择户号后自动带出

-- 安装地址：只读，选择户号后自动带出

-- 水表编号：必填，文本，支持扫码录入；须校验为在用水表且归属当前数据权限范围

-- 水表口径：只读，选择水表后自动带出

-- 水表类型：只读，选择水表后自动带出

-- 争议说明：必填，多行文本，最多 500 字

-- 现场照片：选填，支持上传图片（最多 5 张）

-- 备注：选填，多行文本，最多 200 字

#底部按钮

-- 提交：校验必填项后提交，进入工单审批流程

-- 重置：清空表单；有已填内容时二次确认

#交互说明

-- 提交成功后提示「提交成功」，自动切换至 Tab「历史记录」并刷新列表

-- Tab 切换时保留未提交内容；刷新页面后未提交内容不保留

##### **一级页面：争议检定申请-tab-历史记录**

#整体布局

-- 菜单入口 Tab「历史记录」；上下结构：查询条件区 + 历史工单列表

-- 数据范围：仅当前登录账号作为发起人提交的争议检定申请工单

#查询条件

-- 工单编号：文本，支持模糊搜索

-- 申请单号：文本，支持模糊搜索

-- 工单状态：下拉单选（全部、审批中、已通过、已驳回、已撤销）

-- 申请日期：日期范围选择

-- 功能按钮：查询、重置

#数据列表

-- 表格标题：我的争议检定申请

-- 表格字段：工单编号、申请单号、申请日期、户号、户名、水表编号、争议事由、当前节点、工单状态、关联任务编号、任务状态、提交时间

-- 行内操作：详情

#交互说明

-- 点击工单编号、行内「详情」或列表行，打开「弹窗：争议检定申请工单详情」

-- 列表按提交时间倒序，支持分页

-- 工单已通过且已生成任务时，任务状态与「争议检定任务」菜单一致

##### **弹窗：争议检定申请工单详情**

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：申请信息 / 审批记录

#弹窗标题

-- 争议检定申请详情 - {工单编号}

#标题栏操作

-- 关闭（×）：关闭抽屉，返回当前 Tab 列表

-- 全屏：无

#信息展示

-- Tab·申请信息：申请单号、工单编号、申请部门、申请人、申请日期、户号、户名、水表编号、争议事由、争议说明、工单状态、当前节点、关联任务编号、任务状态（已通过时展示）

-- Tab·审批记录：审批时间轴（环节、处理人、审核结果、审核意见、处理时间）

#底部按钮

-- 关闭：关闭抽屉

-- 去处理：仅审批中且当前用户为当前节点处理人时显示，跳转工单中心「二级页面：工单办理」

#交互说明

-- 本功能为只读查看 / 跟踪，非审核办理页

-- 已通过且已生成任务时，不提供任务办理入口（在「争议检定任务」及 App 办理）

### **争议检定任务**

#### 功能描述

承载争议检定任务创建、派单与进度管理。分公司争议检定申请审批通过后，系统按水表维度自动创建待办任务；亦支持管理人员直接派单。提供任务状态跟踪（待送总公司、总公司待检定、已检定合格、检定不合格）、送检确认及检定结果查看。

#### 菜单权限

表务营业办/供水站职员；表务营业办/供水站管理人员；表务分公司管理人员；表务水表管理中心；表务总公司管理人员；表务系统管理员

#### 数据权限

表务营业办/供水站职员、表务营业办/供水站管理人员、表务分公司管理人员：可见、可操作本分公司及下属营业办、供水站范围内的争议检定任务数据。

表务水表管理中心、表务总公司管理人员：可见、可操作全公司范围内争议检定任务数据；可登记总公司检定结果。

表务系统管理员：可见、可操作全公司范围内争议检定任务数据。

#### 核心逻辑

任务来源包括：争议检定申请审批通过后系统自动创建；授权管理人员在本菜单直接新建派单。

任务以单只争议水表为管理粒度，关联展示申请单、工单及检定记录。

送检确认、检定结果登记在本菜单（Web）办理；拆表、临时表安装、送检运输、复位 / 换表安装等现场步骤在 App 登记。

检定合格：拆表 → 送总公司检定中心 → 检定 → 取回 → 安装原表；检定不合格：拆表 → 送检 → 检定 → 总仓旧表入库 → 领用新表 → 安装新表。

#### 功能需求

##### **一级页面：争议检定任务**

#整体布局

-- 上下结构：查询条件区 + 数据列表区；顶部「新建任务」按钮（授权管理人员直派时使用）

#查询条件

-- 任务编号：文本，支持模糊搜索

-- 关联申请单号：文本，支持模糊搜索

-- 水表编号：文本，支持模糊搜索

-- 任务状态：下拉单选（全部、待送总公司、总公司待检定、已检定合格、检定不合格、已完成）

-- 所属分公司：组织下拉（总公司角色可选；分公司角色默认本分公司）

-- 任务日期：日期范围选择

-- 功能按钮：查询、重置

#数据列表

-- 表格标题：争议检定任务列表

-- 表格字段：任务编号、关联申请单号、关联工单编号、水表编号、户号、户名、所属分公司、任务状态、执行进度、检定结果、检定日期、创建时间

-- 行内操作：详情；送检确认（任务状态为「待送总公司」且当前用户有权限时显示）；关闭任务（已完成或异常终止时，授权角色可见）

#交互说明

-- 点击行或「详情」打开「弹窗：争议检定任务详情」

-- 审批通过的申请自动生成任务，列表自动刷新展示

-- 「新建任务」打开「弹窗：新建/编辑争议检定任务」（管理人员直接派单，不经过申请审批）

-- 送检确认后任务状态更新为「总公司待检定」

##### **弹窗：新建/编辑争议检定任务**

#弹窗类型

-- 居中模态弹窗；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 800px；表单区

#信息展示

-- 任务名称：必填，文本，最多 100 字

-- 水表编号：必填，文本，支持扫码；须校验水表在库 / 在网状态

-- 户号 / 户名：选择水表后只读带出（在网水表）

-- 执行人：必填，人员选择，默认争议水表所属营业办 / 供水站抄表员

-- 任务时限：必填，日期

-- 关联申请单号：选填，只读或选择（来源于已通过申请时系统带入）

-- 备注：选填，多行文本

#底部按钮

-- 保存：校验后保存并下发任务，任务状态为「待送总公司」

-- 取消：关闭弹窗

#交互说明

-- 直接派单不生成审批工单；保存后刷新一级页面列表

##### **弹窗：争议检定任务详情**

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有

#整体布局

-- 宽度约 1100px；Tab：任务信息 / 执行记录 / 检定结果

#信息展示

-- 任务编号、关联申请单号、水表编号、户号、户名、任务状态、执行进度、执行人、创建人、创建时间

-- 执行记录 Tab：App 登记的状态节点时间轴（已拆除安装临时表、已返回总公司检定中心、已重新安装等）

-- 检定结果 Tab：检定结论、检定日期、检定人员、关联检定记录 ID（有则展示）

#底部按钮

-- 关闭

-- 送检确认：任务状态为「待送总公司」时显示

-- 登记检定结果：任务状态为「总公司待检定」且当前用户为总公司检定人员时显示，打开「弹窗：登记争议检定结果」

#交互说明

-- 检定合格流程：拆表 → 送总公司检定中心 → 总公司检定 → 取回分公司 → 安装原表（App 分步登记）

-- 检定不合格流程：拆表 → 送检 → 总公司检定 → 总仓旧表入库（争议检定不合格）→ 分公司领用新表 → 安装新表

-- 检定结果登记后联动更新水表资产状态及检定台账

##### **弹窗：登记争议检定结果**

#弹窗类型

-- 居中模态弹窗；遮罩：有

#信息展示

-- 检定结果：必填，单选（合格、不合格）

-- 检定日期：必填，日期，默认当前日期

-- 检定人员：只读，默认当前登录用户

-- 关联检定记录：选填，从「水表检定记录」选择或自动匹配

-- 检定说明：选填，多行文本

#底部按钮

-- 保存：校验后更新任务状态及水表资产信息

-- 取消：关闭弹窗

#交互说明

-- 合格：任务状态更新为「已检定合格」，水表状态更新为待铅封号绑定，驱动 App 复位安装

-- 不合格：任务状态更新为「检定不合格」，驱动总仓旧表入库及分公司领用新表换表流程

### **争议检定任务执行（App）**

#### 功能描述

面向抄表员移动端作业，针对争议检定水表登记现场执行情况，包括已拆除安装临时表、已返回总公司检定中心、已重新安装争议表（合格复位）或已重新安装新表（不合格换表）等节点，实现争议检定外勤执行留痕。

#### 菜单权限

表务营业办/供水站职员；表务水表管理中心；表务系统管理员

#### 数据权限

表务营业办/供水站职员：可见、可操作本人作为执行人的争议检定 App 任务及执行登记数据。

表务水表管理中心：可见全公司范围内争议检定 App 任务数据（只读，不可代替执行人登记现场节点）。

表务系统管理员：可见、可操作全公司范围内争议检定 App 任务数据。

#### 核心逻辑

App 任务数据来源于「争议检定任务」派单或审批通过自动生成，执行人与 Web 任务一致。

现场执行登记回写任务执行进度，与 Web 任务详情、水表资产状态联动。

不合格换表场景中新表编号登记须与领取 / 出库业务已领用水表一致（扫码校验）。

#### 功能需求

##### **一级页面：争议检定任务列表（App）**

#整体布局

-- 上下结构：顶部筛选区 + 任务卡片列表；支持下拉刷新、上拉加载

#页面标题

-- 标题文案：争议检定任务

-- 返回：返回 App 首页

#查询条件

-- 任务状态：下拉（全部、待执行、执行中、待复位、已完成）

#信息展示

-- 卡片字段：任务编号、水表编号、户号、户名、任务状态、任务时限

#交互说明

-- 点击卡片进入「二级页面：争议检定任务详情（App）」

-- 列表默认展示当前登录用户作为执行人的任务

##### **二级页面：争议检定任务详情（App）**

#整体布局

-- 上下结构：导航栏 + 任务信息区 + 执行操作区

#页面标题

-- 标题文案：任务详情

-- 返回：返回「一级页面：争议检定任务列表（App）」

#信息展示

-- 任务编号、水表编号、户号、户名、安装地址、任务状态、执行进度、争议事由（只读）

-- 已登记执行节点时间轴

#底部按钮

-- 登记执行状态：任务未完成时显示，打开「三级页面：争议检定执行登记（App）」

#交互说明

-- 执行人可登记：已拆除安装临时表、已返回总公司检定中心、已重新安装争议表（原表复位）/ 已重新安装新表（不合格换表）

-- 登记后同步刷新 Web「争议检定任务」详情中的执行记录

##### **三级页面：争议检定执行登记（App）**

#整体布局

-- 表单填报页；顶部固定标题，底部固定提交按钮

#页面标题

-- 标题文案：执行登记

-- 返回：返回「二级页面：争议检定任务详情（App）」

#信息展示

-- 执行节点：必填，单选（已拆除安装临时表、已返回总公司检定中心、已重新安装争议表、已重新安装新表）

-- 登记时间：只读，默认当前时间

-- 临时表编号：选填，节点为「已拆除安装临时表」时必填

-- 新表编号：选填，节点为「已重新安装新表」时必填，支持扫码

-- 现场照片：选填，支持拍照上传（最多 3 张）

-- 备注：选填，多行文本

#底部按钮

-- 提交：校验后保存执行记录并更新任务执行进度

#交互说明

-- 提交成功后返回任务详情页并刷新进度

-- 支持离线暂存，网络恢复后自动提交（须 PRD 移动端通用能力支持）

---

## 详细设计（研发）

> 以下内容合并自 `design/功能设计/`，与 PRD 需求章节配套使用。数据模型详见 `design/数据库设计-V1.0.md`。

### 仪陇表务-功能设计-09-争议检定-V1.0


## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 09 |
| 模块名称 | 争议检定 |
| 后端包（建议） | `com.tofly.wm.manage.verify.dispute` |
| 业务模式 | 申请工单+任务 |
| 工单 | DISPUTE_VERIFY_APPLY |

## 2. 功能范围

- 争议检定申请
- 争议检定任务
- App 执行

## 3. 数据模型

### 3.1 涉及表

- `wssmet_disverifyapply_w`
- `wssmet_disverifytask_w`
- `wssmet_disverifyexec_w`

### 3.2 实体约定

- 所有实体 `extends BaseEntity`；逻辑删除 `Boolean deleted` ↔ `deleted`。
- 字典 `DictEntry` + `@DictDirectory(MeterConstant.*)` ↔ 库列 `VARCHAR2`；组织/用户 `OrganizationEntry`/`UserNameEntry` ↔ 库列 `NUMBER(19)`；附件 `FileEntryList`/`FileEntry` 用 `@TableField(exist = false)`，**无库列**。
- 申请类主表含 `process_instance_id / work_order_code / approve_status`；工单反查 `（无本地表，见 workflow）.TABLE_NAME` + `TABLE_ID`。

## 4. 业务流程

抄表员申请→审批→自动派单→临时表/送检/复位。

## 5. 核心业务规则

- 现场照片 `FileEntryList`，`@TableField(exist = false)`，无库列
- 营销户档联动

## 6. 接口设计（概要）

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | `/disputeApply/` | 见 PRD 界面 |
| — | `/disputeTask/` | 见 PRD 界面 |

- 标准 CRUD 另含：`GET /page`、`GET /list`、`POST /update`、`DELETE /{id}`、`DELETE /deleteByIds`。
- 返回体：须为带**具体**泛型的 `ResultResponse<...>`，见下文 §接口设计（研发）各接口出参（**禁止** `T`/`Vo` 占位）。

## 7. 权限与数据范围

遵循 PRD-02：菜单角色 + 组织数据权限 + 工单岗位权限；具体角色见 PRD-04 各功能「菜单权限」「数据权限」章节。

## 8. 上下游依赖

| 上游 | 下游 |
|------|------|
| 见 PRD-03 流程说明 | 见 PRD-01 总体主流程 |

---

*本设计仅依据 `../demand/` PRD 与 [数据库设计-V1.0.md](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*



---

## 接口设计（研发）

> 统一前缀：`/api/wm/manage/verify/dispute`；各接口 **出参** 须为具体泛型（见下文，**禁止** `T`/`Vo` 占位）；公共约定见 [仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)。

#### 争议检定申请-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询争议检定申请 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyApply/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| disputeReasonCode | String（字典 code） | 争议原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| disputeDesc | String | 争议 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<PageInfo<DisputeVerifyApplyVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<DisputeVerifyApplyVo> | 当前页数据列表 |

**`DisputeVerifyApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| disputeReasonCode | String（字典 code） | 争议原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| disputeDesc | String | 争议 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |
#### 争议检定申请-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询争议检定申请 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyApply/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| disputeReasonCode | String（字典 code） | 争议原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| disputeDesc | String | 争议 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<List<DisputeVerifyApplyVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<DisputeVerifyApplyVo>）元素字段**

**`DisputeVerifyApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| disputeReasonCode | String（字典 code） | 争议原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| disputeDesc | String | 争议 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |
#### 争议检定申请-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询争议检定申请详情 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyApply/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<DisputeVerifyApplyVo>（含明细 list 若适用）

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（DisputeVerifyApplyVo）字段**

**`DisputeVerifyApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| disputeReasonCode | String（字典 code） | 争议原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| disputeDesc | String | 争议 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

#### 争议检定申请-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增争议检定申请；提交时同步发起 workflow，回写 process_instance_id / work_order_code / approve_status |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyApply/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| disputeReasonCode | String（字典 code） | 争议原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| disputeDesc | String | 争议 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 争议检定申请-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改争议检定申请 |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyApply/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| disputeReasonCode | String（字典 code） | 争议原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| installAddress | String | 安装地址 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| disputeDesc | String | 争议 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 争议检定申请-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除争议检定申请（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/verify/dispute/disputeVerifyApply/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 争议检定任务-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询争议检定任务 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyTask/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskName | String | 任务 |
| userNo | String | 用户 |
| userName | String | 用户 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| execProgressCode | String（枚举 code） | 执行进度 |

**出参**

- ResultResponse<PageInfo<DisputeVerifyTaskVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<DisputeVerifyTaskVo> | 当前页数据列表 |

**`DisputeVerifyTaskVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| applyId | Long | 争议检定申请ID，关联wssmet_disverifyapply_w表的id字段 |
| taskName | String | 任务 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定结果 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| execProgressCode | String（枚举 code） | 执行进度 |
#### 争议检定任务-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询争议检定任务 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyTask/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskName | String | 任务 |
| userNo | String | 用户 |
| userName | String | 用户 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| execProgressCode | String（枚举 code） | 执行进度 |

**出参**

- ResultResponse<List<DisputeVerifyTaskVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<DisputeVerifyTaskVo>）元素字段**

**`DisputeVerifyTaskVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| applyId | Long | 争议检定申请ID，关联wssmet_disverifyapply_w表的id字段 |
| taskName | String | 任务 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定结果 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| execProgressCode | String（枚举 code） | 执行进度 |
#### 争议检定任务-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询争议检定任务详情 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyTask/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<DisputeVerifyTaskVo>（含明细 list 若适用）

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（DisputeVerifyTaskVo）字段**

**`DisputeVerifyTaskVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| applyId | Long | 争议检定申请ID，关联wssmet_disverifyapply_w表的id字段 |
| taskName | String | 任务 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定结果 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| execProgressCode | String（枚举 code） | 执行进度 |

#### 争议检定任务-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增争议检定任务 |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyTask/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| applyId | Long | 争议检定申请ID，关联wssmet_disverifyapply_w表的id字段 |
| taskName | String | 任务 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| execProgressCode | String（枚举 code） | 执行进度 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 争议检定任务-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改争议检定任务 |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyTask/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| applyId | Long | 争议检定申请ID，关联wssmet_disverifyapply_w表的id字段 |
| taskName | String | 任务 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| taskDeadline | String | 任务 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| execProgressCode | String（枚举 code） | 执行进度 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 争议检定任务-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除争议检定任务（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/verify/dispute/disputeVerifyTask/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 争议检定现场执行-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询争议检定现场执行 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyExec/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表编号 |
| newMeterCode | String | 新水表编号 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<DisputeVerifyExecVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<DisputeVerifyExecVo> | 当前页数据列表 |

**`DisputeVerifyExecVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表 |
| newMeterCode | String | 新水表 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |
#### 争议检定现场执行-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询争议检定现场执行 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyExec/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表编号 |
| newMeterCode | String | 新水表编号 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<DisputeVerifyExecVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<DisputeVerifyExecVo>）元素字段**

**`DisputeVerifyExecVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表 |
| newMeterCode | String | 新水表 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |
#### 争议检定现场执行-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询争议检定现场执行详情 |
| 请求地址 | `GET /api/wm/manage/verify/dispute/disputeVerifyExec/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<DisputeVerifyExecVo>（含明细 list 若适用）

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（DisputeVerifyExecVo）字段**

**`DisputeVerifyExecVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表 |
| newMeterCode | String | 新水表 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |

#### 争议检定现场执行-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增争议检定现场执行 |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyExec/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表编号 |
| newMeterCode | String | 新水表编号 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 争议检定现场执行-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改争议检定现场执行 |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyExec/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表编号 |
| newMeterCode | String | 新水表编号 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 争议检定现场执行-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除争议检定现场执行（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/verify/dispute/disputeVerifyExec/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### App执行节点登记

| 项 | 内容 |
|----|------|
| 接口说明 | 争议检定 App 分步登记 |
| 请求地址 | `POST /api/wm/manage/verify/dispute/disputeVerifyExec/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskId | Long | 争议检定任务ID，关联wssmet_disverifytask_w表的id字段 |
| execNodeCode | String（枚举 code） | 执行节点 |
| tempMeterCode | String | 临时水表编号 |
| newMeterCode | String | 新水表编号 |
| execTime | DateTime | 执行时间 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。