Domů Procházet Nápověda
Přihlásit se
zenghaiyang
/
ylsw-bw
1
0
Rozštěpit 0
Soubory Úkoly 0 Pull Requesty 0 Wiki
Strom: 85a21dde45
Větve Značky
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-17-迁表管理-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-17-迁表管理-V1.0.md 44 KB
Historie Surový

源文件：仪陇表务管理系统-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、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；实现时遵循 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；实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc（`wssmet_` 表名），不参照存量业务表与接口。*

接口设计（研发）

统一前缀：/api/wm/manage/relocate；各接口 出参 须为具体泛型（见下文，禁止 T/Vo 占位）；公共约定见 仪陇表务-公共接口说明-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>

    • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

    data（PageInfo）字段

    RelocateApplyVo 字段

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

      • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

      data（List）元素字段

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

        • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §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

          • 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

            • data 无业务字段（null）。

            迁表申请-删除

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

            入参（Query: ids）

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

            出参

            • ResultResponse

              • 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>

                • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

                data（PageInfo）字段

                RelocateTaskVo 字段

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

                  • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

                  data（List）元素字段

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

                    • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §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

                      • 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

                        • data 无业务字段（null）。

                        迁表任务-删除

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

                        入参（Query: ids）

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

                        出参

                        • ResultResponse

                          • 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>

                            • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

                            data（PageInfo）字段

                            RelocateRecordVo 字段

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

                              • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §1.3。

                              data（List）元素字段

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

                                • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §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

                                  • 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

                                    • data 无业务字段（null）。

                                    迁表现场记录-删除

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

                                    入参（Query: ids）

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

                                    出参

                                    • ResultResponse

                                      • data 无业务字段（null）。