源文件:仪陇表务管理系统-PRD-04-功能需求说明-18-拆表管理-V1.0.docx 导出时间:2026-05-26 10:34
仪陇表务管理系统 产品需求说明书 04-功能需求说明 拆表管理
文档版本:V1.0
对应 01 版本:仪陇表务管理系统-PRD-01-总体说明-V1.0
模块序号:18
模块名称:拆表管理
本模块覆盖用户销户、报停、拆迁等需拆除水表的业务,对应《PRD-01》拆表管理能力。含 Web 菜单:拆表申请、拆表任务管理;App 菜单:拆表任务。审批通过后驱动任务派单,现场拆表完成后衔接旧表退库与营销销户状态同步。
发起用户拆表(含销户拆表)申请并提交审批工单,提供拆表原因及用户信息填报能力,审批通过后驱动拆表任务管理派单,实现拆表申请与工单审批留痕。
表务营业办/供水站职员;表务营业办/供水站管理人员;表务分公司管理人员;表务总公司管理人员;表务水表管理中心;表务系统管理员
表务营业办/供水站职员:可见、可操作本机构范围内拆表申请发起;「历史记录」Tab 仅展示本人发起的申请工单。
表务营业办/供水站管理人员、表务分公司管理人员:可见、可操作本部门及管辖部门范围内拆表申请数据。
表务总公司管理人员、表务水表管理中心:可见全公司拆表申请(只读)。
表务系统管理员:可见、可操作全公司拆表申请数据。
以拆表申请工单为业务主体;审核通过后自动生成拆表任务,不在本菜单办理现场拆表。
流程概要
表务营业办/供水站职员发起 → 营业办/供水站管理人员一级审核 → 分公司管理人员二级审核 → 系统自动生成拆表任务并派单 → 安装员/抄表员 App 现场拆表 → 旧表归集并触发退库流转;管理人员亦可在「拆表任务管理」直接派单。
环节说明表
| 序号 | 环节名称 | 环节类型 | 责任岗位 | 须填写 / 处理内容 | 审核结果选项 | 通过后流向 | 驳回 / 其他结果流向 | 抄送 |
|---|---|---|---|---|---|---|---|---|
| 1 | 拆表申请发起 | 发起 | 表务营业办/供水站职员 | 填报拆表原因、用户信息及水表信息(见「一级页面:拆表申请-tab-工单发起」) | 提交 | 拆表一级审核 | — | — |
| 2 | 拆表一级审核 | 审核 | 表务营业办/供水站管理人员 | 核对拆表原因、用户销户/报停依据;填写审核意见 | 通过;驳回 | 拆表二级审核 | 退回拆表申请发起 | — |
| 3 | 拆表二级审核 | 审核 | 表务分公司管理人员 | 复核拆表合规性及资产处置安排;填写审核意见 | 通过;驳回 | 流程通过(系统自动) | 退回拆表一级审核 | — |
| 4 | 自动生成拆表任务 | 系统自动 | 系统 | 终审通过后自动生成拆表任务,初始状态「待执行」,同步 App 待办 | — | 待 App 现场执行 | — | — |
| 5 | 现场拆表作业 | 执行 | 表务营业办/供水站职员(安装员/抄表员) | App 现场拆表、止码抄录、拍照留痕、旧表归集登记 | 提交完成 | 流程完结(待退库) | — | — |
审核通过后数据影响
生成 / 更新拆表申请记录及关联工单,工单状态为「已通过」。
自动创建拆表任务及任务明细,任务状态为「待执行」。
App 提交完成后更新水表状态为「已拆表/待退库」,同步营销销户/报停状态(按拆表原因)。
驱动「退库管理」旧表入库登记衔接;追加生命周期「拆表」记录。
关联界面逻辑闭环
发起侧:「历史记录」Tab 展示工单及关联任务、退库状态。
任务侧:「拆表任务管理」展示关联申请及 App 回传止码、旧表归集状态。
退库侧:拆表完成后可在「入库管理(分公司仓)」办理旧表入库,状态与任务「旧表归集」一致。
营销侧:销户类拆表完成后营销用户状态与任务详情销户同步状态一致。
审核界面说明
标准界面:复用工单中心「二级页面:工单办理」。
本业务差异:只读展示用户信息、水表表号、拆表原因及销户/报停依据附件。
#整体布局
-- Tab 列表:工单发起(默认)、历史记录
-- 本 Tab:拆表申请表单 + 底部「提交」「重置」
#信息展示
-- 申请部门、申请人、申请日期:只读,默认当前用户/部门/日期
-- 用户编号:必填,支持选择用户
-- 用户名称:只读
-- 拆表原因:必填,下拉(销户拆表、报停拆表、拆迁拆表、其他)
-- 水表表号:必填,支持扫码;须为「在用」状态
-- 销户/报停依据:销户/报停类必填,支持上传附件
-- 备注:选填,多行文本
#底部按钮
-- 提交;重置
#交互说明
-- 提交成功后切换至「历史记录」Tab 并刷新
#整体布局
-- 查询条件 + 历史工单列表;数据范围:当前账号发起的拆表申请
#查询条件
-- 工单编号、申请单号、用户编号、工单状态、申请日期;查询、重置
#数据列表
-- 表格字段:工单编号、申请单号、用户编号、拆表原因、工单状态、关联任务编号、退库状态、提交时间
-- 行内操作:详情
#交互说明
-- 打开「弹窗:拆表申请工单详情」
#弹窗类型
-- 抽屉弹窗(右侧滑出);遮罩:有
#整体布局
-- 宽度约 960px;Tab:申请信息 / 审批记录
#信息展示
-- 申请及关联任务、退库状态只读展示
#底部按钮
-- 关闭;去处理(审批中且当前节点处理人可见)
#交互说明
-- 只读跟踪,审核在工单中心办理
定位拆表作业统筹与任务调度,提供拆表派单、执行人指定及任务进度跟踪能力,支持拆表审批工单通过后自动派单、管理人员直接派单及营销销户事件驱动,实现拆表任务统一管理与执行闭环。
表务营业办/供水站管理人员;表务分公司管理人员;表务总公司管理人员;表务水表管理中心;表务系统管理员
表务营业办/供水站管理人员:可见、可操作本营业办/供水站范围内拆表任务;可新建、派单。
表务分公司管理人员:可见、可操作本分公司及下属机构范围内拆表任务。
表务总公司管理人员、表务水表管理中心:可见全公司拆表任务(只读)。
表务系统管理员:可见、可操作全公司拆表任务。
任务来源:拆表申请审批通过、直接派单、营销销户事件驱动;现场作业在 App 办理。
#整体布局
-- 上下结构:查询条件 + 任务列表;右上角「新建任务」「直接派单」
#查询条件
-- 所属分公司、营业办/供水站、任务编号、任务状态、用户编号、执行人、计划完成日期;查询、重置
#数据列表
-- 表格字段:任务编号、用户编号、用户名称、水表表号、拆表原因、执行人、任务状态、关联申请单号、止码、旧表归集状态、创建时间
-- 行内操作:详情;分配人员;关闭
#交互说明
-- 审批通过或营销销户事件可驱动自动创建任务
-- 点击「详情」打开「弹窗:拆表任务详情」
#弹窗类型
-- 居中模态弹窗;遮罩:有
#信息展示
-- 用户编号、水表表号、拆表原因、执行人、计划完成日期、任务说明等必填/选填字段
#底部按钮
-- 保存并下发;取消
#弹窗类型
-- 抽屉弹窗(右侧);遮罩:有
#信息展示
-- 任务摘要、App 回传止码/照片/旧表归集状态、操作日志
#底部按钮
-- 分配人员;关闭任务;关闭
面向安装员/抄表员移动端作业,提供拆表任务接收、现场拆表、止码抄录、拍照留痕及旧表归集登记能力,支持外勤执行拆表任务管理下发的作业指令,实现拆表数据实时回传并触发旧表退库流转。
表务营业办/供水站职员
表务营业办/供水站职员:仅可查看及操作执行人为本人的拆表任务。
App 提交驱动任务完结、水表状态变更及退库衔接。
#整体布局
-- 任务卡片列表;下拉刷新、上拉加载
#页面标题
-- 标题文案:拆表任务
#查询条件
-- 任务状态:全部 / 待执行 / 执行中 / 已完成
#信息展示
-- 卡片:任务编号、用户名称、水表表号、拆表原因、计划完成日期、任务状态
#交互说明
-- 仅执行人为本人的任务;点击进入「二级页面:拆表任务详情(App)」
#页面标题
-- 标题文案:任务详情
#信息展示
-- 用户、水表、拆表原因、任务说明只读
#底部按钮
-- 开始拆表:进入「三级页面:现场拆表填报(App)」
#信息展示
-- 水表表号:只读,支持扫码复核
-- 拆表止码:必填,数值
-- 拆表原因确认:只读
-- 旧表归集登记:必填,下拉(已归集营业办/供水站、待归集)
-- 现场照片:必填,至少 1 张
-- GPS 定位:自动采集
-- 备注:选填
#底部按钮
-- 暂存;提交
#交互说明
-- 提交后任务「已完成」,水表状态更新,触发退库及营销状态同步
-- 支持离线暂存
以下内容合并自
design/功能设计/,与 PRD 需求章节配套使用。数据模型详见design/数据库设计-V1.0.md。
# 仪陇表务 — 功能设计 18 拆表管理 V1.0
需求来源:
../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-18-*.md
数据模型:见 数据库设计-V1.0.md
接口约定:见本文 §接口设计(研发)、仪陇表务-公共接口说明-V1.0.md、00-总体框架设计-V1.0.md
| 项 | 说明 |
|---|---|
| 模块序号 | 18 |
| 模块名称 | 拆表管理 |
| 后端包(建议) | com.tofly.wm.manage.remove |
| 业务模式 | 申请工单+任务 |
| 工单 | REMOVE_APPLY |
wssmet_removeapply_wwssmet_removetask_wwssmet_removerec_wextends 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。销户/报停等→拆表→止码→旧表归集→退库。
| 方法 | 路径(示例前缀) | 说明 |
|---|---|---|
| — | /removeApply/ |
见 PRD 界面 |
| — | /removeTask/ |
见 PRD 界面 |
GET /page、GET /list、POST /update、DELETE /{id}、DELETE /deleteByIds。ResultResponse<...>,见下文 §接口设计(研发)各接口出参(禁止 T/Vo 占位)。遵循 PRD-02:菜单角色 + 组织数据权限 + 工单岗位权限;具体角色见 PRD-04 各功能「菜单权限」「数据权限」章节。
| 上游 | 下游 |
|---|---|
| 见 PRD-03 流程说明 | 见 PRD-01 总体主流程 |
本设计仅依据 ../demand/ PRD 与 数据库设计-V1.0.md;实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc(`wssmet_` 表名),不参照存量业务表与接口。*
统一前缀:
/api/wm/manage/remove;各接口 出参 须为具体泛型(见下文,禁止T/Vo占位);公共约定见 仪陇表务-公共接口说明-V1.0.md。
| 项 | 内容 |
|---|---|
| 接口说明 | 分页查询拆表申请 |
| 请求地址 | GET /api/wm/manage/remove/removeApply/page |
| 请求类型 | GET |
入参(Query(PageQuery))
| 字段 | 类型 | 说明 |
|---|---|---|
| applyCode | String | 申请编号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(PageInfo)字段
| 字段 | 类型 | 说明 |
|---|---|---|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List | 当前页数据列表 |
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| applyCode | String | 申请 |
| removeReasonCode | String(字典 code) | 拆表原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterId | Long | 水表ID,关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID(工单中心外挂,不落本地工单表) |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
| 项 | 内容 |
|---|---|
| 接口说明 | 列表查询拆表申请 |
| 请求地址 | GET /api/wm/manage/remove/removeApply/list |
| 请求类型 | GET |
入参(Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| applyCode | String | 申请编号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(List)元素字段
RemoveApplyVo 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| applyCode | String | 申请 |
| removeReasonCode | String(字典 code) | 拆表原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterId | Long | 水表ID,关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID(工单中心外挂,不落本地工单表) |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
| 项 | 内容 |
|---|---|
| 接口说明 | 查询拆表申请详情 |
| 请求地址 | GET /api/wm/manage/remove/removeApply/{id} |
| 请求类型 | GET |
入参(Path: id)
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(RemoveApplyVo)字段
RemoveApplyVo 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| applyCode | String | 申请 |
| removeReasonCode | String(字典 code) | 拆表原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterId | Long | 水表ID,关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID(工单中心外挂,不落本地工单表) |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
| 项 | 内容 |
|---|---|
| 接口说明 | 新增拆表申请;提交时同步发起 workflow,回写 process_instance_id / work_order_code / approve_status |
| 请求地址 | POST /api/wm/manage/remove/removeApply/ |
| 请求类型 | POST |
入参(Body: Dto)
| 字段 | 类型 | 说明 |
|---|---|---|
| applyCode | String | 申请编号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterId | Long | 水表ID,关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID(工单中心外挂,不落本地工单表) |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
出参
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | Long | 新增记录主键 |
| 项 | 内容 |
|---|---|
| 接口说明 | 修改拆表申请 |
| 请求地址 | POST /api/wm/manage/remove/removeApply/update |
| 请求类型 | POST |
入参(Body: Dto(含 id))
| 字段 | 类型 | 说明 |
|---|---|---|
| applyCode | String | 申请编号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterId | Long | 水表ID,关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| returnStatusCode | String(枚举 code) | 退回状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID(工单中心外挂,不落本地工单表) |
| workOrderCode | String | 工单编号(展示/台账查询) |
| approveStatus | String(枚举 code) | 审批状态 |
出参
data 无业务字段(null)。
| 项 | 内容 |
|---|---|
| 接口说明 | 逻辑删除拆表申请(支持批量) |
| 请求地址 | DELETE /api/wm/manage/remove/removeApply/deleteByIds?ids=1,2 |
| 请求类型 | DELETE |
入参(Query: ids)
| 字段 | 类型 | 说明 |
|---|---|---|
| ids | String | 主键,逗号分隔 |
出参
data 无业务字段(null)。
| 项 | 内容 |
|---|---|
| 接口说明 | 分页查询拆表任务 |
| 请求地址 | GET /api/wm/manage/remove/removeTask/page |
| 请求类型 | GET |
入参(Query(PageQuery))
| 字段 | 类型 | 说明 |
|---|---|---|
| taskCode | String | 任务编号 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(PageInfo)字段
| 字段 | 类型 | 说明 |
|---|---|---|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List | 当前页数据列表 |
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| applyId | Long | 拆表申请ID,关联wssmet_removeapply_w表的id字段 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因 |
| executorId | Long | 执行人ID,关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
| 项 | 内容 |
|---|---|
| 接口说明 | 列表查询拆表任务 |
| 请求地址 | GET /api/wm/manage/remove/removeTask/list |
| 请求类型 | GET |
入参(Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| taskCode | String | 任务编号 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(List)元素字段
RemoveTaskVo 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| applyId | Long | 拆表申请ID,关联wssmet_removeapply_w表的id字段 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因 |
| executorId | Long | 执行人ID,关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
| 项 | 内容 |
|---|---|
| 接口说明 | 查询拆表任务详情 |
| 请求地址 | GET /api/wm/manage/remove/removeTask/{id} |
| 请求类型 | GET |
入参(Path: id)
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(RemoveTaskVo)字段
RemoveTaskVo 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| applyId | Long | 拆表申请ID,关联wssmet_removeapply_w表的id字段 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因 |
| executorId | Long | 执行人ID,关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
| 项 | 内容 |
|---|---|
| 接口说明 | 新增拆表任务 |
| 请求地址 | POST /api/wm/manage/remove/removeTask/ |
| 请求类型 | POST |
入参(Body: Dto)
| 字段 | 类型 | 说明 |
|---|---|---|
| taskCode | String | 任务编号 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| applyId | Long | 拆表申请ID,关联wssmet_removeapply_w表的id字段 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| executorId | Long | 执行人ID,关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
出参
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | Long | 新增记录主键 |
| 项 | 内容 |
|---|---|
| 接口说明 | 修改拆表任务 |
| 请求地址 | POST /api/wm/manage/remove/removeTask/update |
| 请求类型 | POST |
入参(Body: Dto(含 id))
| 字段 | 类型 | 说明 |
|---|---|---|
| taskCode | String | 任务编号 |
| taskSourceCode | String(枚举 code) | 任务来源 |
| applyId | Long | 拆表申请ID,关联wssmet_removeapply_w表的id字段 |
| userNo | String | 用户 |
| meterCode | String | 水表表号 |
| removeReasonCode | String(字典 code) | 拆表原因编号 |
| executorId | Long | 执行人ID,关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| taskStatusCode | String(枚举 code) | 任务状态 |
| finalReading | String | 最终读数 |
| oldMeterCollectStatusCode | String(枚举 code) | 旧水表归集状态 |
出参
data 无业务字段(null)。
| 项 | 内容 |
|---|---|
| 接口说明 | 逻辑删除拆表任务(支持批量) |
| 请求地址 | DELETE /api/wm/manage/remove/removeTask/deleteByIds?ids=1,2 |
| 请求类型 | DELETE |
入参(Query: ids)
| 字段 | 类型 | 说明 |
|---|---|---|
| ids | String | 主键,逗号分隔 |
出参
data 无业务字段(null)。
| 项 | 内容 |
|---|---|
| 接口说明 | 分页查询拆表现场记录 |
| 请求地址 | GET /api/wm/manage/remove/removeRecord/page |
| 请求类型 | GET |
入参(Query(PageQuery))
| 字段 | 类型 | 说明 |
|---|---|---|
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(PageInfo)字段
| 字段 | 类型 | 说明 |
|---|---|---|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List | 当前页数据列表 |
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
| 项 | 内容 |
|---|---|
| 接口说明 | 列表查询拆表现场记录 |
| 请求地址 | GET /api/wm/manage/remove/removeRecord/list |
| 请求类型 | GET |
入参(Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(List)元素字段
RemoveRecordVo 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
| 项 | 内容 |
|---|---|
| 接口说明 | 查询拆表现场记录详情 |
| 请求地址 | GET /api/wm/manage/remove/removeRecord/{id} |
| 请求类型 | GET |
入参(Path: id)
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
出参
外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。
data(RemoveRecordVo)字段
RemoveRecordVo 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 主键 |
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
| 项 | 内容 |
|---|---|
| 接口说明 | 新增拆表现场记录 |
| 请求地址 | POST /api/wm/manage/remove/removeRecord/ |
| 请求类型 | POST |
入参(Body: Dto)
| 字段 | 类型 | 说明 |
|---|---|---|
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
出参
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | Long | 新增记录主键 |
| 项 | 内容 |
|---|---|
| 接口说明 | 修改拆表现场记录 |
| 请求地址 | POST /api/wm/manage/remove/removeRecord/update |
| 请求类型 | POST |
入参(Body: Dto(含 id))
| 字段 | 类型 | 说明 |
|---|---|---|
| taskId | Long | 拆表任务ID,关联wssmet_removetask_w表的id字段 |
| meterCode | String | 水表表号 |
| finalReading | String | 最终读数 |
| collectStatusCode | String(枚举 code) | 归集状态 |
| gpsLat | String | GPS纬度 |
| gpsLng | String | GPS经度 |
| remark | String | 备注 |
出参
data 无业务字段(null)。
| 项 | 内容 |
|---|---|
| 接口说明 | 逻辑删除拆表现场记录(支持批量) |
| 请求地址 | DELETE /api/wm/manage/remove/removeRecord/deleteByIds?ids=1,2 |
| 请求类型 | DELETE |
入参(Query: ids)
| 字段 | 类型 | 说明 |
|---|---|---|
| ids | String | 主键,逗号分隔 |
出参
data 无业务字段(null)。