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


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

文档版本：V1.0

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

模块序号：16

模块名称：迁表管理

## 迁表管理

本模块覆盖用户水表迁表申请、审批、任务派单及现场迁表作业，衔接报装改址与营销地址变更。含 Web「迁表申请」「迁表任务管理」及 App「迁表任务（App）」。

### **迁表申请**

#### 功能描述

发起用户水表迁表申请并提交审批。审批通过后驱动迁表任务管理派单。

#### 菜单权限

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

#### 数据权限

表务营业办/供水站职员：可见、可操作本营业办（或本供水站）迁表申请；「历史记录」Tab 仅展示本人发起的申请工单。

表务营业办/供水站管理人员、表务系统管理员：按组织范围配置可见与操作权限。

#### 核心逻辑

以迁表申请单及关联工单为业务主体，记录迁表原因、原表位、新表位、用户信息。

审批在本菜单发起、工单中心办理；现场作业在 App 完成。

#### 业务流程

流程概要

营业办/供水站人员发起 → 站长/主任初审 → 分公司分管领导复审 → 通过后驱动迁表任务管理派单；可与报装改址事件联动生成待派单任务。

环节说明表

| 序号 | 环节名称 | 环节类型 | 责任岗位 | 须填写 / 处理内容 | 审核结果选项 | 通过后流向 | 驳回 / 其他结果流向 | 抄送 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 迁表申请发起 | 发起 | 表务营业办/供水站职员 | 填报迁表申请及新旧表位信息（见「一级页面：迁表申请-tab-工单发起」） | 提交 | 迁表申请初审 | — | — |
| 2 | 迁表申请初审 | 审核 | 表务营业办/供水站管理人员 | 核查迁表原因、用户信息、新旧表位及地址变更合理性；填写审核意见 | 通过；驳回 | 迁表申请复审 | 退回迁表申请发起 | — |
| 3 | 迁表申请复审 | 审核 | 表务分公司领导班子 | 复核迁表业务合规性及现场实施条件；填写审核意见 | 通过；驳回 | 流程通过（系统自动处理） | 退回迁表申请初审 | — |
| 4 | 任务派单衔接 | 系统自动 | 系统 | 生成迁表待派单任务 | — | 流程完结 | — | — |

审核通过后数据影响

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

- 驱动「迁表任务管理」待派单；可接收报装改址事件自动生成任务。

- 现场完成后更新水表安装地址、表位信息并联动营销地址（接口集成范围见 01）。

关联界面逻辑闭环

- 发起侧：历史与详情展示工单、任务状态。

- 任务侧：迁表任务管理派单后 App 可接单作业。

- 台账侧：完成后水表档案安装地址、表位与现场一致；状态与台账菜单一致。

审核界面说明

- 标准界面：复用工单中心「二级页面：工单办理」。

- 本业务差异：审核环节只读展示新旧表位、地址变更说明及关联用户编号。

#### 功能需求

##### **一级页面：迁表申请-tab-工单发起**

#整体布局

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

-- 本 Tab 内容：申请表单区 + 业务明细表格（如有）；底部常驻「提交」「重置」

#信息展示

-- 申请基础信息区

-- 申请部门：只读，默认当前用户所属部门

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

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

-- 迁表原因：必填，下拉（管道改造、表位变更、地址调整、其他）

-- 用户编号、用户名称：必填

-- 原安装地址、原表位描述：必填

-- 新安装地址、新表位描述：必填

-- 备注：选填

-- 附件：选填，现场照片或依据文件

#底部按钮

-- 提交：校验必填项及明细规则后提交，进入审批流程

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

#交互说明

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

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

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

#整体布局

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

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

#查询条件

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

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

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

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

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

#数据列表

-- 表格标题：我的迁表申请

-- 表格字段：工单编号、申请单号、申请日期、迁、表、原、因、、、用、户、编、号、当前节点、工单状态、提交时间

-- 行内操作：详情

#交互说明

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

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

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

#弹窗类型

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

#整体布局

-- 宽度约 960px；全高；内部分 Tab：申请信息 / 表位变更信息

#弹窗标题

-- 迁表申请详情 - {工单编号}

#标题栏操作

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

#信息展示

-- Tab·申请信息：只读展示对应申请及业务信息

-- Tab·表位变更信息：只读展示对应申请及业务信息

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

#底部按钮

-- 关闭：关闭抽屉

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

-- 已通过时展示关联迁表任务编号、任务状态

#交互说明

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

### **迁表任务管理**

#### 功能描述

迁表作业统筹与派单，支持审批通过自动派单、直接派单及报装改址事件驱动。

#### 菜单权限

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

#### 数据权限

表务营业办/供水站管理人员：可见、可操作本营业办（或本供水站）迁表任务。

表务分公司管理人员：本分公司及下属范围。

表务系统管理员：全公司。

#### 核心逻辑

承接迁表申请通过后的派单；与 App 迁表任务、水表台账地址字段联动更新。

#### 功能需求

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

#整体布局

-- 查询区 + 任务列表；顶部「新建任务」「派单」

#查询条件

-- 任务编号、关联申请、用户编号、状态、执行人

#数据列表

-- 字段：任务编号、用户、原/新地址摘要、执行人、状态

-- 行内操作：详情、派单

#交互说明

-- 迁表申请通过或报装改址事件可生成待派单；派单推送 App

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

#弹窗类型

-- 抽屉

#信息展示

-- 任务、申请、新旧表位、执行记录、台账更新状态

#底部按钮

-- 派单、关闭

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

#### 功能描述

安装员现场执行迁表：旧表拆除、新位安装、表位与地址信息录入及数据回传。

#### 菜单权限

表务营业办/供水站职员（安装员）

#### 数据权限

表务营业办/供水站职员：仅本人被指派迁表任务。

#### 核心逻辑

对应迁表现场作业与台账自动更新；营销地址同步按接口集成配置执行。

#### 功能需求

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

#整体布局

-- 本人迁表任务列表

#页面标题

-- 迁表任务

#数据列表

-- 用户、地址、状态；操作：接单/作业

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

#整体布局

-- 信息 + 作业填报

#信息展示

-- 原表位、新表位、用户编号（只读）

-- 必填：作业时间、旧表拆除确认、新位安装确认、水表编号扫码复核

-- 新安装地址确认、拍照留痕

#底部按钮

-- 提交完成

#交互说明

-- 提交后更新任务为已完成，回写台账安装地址与表位

---

## 详细设计（研发）

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

### 仪陇表务-功能设计-16-迁表管理-V1.0

# 仪陇表务 — 功能设计 16 迁表管理 V1.0

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

## 1. 模块概述

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

## 2. 功能范围

- 迁表申请
- 迁表任务
- App 迁表

## 3. 数据模型

### 3.1 涉及表

- `wssmet_relocateapply_w`
- `wssmet_relocatetask_w`
- `wssmet_relocaterec_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. 核心业务规则

- 营销地址同步

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

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

#### 迁表申请-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询迁表申请 |
| 请求地址 | `GET /api/wm/manage/relocate/relocateApply/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterCode | String | 水表表号 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<PageInfo<RelocateApplyVo>>

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

**data（PageInfo）字段**

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

**`RelocateApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 迁表任务ID，关联wssmet_relocatetask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |
#### 迁表申请-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询迁表申请 |
| 请求地址 | `GET /api/wm/manage/relocate/relocateApply/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterCode | String | 水表表号 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<List<RelocateApplyVo>>

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

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

**`RelocateApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 迁表任务ID，关联wssmet_relocatetask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |
#### 迁表申请-详情

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

**入参（Path: id）**

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

**出参**

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

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

**data（RelocateApplyVo）字段**

**`RelocateApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 迁表任务ID，关联wssmet_relocatetask_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/relocate/relocateApply/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 迁表任务ID，关联wssmet_relocatetask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 迁表申请-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改迁表申请 |
| 请求地址 | `POST /api/wm/manage/relocate/relocateApply/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| userNo | String | 用户 |
| userName | String | 用户 |
| oldAddress | String | 旧地址 |
| oldPosition | String | 旧表位 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| taskId | Long | 迁表任务ID，关联wssmet_relocatetask_w表的id字段 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Void>

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

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 迁表任务-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询迁表任务 |
| 请求地址 | `GET /api/wm/manage/relocate/relocateTask/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<PageInfo<RelocateTaskVo>>

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

**data（PageInfo）字段**

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

**`RelocateTaskVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |
#### 迁表任务-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询迁表任务 |
| 请求地址 | `GET /api/wm/manage/relocate/relocateTask/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<List<RelocateTaskVo>>

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

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

**`RelocateTaskVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |
#### 迁表任务-详情

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

**入参（Path: id）**

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

**出参**

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

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

**data（RelocateTaskVo）字段**

**`RelocateTaskVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

#### 迁表任务-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增迁表任务 |
| 请求地址 | `POST /api/wm/manage/relocate/relocateTask/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 迁表任务-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改迁表任务 |
| 请求地址 | `POST /api/wm/manage/relocate/relocateTask/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<Void>

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

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 迁表现场记录-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询迁表现场记录 |
| 请求地址 | `GET /api/wm/manage/relocate/relocateRecord/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<PageInfo<RelocateRecordVo>>

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

**data（PageInfo）字段**

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

**`RelocateRecordVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |
#### 迁表现场记录-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询迁表现场记录 |
| 请求地址 | `GET /api/wm/manage/relocate/relocateRecord/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<List<RelocateRecordVo>>

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

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

**`RelocateRecordVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |
#### 迁表现场记录-详情

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

**入参（Path: id）**

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

**出参**

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

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

**data（RelocateRecordVo）字段**

**`RelocateRecordVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| taskCode | String | 任务 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

#### 迁表现场记录-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增迁表现场记录 |
| 请求地址 | `POST /api/wm/manage/relocate/relocateRecord/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 迁表现场记录-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改迁表现场记录 |
| 请求地址 | `POST /api/wm/manage/relocate/relocateRecord/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| taskCode | String | 任务编号 |
| taskSourceCode | String（枚举 code） | 任务来源 |
| applyId | Long | 迁表申请ID，关联wssmet_relocateapply_w表的id字段 |
| userNo | String | 用户 |
| userName | String | 用户 |
| meterCode | String | 水表表号 |
| relocateReasonCode | String（字典 code） | 迁表原因编号 |
| newAddress | String | 新地址 |
| newPosition | String | 新表位 |
| orgId | Long | 组织ID，关联tf_org表的id字段 |
| executorId | Long | 执行人ID，关联tf_user表的id字段 |
| planFinishDate | Date | 计划完成日期 |
| actualFinishDate | Date | 实际完成日期 |
| taskStatusCode | String（枚举 code） | 任务状态 |
| taskDesc | String | 任务 |

**出参**

- ResultResponse<Void>

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

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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