Domovská stránka Prehľadávať Pomoc
Prihlásiť sa
zenghaiyang
/
ylsw-bw
1
0
Fork 0
Súbory Issues 0 Pull requesty 0 Wiki
Strom: 85a21dde45
Branche Tagy
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-16-迁表管理-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-16-迁表管理-V1.0.md 35 KB
História Raw

源文件：仪陇表务管理系统-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、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_` 表名），不参照存量业务表与接口。*

接口设计（研发）

统一前缀：/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）。