zenghaiyang/ylsw-bw @ 85a21dde455f4862709dd83f66dcd9997b252be1

仪陇表务管理系统产品需求说明书 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 移动端通用能力支持）

详细设计（研发）

仪陇表务-功能设计-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；实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc（`wssmet_` 表名），不参照存量业务表与接口。*

接口设计（研发）

争议检定申请-分页查询

项	内容
接口说明	分页查询争议检定申请
请求地址	`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>

data（PageInfo）字段

DisputeVerifyApplyVo 字段

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

字段	类型	说明
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>

data（List）元素字段

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（含明细 list 若适用）

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

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

data 无业务字段（null）。

争议检定申请-删除

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

入参（Query: ids）

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

出参

ResultResponse

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>

data（PageInfo）字段

DisputeVerifyTaskVo 字段

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

字段	类型	说明
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>

data（List）元素字段

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（含明细 list 若适用）

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

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

data 无业务字段（null）。

争议检定任务-删除

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

入参（Query: ids）

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

出参

ResultResponse

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>

data（PageInfo）字段

DisputeVerifyExecVo 字段

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

字段	类型	说明
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>

data（List）元素字段

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（含明细 list 若适用）

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

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

data 无业务字段（null）。

争议检定现场执行-删除

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

入参（Query: ids）

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

出参

ResultResponse

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

data 无业务字段（null）。

仪陇表务管理系统-PRD-04-功能需求说明-09-争议检定-V1.0.md 43 KB Lịch sử Raw

争议检定

争议检定申请

功能描述

菜单权限

数据权限

核心逻辑

业务流程

功能需求

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

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

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

争议检定任务

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：争议检定任务

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

弹窗：争议检定任务详情

弹窗：登记争议检定结果

争议检定任务执行（App）

功能描述

菜单权限

数据权限

核心逻辑

功能需求

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

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

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

详细设计（研发）

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

1. 模块概述

2. 功能范围

3. 数据模型

3.1 涉及表

3.2 实体约定

4. 业务流程

5. 核心业务规则

6. 接口设计（概要）

7. 权限与数据范围

8. 上下游依赖

接口设计（研发）

争议检定申请-分页查询

争议检定申请-列表查询

争议检定申请-详情

争议检定申请-新增

争议检定申请-修改

争议检定申请-删除

争议检定任务-分页查询

争议检定任务-列表查询

争议检定任务-详情

争议检定任务-新增

争议检定任务-修改

争议检定任务-删除

争议检定现场执行-分页查询

争议检定现场执行-列表查询

争议检定现场执行-详情

争议检定现场执行-新增

争议检定现场执行-修改

争议检定现场执行-删除

App执行节点登记

仪陇表务管理系统-PRD-04-功能需求说明-09-争议检定-V1.0.md 43 KB

Lịch sử Raw