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


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

文档版本：V1.0

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

模块序号：17

模块名称：迁表管理

## 迁表管理

本模块覆盖用户因管道改造、表位变更、地址调整等原因迁移水表安装位置的全流程，对应《PRD-01》迁表管理能力。含 Web 菜单：迁表申请、迁表任务管理；App 菜单：迁表任务。审批通过后驱动任务派单，现场作业联动营销地址变更。

### **迁表申请**

#### 功能描述

发起用户水表迁表申请并提交审批工单，提供迁表原因、新旧表位及用户信息填报能力，审批通过后驱动迁表任务管理派单，实现迁表申请与工单审批留痕。

#### 菜单权限

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

#### 数据权限

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

表务营业办/供水站管理人员、表务分公司管理人员：可见、可操作本部门及管辖部门范围内迁表申请业务数据。

表务总公司管理人员、表务水表管理中心：可见全公司范围内迁表申请工单（只读，不可发起、不可办理）。

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

#### 核心逻辑

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

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

审核通过后由系统自动生成「迁表任务管理」任务记录，不在本菜单办理现场作业。

#### 业务流程

流程概要

表务营业办/供水站职员发起 → 营业办/供水站管理人员一级审核 → 分公司管理人员二级审核 → 系统自动生成迁表任务并派单 → 安装员 App 现场作业 → 台账与营销地址更新；管理人员亦可在「迁表任务管理」直接派单（不经申请审批）。

环节说明表

| 序号 | 环节名称 | 环节类型 | 责任岗位 | 须填写 / 处理内容 | 审核结果选项 | 通过后流向 | 驳回 / 其他结果流向 | 抄送 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 迁表申请发起 | 发起 | 表务营业办/供水站职员 | 填报迁表原因、用户信息、原表位/新表位及安装地址（见「一级页面：迁表申请-tab-工单发起」） | 提交 | 迁表一级审核 | — | — |
| 2 | 迁表一级审核 | 审核 | 表务营业办/供水站管理人员 | 核对迁表必要性、用户信息及新旧表位合理性；填写审核意见 | 通过；驳回 | 迁表二级审核 | 退回迁表申请发起 | — |
| 3 | 迁表二级审核 | 审核 | 表务分公司管理人员 | 复核迁表合规性及跨系统影响；填写审核意见 | 通过；驳回 | 流程通过（系统自动） | 退回迁表一级审核 | — |
| 4 | 自动生成迁表任务 | 系统自动 | 系统 | 终审通过后自动生成迁表任务主记录及明细，初始状态「待执行」，同步 App 待办 | — | 待 App 现场执行 | — | — |
| 5 | 现场迁表作业 | 执行 | 表务营业办/供水站职员（安装员） | App 接收任务，现场拆除旧位、新位安装、扫码识表、拍照留痕、提交结果 | 提交完成 | 流程完结 | — | — |

审核通过后数据影响

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

- 自动创建迁表任务及任务水表明细，任务状态为「待执行」。

- App 提交完成后更新水表安装地址、表位信息，同步营销系统用户档案地址变更。

- 追加水表生命周期「迁表」阶段记录；水表保持「在用」状态。

关联界面逻辑闭环

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

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

- 任务侧：「迁表任务管理」列表与详情展示关联申请单；审批通过或报装改址事件驱动后自动出现任务记录。

- App 侧：任务完成后 Web 任务状态回写「已完成」，与任务管理列表、申请详情任务状态一致。

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

审核界面说明

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

- 本业务差异：各审核环节只读展示用户信息、原表位、新表位及迁表原因；无额外填报区块。

#### 功能需求

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

#整体布局

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

-- 本 Tab 内容：迁表申请表单区；底部常驻「提交」「重置」

#信息展示

-- 申请基础信息区

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

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

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

-- 用户编号：必填，文本，支持从营销档案选择

-- 用户名称：只读，选择用户后带出

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

-- 原安装地址：只读，选择用户后带出

-- 原表位描述：选填，文本

-- 新安装地址：必填，文本

-- 新表位描述：必填，文本

-- 水表表号：必填，文本，支持扫码；须校验水表状态为「在用」且归属该用户

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

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

#底部按钮

-- 提交：校验必填项后提交，对应业务流程环节 1

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

#交互说明

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

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

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

#整体布局

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

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

#查询条件

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

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

-- 用户编号：文本，支持模糊搜索

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

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

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

#数据列表

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

-- 表格字段：工单编号、申请单号、用户编号、用户名称、迁表原因、工单状态、当前节点、关联任务编号、任务状态、提交时间

-- 行内操作：详情

#交互说明

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

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

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

#弹窗类型

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

#整体布局

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

#弹窗标题

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

#标题栏操作

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

-- 全屏：无

#信息展示

-- Tab·申请信息：申请单号、工单编号、用户编号、用户名称、迁表原因、原/新安装地址、原/新表位、水表表号、备注、工单状态、当前节点、关联任务编号、任务状态

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

#底部按钮

-- 关闭：关闭抽屉

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

#交互说明

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

-- 已通过且已生成任务时，任务状态与「迁表任务管理」菜单一致

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

#### 功能描述

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

#### 菜单权限

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

#### 数据权限

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

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

表务总公司管理人员、表务水表管理中心：可见全公司范围内迁表任务数据（只读）。

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

#### 核心逻辑

以迁表任务为查询主体，关联展示任务水表及现场回传信息。

任务来源包括：迁表申请审批通过自动生成、管理人员直接派单、报装改址事件驱动。

现场作业在 App「迁表任务」办理，完成后回写任务状态及水表地址。

#### 功能需求

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

#整体布局

-- 布局骨架：上下结构；上区查询条件，下区任务列表；上区联动下区

-- 页面右上角常驻「新建任务」「直接派单」按钮（管理人员可见）

#查询条件

-- 所属分公司：下拉单选，层级联动；总公司角色可选全部

-- 营业办/供水站：下拉单选，依赖所属分公司

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

-- 任务状态：下拉多选（待执行、执行中、已完成、已关闭）

-- 用户编号：文本，支持模糊搜索

-- 执行人：下拉单选，支持模糊搜索

-- 计划完成日期：日期范围选择

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

#数据列表

-- 表格标题：迁表任务列表

-- 表格字段：任务编号、用户编号、用户名称、水表表号、迁表原因、所属营业办/供水站、执行人、任务状态、关联申请单号、计划完成日期、创建人、创建时间

-- 行内操作：详情；编辑（待执行，管理人员）；分配人员（待执行/执行中）；关闭（待执行/执行中，需填原因）

#交互说明

-- 审批通过的迁表申请自动生成任务记录，来源标记「申请驱动」

-- 「直接派单」打开「弹窗：新建/编辑迁表任务」，不经过申请审批

-- 报装改址事件可驱动自动创建任务（来源标记「报装驱动」）

-- 点击任务编号或「详情」打开「弹窗：迁表任务详情」

-- 仅展示所属机构属于当前用户所属部门及管辖部门的任务

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

#弹窗类型

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

#整体布局

-- 宽度约 800px；任务基本信息表单区

#信息展示

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

-- 用户名称：只读

-- 水表表号：必填，支持扫码

-- 迁表原因：必填，下拉单选

-- 新安装地址：必填，文本

-- 新表位描述：必填，文本

-- 所属营业办/供水站：必填，下拉单选

-- 执行人：必填，下拉单选（本机构安装员）

-- 计划完成日期：必填，日期选择

-- 任务说明：选填，多行文本

#底部按钮

-- 保存并下发：校验后状态「待执行」，同步 App；取消：关闭弹窗

#交互说明

-- 保存成功后刷新任务列表；直接派单不生成审批工单

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

#弹窗类型

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

#整体布局

-- 宽度约 960px；任务摘要 + Tab：任务信息 / 现场回传 / 操作日志

#信息展示

-- 任务编号、用户编号、用户名称、水表表号、迁表原因、原/新地址、执行人、任务状态、关联申请单号、计划/实际完成日期

-- 现场回传 Tab：App 提交的照片、GPS、完成时间、操作人备注（只读）

#底部按钮

-- 分配人员：待执行/执行中，管理人员可见

-- 关闭任务：待执行/执行中，需填关闭原因

-- 关闭：关闭抽屉

#交互说明

-- App 提交完成后任务状态自动更新为「已完成」

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

#### 功能描述

面向安装员移动端作业，提供迁表任务接收、现场旧表拆除与新位安装、表位与地址信息录入、扫码识表及拍照留痕能力，支持外勤执行迁表任务管理下发的作业指令，实现迁表现场数据实时回传与台账自动更新。

#### 菜单权限

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

#### 数据权限

表务营业办/供水站职员：仅可查看及操作执行人为本人的迁表任务及现场填报数据。

#### 核心逻辑

以迁表任务为业务主体；App 提交驱动任务完结及水表地址、生命周期更新。

#### 功能需求

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

#整体布局

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

#页面标题

-- 标题文案：迁表任务；返回：App 首页

#查询条件

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

#信息展示

-- 任务卡片字段：任务编号、用户名称、水表表号、新安装地址、计划完成日期、任务状态

#交互说明

-- 仅展示执行人为当前登录用户的任务

-- 点击卡片进入「二级页面：迁表任务详情（App）」

-- 待执行任务卡片展示「开始作业」快捷入口

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

#整体布局

-- 顶部导航 + 中部信息区 + 底部操作区

#页面标题

-- 标题文案：任务详情；返回：迁表任务列表

#信息展示

-- 用户编号、用户名称、水表表号、迁表原因、原/新安装地址、原/新表位、计划完成日期、任务说明

#底部按钮

-- 开始迁表：任务状态为「待执行」时显示，进入「三级页面：现场迁表填报（App）」

-- 继续作业：任务状态为「执行中」时显示

#交互说明

-- 下拉刷新任务状态

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

#整体布局

-- 表单填报区 + 拍照区 + 底部提交

#页面标题

-- 标题文案：现场迁表；返回：任务详情

#信息展示

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

-- 现场读数：必填，数值

-- 新表位确认：必填，文本

-- 新安装地址确认：必填，文本

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

-- GPS 定位：自动采集，可选手动修正

-- 备注：选填

#底部按钮

-- 暂存：离线可暂存；提交：校验后提交，任务状态「已完成」

#交互说明

-- 提交成功后回写 Web 任务状态及水表地址，触发营销地址同步

-- 支持离线暂存，联网后自动提交

---

## 详细设计（研发）

> 以下内容合并自 `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_*` 表名），**不参照**存量业务表与接口。*

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


## 1. 模块概述

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

## 2. 功能范围

- 迁表申请(含水表表号)
- 现场读数
- GPS/多图

## 3. 数据模型

### 3.1 涉及表

- `wssmet_relocateapply_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. 业务流程

详版强化 METER_ID、READING_VALUE、照片≥1。

## 5. 核心业务规则

- 现场照片 `FileEntryList` 最多9张，`@TableField(exist = false)`，无库列

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

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | — | 同16 |

- 标准 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）。