> **源文件**：仪陇表务管理系统-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：拆表申请表单 + 底部「提交」「重置」

#信息展示

-- 申请部门、申请人、申请日期：只读，默认当前用户/部门/日期

-- 用户编号：必填，支持选择用户

-- 用户名称：只读

-- 拆表原因：必填，下拉（销户拆表、报停拆表、拆迁拆表、其他）

-- 水表表号：必填，支持扫码；须为「在用」状态

-- 销户/报停依据：销户/报停类必填，支持上传附件

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

#底部按钮

-- 提交；重置

#交互说明

-- 提交成功后切换至「历史记录」Tab 并刷新

##### **一级页面：拆表申请-tab-历史记录**

#整体布局

-- 查询条件 + 历史工单列表；数据范围：当前账号发起的拆表申请

#查询条件

-- 工单编号、申请单号、用户编号、工单状态、申请日期；查询、重置

#数据列表

-- 表格字段：工单编号、申请单号、用户编号、拆表原因、工单状态、关联任务编号、退库状态、提交时间

-- 行内操作：详情

#交互说明

-- 打开「弹窗：拆表申请工单详情」

##### **弹窗：拆表申请工单详情**

#弹窗类型

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

#整体布局

-- 宽度约 960px；Tab：申请信息 / 审批记录

#信息展示

-- 申请及关联任务、退库状态只读展示

#底部按钮

-- 关闭；去处理（审批中且当前节点处理人可见）

#交互说明

-- 只读跟踪，审核在工单中心办理

### **拆表任务管理**

#### 功能描述

定位拆表作业统筹与任务调度，提供拆表派单、执行人指定及任务进度跟踪能力，支持拆表审批工单通过后自动派单、管理人员直接派单及营销销户事件驱动，实现拆表任务统一管理与执行闭环。

#### 菜单权限

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

#### 数据权限

表务营业办/供水站管理人员：可见、可操作本营业办/供水站范围内拆表任务；可新建、派单。

表务分公司管理人员：可见、可操作本分公司及下属机构范围内拆表任务。

表务总公司管理人员、表务水表管理中心：可见全公司拆表任务（只读）。

表务系统管理员：可见、可操作全公司拆表任务。

#### 核心逻辑

任务来源：拆表申请审批通过、直接派单、营销销户事件驱动；现场作业在 App 办理。

#### 功能需求

##### **一级页面：拆表任务管理**

#整体布局

-- 上下结构：查询条件 + 任务列表；右上角「新建任务」「直接派单」

#查询条件

-- 所属分公司、营业办/供水站、任务编号、任务状态、用户编号、执行人、计划完成日期；查询、重置

#数据列表

-- 表格字段：任务编号、用户编号、用户名称、水表表号、拆表原因、执行人、任务状态、关联申请单号、止码、旧表归集状态、创建时间

-- 行内操作：详情；分配人员；关闭

#交互说明

-- 审批通过或营销销户事件可驱动自动创建任务

-- 点击「详情」打开「弹窗：拆表任务详情」

##### **弹窗：新建/编辑拆表任务**

#弹窗类型

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

#信息展示

-- 用户编号、水表表号、拆表原因、执行人、计划完成日期、任务说明等必填/选填字段

#底部按钮

-- 保存并下发；取消

##### **弹窗：拆表任务详情**

#弹窗类型

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

#信息展示

-- 任务摘要、App 回传止码/照片/旧表归集状态、操作日志

#底部按钮

-- 分配人员；关闭任务；关闭

### **拆表任务（App）**

#### 功能描述

面向安装员/抄表员移动端作业，提供拆表任务接收、现场拆表、止码抄录、拍照留痕及旧表归集登记能力，支持外勤执行拆表任务管理下发的作业指令，实现拆表数据实时回传并触发旧表退库流转。

#### 菜单权限

表务营业办/供水站职员

#### 数据权限

表务营业办/供水站职员：仅可查看及操作执行人为本人的拆表任务。

#### 核心逻辑

App 提交驱动任务完结、水表状态变更及退库衔接。

#### 功能需求

##### **一级页面：拆表任务列表（App）**

#整体布局

-- 任务卡片列表；下拉刷新、上拉加载

#页面标题

-- 标题文案：拆表任务

#查询条件

-- 任务状态：全部 / 待执行 / 执行中 / 已完成

#信息展示

-- 卡片：任务编号、用户名称、水表表号、拆表原因、计划完成日期、任务状态

#交互说明

-- 仅执行人为本人的任务；点击进入「二级页面：拆表任务详情（App）」

##### **二级页面：拆表任务详情（App）**

#页面标题

-- 标题文案：任务详情

#信息展示

-- 用户、水表、拆表原因、任务说明只读

#底部按钮

-- 开始拆表：进入「三级页面：现场拆表填报（App）」

##### **三级页面：现场拆表填报（App）**

#信息展示

-- 水表表号：只读，支持扫码复核

-- 拆表止码：必填，数值

-- 拆表原因确认：只读

-- 旧表归集登记：必填，下拉（已归集营业办/供水站、待归集）

-- 现场照片：必填，至少 1 张

-- GPS 定位：自动采集

-- 备注：选填

#底部按钮

-- 暂存；提交

#交互说明

-- 提交后任务「已完成」，水表状态更新，触发退库及营销状态同步

-- 支持离线暂存

---

## 详细设计（研发）

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

### 仪陇表务-功能设计-18-拆表管理-V1.0

# 仪陇表务 — 功能设计 18 拆表管理 V1.0

> 需求来源：`../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-18-*.md`  
> 数据模型：见 [数据库设计-V1.0.md](../数据库设计-V1.0.md)  
> 接口约定：见本文 **§接口设计（研发）**、[仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)、[00-总体框架设计-V1.0.md](../../design/00-总体框架设计-V1.0.md)

## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 18 |
| 模块名称 | 拆表管理 |
| 后端包（建议） | `com.tofly.wm.manage.remove` |
| 业务模式 | 申请工单+任务 |
| 工单 | REMOVE_APPLY |

## 2. 功能范围

- 拆表申请
- 拆表任务
- App 拆表

## 3. 数据模型

### 3.1 涉及表

- `wssmet_removeapply_w`
- `wssmet_removetask_w`
- `wssmet_removerec_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. 核心业务规则

- EVIDENCE_FILES 附件
- 营销销户同步

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

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | `/removeApply/` | 见 PRD 界面 |
| — | `/removeTask/` | 见 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/remove`；各接口 **出参** 须为具体泛型（见下文，**禁止** `T`/`Vo` 占位）；公共约定见 [仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-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<PageInfo<RemoveApplyVo>>

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

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<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） | 审批状态 |
#### 拆表申请-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询拆表申请 |
| 请求地址 | `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<List<RemoveApplyVo>>

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

**data（List<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） | 审批状态 |
#### 拆表申请-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询拆表申请详情 |
| 请求地址 | `GET /api/wm/manage/remove/removeApply/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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） | 审批状态 |

**出参**

- ResultResponse<Long>

**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） | 审批状态 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 拆表申请-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除拆表申请（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/remove/removeApply/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**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<PageInfo<RemoveTaskVo>>

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

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<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） | 旧水表归集状态 |
#### 拆表任务-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询拆表任务 |
| 请求地址 | `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<List<RemoveTaskVo>>

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

**data（List<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） | 旧水表归集状态 |
#### 拆表任务-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询拆表任务详情 |
| 请求地址 | `GET /api/wm/manage/remove/removeTask/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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） | 旧水表归集状态 |

**出参**

- ResultResponse<Long>

**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） | 旧水表归集状态 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 拆表任务-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除拆表任务（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/remove/removeTask/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**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<PageInfo<RemoveRecordVo>>

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

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<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 | 备注 |
#### 拆表现场记录-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询拆表现场记录 |
| 请求地址 | `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<List<RemoveRecordVo>>

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

**data（List<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 | 备注 |
#### 拆表现场记录-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询拆表现场记录详情 |
| 请求地址 | `GET /api/wm/manage/remove/removeRecord/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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 | 备注 |

**出参**

- ResultResponse<Long>

**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 | 备注 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 拆表现场记录-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除拆表现场记录（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/remove/removeRecord/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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