仪陇表务管理系统-PRD-04-功能需求说明-18-拆表管理-V1.0.md 33 KB

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

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

文档版本:V1.0

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

模块序号:18

模块名称:拆表管理

拆表管理

本模块覆盖用户销户、报停、拆迁等需拆除水表的业务,对应《PRD-01》拆表管理能力。含 Web 菜单:拆表申请、拆表任务管理;App 菜单:拆表任务。审批通过后驱动任务派单,现场拆表完成后衔接旧表退库与营销销户状态同步。

拆表申请

功能描述

发起用户拆表(含销户拆表)申请并提交审批工单,提供拆表原因及用户信息填报能力,审批通过后驱动拆表任务管理派单,实现拆表申请与工单审批留痕。

菜单权限

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

数据权限

表务营业办/供水站职员:可见、可操作本机构范围内拆表申请发起;「历史记录」Tab 仅展示本人发起的申请工单。

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

表务总公司管理人员、表务水表管理中心:可见全公司拆表申请(只读)。

表务系统管理员:可见、可操作全公司拆表申请数据。

核心逻辑

以拆表申请工单为业务主体;审核通过后自动生成拆表任务,不在本菜单办理现场拆表。

业务流程

流程概要

表务营业办/供水站职员发起 → 营业办/供水站管理人员一级审核 → 分公司管理人员二级审核 → 系统自动生成拆表任务并派单 → 安装员/抄表员 App 现场拆表 → 旧表归集并触发退库流转;管理人员亦可在「拆表任务管理」直接派单。

环节说明表

序号 环节名称 环节类型 责任岗位 须填写 / 处理内容 审核结果选项 通过后流向 驳回 / 其他结果流向 抄送
1 拆表申请发起 发起 表务营业办/供水站职员 填报拆表原因、用户信息及水表信息(见「一级页面:拆表申请-tab-工单发起」) 提交 拆表一级审核
2 拆表一级审核 审核 表务营业办/供水站管理人员 核对拆表原因、用户销户/报停依据;填写审核意见 通过;驳回 拆表二级审核 退回拆表申请发起
3 拆表二级审核 审核 表务分公司管理人员 复核拆表合规性及资产处置安排;填写审核意见 通过;驳回 流程通过(系统自动) 退回拆表一级审核
4 自动生成拆表任务 系统自动 系统 终审通过后自动生成拆表任务,初始状态「待执行」,同步 App 待办 待 App 现场执行
5 现场拆表作业 执行 表务营业办/供水站职员(安装员/抄表员) App 现场拆表、止码抄录、拍照留痕、旧表归集登记 提交完成 流程完结(待退库)

审核通过后数据影响

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

  • 自动创建拆表任务及任务明细,任务状态为「待执行」。

  • App 提交完成后更新水表状态为「已拆表/待退库」,同步营销销户/报停状态(按拆表原因)。

  • 驱动「退库管理」旧表入库登记衔接;追加生命周期「拆表」记录。

关联界面逻辑闭环

  • 发起侧:「历史记录」Tab 展示工单及关联任务、退库状态。

  • 任务侧:「拆表任务管理」展示关联申请及 App 回传止码、旧表归集状态。

  • 退库侧:拆表完成后可在「入库管理(分公司仓)」办理旧表入库,状态与任务「旧表归集」一致。

  • 营销侧:销户类拆表完成后营销用户状态与任务详情销户同步状态一致。

审核界面说明

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

  • 本业务差异:只读展示用户信息、水表表号、拆表原因及销户/报停依据附件。

功能需求

一级页面:拆表申请-tab-工单发起

#整体布局

-- Tab 列表:工单发起(默认)、历史记录

-- 本 Tab:拆表申请表单 + 底部「提交」「重置」

#信息展示

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

-- 用户编号:必填,支持选择用户

-- 用户名称:只读

-- 拆表原因:必填,下拉(销户拆表、报停拆表、拆迁拆表、其他)

-- 水表表号:必填,支持扫码;须为「在用」状态

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

-- 备注:选填,多行文本

#底部按钮

-- 提交;重置

#交互说明

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

一级页面:拆表申请-tab-历史记录

#整体布局

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

#查询条件

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

#数据列表

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

-- 行内操作:详情

#交互说明

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

弹窗:拆表申请工单详情

#弹窗类型

-- 抽屉弹窗(右侧滑出);遮罩:有

#整体布局

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

#信息展示

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

#底部按钮

-- 关闭;去处理(审批中且当前节点处理人可见)

#交互说明

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

拆表任务管理

功能描述

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

菜单权限

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

数据权限

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

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

表务总公司管理人员、表务水表管理中心:可见全公司拆表任务(只读)。

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

核心逻辑

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

功能需求

一级页面:拆表任务管理

#整体布局

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

#查询条件

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

#数据列表

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

-- 行内操作:详情;分配人员;关闭

#交互说明

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

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

弹窗:新建/编辑拆表任务

#弹窗类型

-- 居中模态弹窗;遮罩:有

#信息展示

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

#底部按钮

-- 保存并下发;取消

弹窗:拆表任务详情

#弹窗类型

-- 抽屉弹窗(右侧);遮罩:有

#信息展示

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

#底部按钮

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

拆表任务(App)

功能描述

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

菜单权限

表务营业办/供水站职员

数据权限

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

核心逻辑

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

功能需求

一级页面:拆表任务列表(App)

#整体布局

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

#页面标题

-- 标题文案:拆表任务

#查询条件

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

#信息展示

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

#交互说明

-- 仅执行人为本人的任务;点击进入「二级页面:拆表任务详情(App)」

二级页面:拆表任务详情(App)

#页面标题

-- 标题文案:任务详情

#信息展示

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

#底部按钮

-- 开始拆表:进入「三级页面:现场拆表填报(App)」

三级页面:现场拆表填报(App)

#信息展示

-- 水表表号:只读,支持扫码复核

-- 拆表止码:必填,数值

-- 拆表原因确认:只读

-- 旧表归集登记:必填,下拉(已归集营业办/供水站、待归集)

-- 现场照片:必填,至少 1 张

-- GPS 定位:自动采集

-- 备注:选填

#底部按钮

-- 暂存;提交

#交互说明

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

-- 支持离线暂存


详细设计(研发)

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

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

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

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

1. 模块概述

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

2. 功能范围

  • 拆表申请
  • 拆表任务
  • App 拆表

3. 数据模型

3.1 涉及表

  • wssmet_removeapply_w
  • wssmet_removetask_w
  • wssmet_removerec_w

3.2 实体约定

  • 所有实体 extends BaseEntity;逻辑删除 Boolean deleteddeleted
  • 字典 DictEntry + @DictDirectory(MeterConstant.*) ↔ 库列 VARCHAR2;组织/用户 OrganizationEntry/UserNameEntry ↔ 库列 NUMBER(19);附件 FileEntryList/FileEntry@TableField(exist = false)无库列
  • 申请类主表含 process_instance_id / work_order_code / approve_status;工单反查 (无本地表,见 workflow).TABLE_NAME + TABLE_ID

4. 业务流程

销户/报停等→拆表→止码→旧表归集→退库。

5. 核心业务规则

  • EVIDENCE_FILES 附件
  • 营销销户同步

6. 接口设计(概要)

方法 路径(示例前缀) 说明
/removeApply/ 见 PRD 界面
/removeTask/ 见 PRD 界面
  • 标准 CRUD 另含:GET /pageGET /listPOST /updateDELETE /{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.mddatabase-design.mdc(`wssmet_` 表名),不参照存量业务表与接口。*


接口设计(研发)

统一前缀:/api/wm/manage/remove;各接口 出参 须为具体泛型(见下文,禁止 T/Vo 占位);公共约定见 仪陇表务-公共接口说明-V1.0.md

拆表申请-分页查询

内容
接口说明 分页查询拆表申请
请求地址 GET /api/wm/manage/remove/removeApply/page
请求类型 GET

入参(Query(PageQuery))

字段 类型 说明
applyCode String 申请编号
removeReasonCode String(字典 code) 拆表原因编号
userNo String 用户
userName String 用户
meterCode String 水表表号
returnStatusCode String(枚举 code) 退回状态
remark String 备注
workOrderCode String 工单编号(展示/台账查询)
approveStatus String(枚举 code) 审批状态

出参

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

    data(PageInfo)字段

    RemoveApplyVo 字段

    字段 类型 说明
    pageNum Integer 当前页码
    pageSize Integer 每页条数
    total Long 总记录数
    pages Integer 总页数
    list List 当前页数据列表
    字段 类型 说明
    id String 主键
    applyCode String 申请
    removeReasonCode String(字典 code) 拆表原因
    userNo String 用户
    userName String 用户
    meterId Long 水表ID,关联wssmet_meter_w表的id字段
    meterCode String 水表表号
    taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
    returnStatusCode String(枚举 code) 退回状态
    remark String 备注
    processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
    workOrderCode String 工单编号(展示/台账查询)
    approveStatus String(枚举 code) 审批状态

    拆表申请-列表查询

    内容
    接口说明 列表查询拆表申请
    请求地址 GET /api/wm/manage/remove/removeApply/list
    请求类型 GET

    入参(Query)

    字段 类型 说明
    applyCode String 申请编号
    removeReasonCode String(字典 code) 拆表原因编号
    userNo String 用户
    userName String 用户
    meterCode String 水表表号
    returnStatusCode String(枚举 code) 退回状态
    remark String 备注
    workOrderCode String 工单编号(展示/台账查询)
    approveStatus String(枚举 code) 审批状态

    出参

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

      data(List)元素字段

      RemoveApplyVo 字段

      字段 类型 说明
      id String 主键
      applyCode String 申请
      removeReasonCode String(字典 code) 拆表原因
      userNo String 用户
      userName String 用户
      meterId Long 水表ID,关联wssmet_meter_w表的id字段
      meterCode String 水表表号
      taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
      returnStatusCode String(枚举 code) 退回状态
      remark String 备注
      processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
      workOrderCode String 工单编号(展示/台账查询)
      approveStatus String(枚举 code) 审批状态

      拆表申请-详情

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

      入参(Path: id)

      字段 类型 说明
      id String 主键

      出参

      • ResultResponse(含明细 list 若适用)
      • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

        data(RemoveApplyVo)字段

        RemoveApplyVo 字段

        字段 类型 说明
        id String 主键
        applyCode String 申请
        removeReasonCode String(字典 code) 拆表原因
        userNo String 用户
        userName String 用户
        meterId Long 水表ID,关联wssmet_meter_w表的id字段
        meterCode String 水表表号
        taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
        returnStatusCode String(枚举 code) 退回状态
        remark String 备注
        processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
        workOrderCode String 工单编号(展示/台账查询)
        approveStatus String(枚举 code) 审批状态

        拆表申请-新增

        内容
        接口说明 新增拆表申请;提交时同步发起 workflow,回写 process_instance_id / work_order_code / approve_status
        请求地址 POST /api/wm/manage/remove/removeApply/
        请求类型 POST

        入参(Body: Dto)

        字段 类型 说明
        applyCode String 申请编号
        removeReasonCode String(字典 code) 拆表原因编号
        userNo String 用户
        userName String 用户
        meterId Long 水表ID,关联wssmet_meter_w表的id字段
        meterCode String 水表表号
        taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
        returnStatusCode String(枚举 code) 退回状态
        remark String 备注
        processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
        workOrderCode String 工单编号(展示/台账查询)
        approveStatus String(枚举 code) 审批状态

        出参

        • ResultResponse
        • data 字段

          字段 类型 说明
          id Long 新增记录主键

          拆表申请-修改

          内容
          接口说明 修改拆表申请
          请求地址 POST /api/wm/manage/remove/removeApply/update
          请求类型 POST

          入参(Body: Dto(含 id))

          字段 类型 说明
          applyCode String 申请编号
          removeReasonCode String(字典 code) 拆表原因编号
          userNo String 用户
          userName String 用户
          meterId Long 水表ID,关联wssmet_meter_w表的id字段
          meterCode String 水表表号
          taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
          returnStatusCode String(枚举 code) 退回状态
          remark String 备注
          processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
          workOrderCode String 工单编号(展示/台账查询)
          approveStatus String(枚举 code) 审批状态

          出参

          • ResultResponse
          • data 无业务字段(null)。

            拆表申请-删除

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

            入参(Query: ids)

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

            出参

            • ResultResponse
            • data 无业务字段(null)。

              拆表任务-分页查询

              内容
              接口说明 分页查询拆表任务
              请求地址 GET /api/wm/manage/remove/removeTask/page
              请求类型 GET

              入参(Query(PageQuery))

              字段 类型 说明
              taskCode String 任务编号
              taskSourceCode String(枚举 code) 任务来源
              userNo String 用户
              meterCode String 水表表号
              removeReasonCode String(字典 code) 拆表原因编号
              planFinishDate Date 计划完成日期
              taskStatusCode String(枚举 code) 任务状态
              finalReading String 最终读数
              oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

              出参

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

                data(PageInfo)字段

                RemoveTaskVo 字段

                字段 类型 说明
                pageNum Integer 当前页码
                pageSize Integer 每页条数
                total Long 总记录数
                pages Integer 总页数
                list List 当前页数据列表
                字段 类型 说明
                id String 主键
                taskCode String 任务
                taskSourceCode String(枚举 code) 任务来源
                applyId Long 拆表申请ID,关联wssmet_removeapply_w表的id字段
                userNo String 用户
                meterCode String 水表表号
                removeReasonCode String(字典 code) 拆表原因
                executorId Long 执行人ID,关联tf_user表的id字段
                planFinishDate Date 计划完成日期
                taskStatusCode String(枚举 code) 任务状态
                finalReading String 最终读数
                oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

                拆表任务-列表查询

                内容
                接口说明 列表查询拆表任务
                请求地址 GET /api/wm/manage/remove/removeTask/list
                请求类型 GET

                入参(Query)

                字段 类型 说明
                taskCode String 任务编号
                taskSourceCode String(枚举 code) 任务来源
                userNo String 用户
                meterCode String 水表表号
                removeReasonCode String(字典 code) 拆表原因编号
                planFinishDate Date 计划完成日期
                taskStatusCode String(枚举 code) 任务状态
                finalReading String 最终读数
                oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

                出参

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

                  data(List)元素字段

                  RemoveTaskVo 字段

                  字段 类型 说明
                  id String 主键
                  taskCode String 任务
                  taskSourceCode String(枚举 code) 任务来源
                  applyId Long 拆表申请ID,关联wssmet_removeapply_w表的id字段
                  userNo String 用户
                  meterCode String 水表表号
                  removeReasonCode String(字典 code) 拆表原因
                  executorId Long 执行人ID,关联tf_user表的id字段
                  planFinishDate Date 计划完成日期
                  taskStatusCode String(枚举 code) 任务状态
                  finalReading String 最终读数
                  oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

                  拆表任务-详情

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

                  入参(Path: id)

                  字段 类型 说明
                  id String 主键

                  出参

                  • ResultResponse(含明细 list 若适用)
                  • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                    data(RemoveTaskVo)字段

                    RemoveTaskVo 字段

                    字段 类型 说明
                    id String 主键
                    taskCode String 任务
                    taskSourceCode String(枚举 code) 任务来源
                    applyId Long 拆表申请ID,关联wssmet_removeapply_w表的id字段
                    userNo String 用户
                    meterCode String 水表表号
                    removeReasonCode String(字典 code) 拆表原因
                    executorId Long 执行人ID,关联tf_user表的id字段
                    planFinishDate Date 计划完成日期
                    taskStatusCode String(枚举 code) 任务状态
                    finalReading String 最终读数
                    oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

                    拆表任务-新增

                    内容
                    接口说明 新增拆表任务
                    请求地址 POST /api/wm/manage/remove/removeTask/
                    请求类型 POST

                    入参(Body: Dto)

                    字段 类型 说明
                    taskCode String 任务编号
                    taskSourceCode String(枚举 code) 任务来源
                    applyId Long 拆表申请ID,关联wssmet_removeapply_w表的id字段
                    userNo String 用户
                    meterCode String 水表表号
                    removeReasonCode String(字典 code) 拆表原因编号
                    executorId Long 执行人ID,关联tf_user表的id字段
                    planFinishDate Date 计划完成日期
                    taskStatusCode String(枚举 code) 任务状态
                    finalReading String 最终读数
                    oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

                    出参

                    • ResultResponse
                    • data 字段

                      字段 类型 说明
                      id Long 新增记录主键

                      拆表任务-修改

                      内容
                      接口说明 修改拆表任务
                      请求地址 POST /api/wm/manage/remove/removeTask/update
                      请求类型 POST

                      入参(Body: Dto(含 id))

                      字段 类型 说明
                      taskCode String 任务编号
                      taskSourceCode String(枚举 code) 任务来源
                      applyId Long 拆表申请ID,关联wssmet_removeapply_w表的id字段
                      userNo String 用户
                      meterCode String 水表表号
                      removeReasonCode String(字典 code) 拆表原因编号
                      executorId Long 执行人ID,关联tf_user表的id字段
                      planFinishDate Date 计划完成日期
                      taskStatusCode String(枚举 code) 任务状态
                      finalReading String 最终读数
                      oldMeterCollectStatusCode String(枚举 code) 旧水表归集状态

                      出参

                      • ResultResponse
                      • data 无业务字段(null)。

                        拆表任务-删除

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

                        入参(Query: ids)

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

                        出参

                        • ResultResponse
                        • data 无业务字段(null)。

                          拆表现场记录-分页查询

                          内容
                          接口说明 分页查询拆表现场记录
                          请求地址 GET /api/wm/manage/remove/removeRecord/page
                          请求类型 GET

                          入参(Query(PageQuery))

                          字段 类型 说明
                          meterCode String 水表表号
                          finalReading String 最终读数
                          collectStatusCode String(枚举 code) 归集状态
                          gpsLat String GPS纬度
                          gpsLng String GPS经度
                          remark String 备注

                          出参

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

                            data(PageInfo)字段

                            RemoveRecordVo 字段

                            字段 类型 说明
                            pageNum Integer 当前页码
                            pageSize Integer 每页条数
                            total Long 总记录数
                            pages Integer 总页数
                            list List 当前页数据列表
                            字段 类型 说明
                            id String 主键
                            taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
                            meterCode String 水表表号
                            finalReading String 最终读数
                            collectStatusCode String(枚举 code) 归集状态
                            gpsLat String GPS纬度
                            gpsLng String GPS经度
                            remark String 备注

                            拆表现场记录-列表查询

                            内容
                            接口说明 列表查询拆表现场记录
                            请求地址 GET /api/wm/manage/remove/removeRecord/list
                            请求类型 GET

                            入参(Query)

                            字段 类型 说明
                            meterCode String 水表表号
                            finalReading String 最终读数
                            collectStatusCode String(枚举 code) 归集状态
                            gpsLat String GPS纬度
                            gpsLng String GPS经度
                            remark String 备注

                            出参

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

                              data(List)元素字段

                              RemoveRecordVo 字段

                              字段 类型 说明
                              id String 主键
                              taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
                              meterCode String 水表表号
                              finalReading String 最终读数
                              collectStatusCode String(枚举 code) 归集状态
                              gpsLat String GPS纬度
                              gpsLng String GPS经度
                              remark String 备注

                              拆表现场记录-详情

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

                              入参(Path: id)

                              字段 类型 说明
                              id String 主键

                              出参

                              • ResultResponse(含明细 list 若适用)
                              • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                data(RemoveRecordVo)字段

                                RemoveRecordVo 字段

                                字段 类型 说明
                                id String 主键
                                taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
                                meterCode String 水表表号
                                finalReading String 最终读数
                                collectStatusCode String(枚举 code) 归集状态
                                gpsLat String GPS纬度
                                gpsLng String GPS经度
                                remark String 备注

                                拆表现场记录-新增

                                内容
                                接口说明 新增拆表现场记录
                                请求地址 POST /api/wm/manage/remove/removeRecord/
                                请求类型 POST

                                入参(Body: Dto)

                                字段 类型 说明
                                taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
                                meterCode String 水表表号
                                finalReading String 最终读数
                                collectStatusCode String(枚举 code) 归集状态
                                gpsLat String GPS纬度
                                gpsLng String GPS经度
                                remark String 备注

                                出参

                                • ResultResponse
                                • data 字段

                                  字段 类型 说明
                                  id Long 新增记录主键

                                  拆表现场记录-修改

                                  内容
                                  接口说明 修改拆表现场记录
                                  请求地址 POST /api/wm/manage/remove/removeRecord/update
                                  请求类型 POST

                                  入参(Body: Dto(含 id))

                                  字段 类型 说明
                                  taskId Long 拆表任务ID,关联wssmet_removetask_w表的id字段
                                  meterCode String 水表表号
                                  finalReading String 最终读数
                                  collectStatusCode String(枚举 code) 归集状态
                                  gpsLat String GPS纬度
                                  gpsLng String GPS经度
                                  remark String 备注

                                  出参

                                  • ResultResponse
                                  • data 无业务字段(null)。

                                    拆表现场记录-删除

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

                                    入参(Query: ids)

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

                                    出参

                                    • ResultResponse
                                    • data 无业务字段(null)。