Home Explore Help
Sign In
zenghaiyang
/
ylsw-bw
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: 85a21dde45
Branches Tags
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-20-周期检查-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-20-周期检查-V1.0.md 33 KB
History Raw

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

仪陇表务管理系统 产品需求说明书 04-功能需求说明 周期检查

文档版本：V1.0

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

模块序号：20

模块名称：周期检查

周期检查

本模块覆盖在用水表现场抽检的计划配置、任务管理与移动端执行，对应《PRD-01》周期检查能力。含 Web 菜单：检查周期配置、检查任务管理；App 菜单：检查任务执行。检查仅追加检查记录，不改变水表「在用」状态，与到期检定相互独立。

检查周期配置

功能描述

配置周期检查全局规则，提供检查项模板、抽检比例、计划周期及提醒规则维护能力，支持智慧水务中心统一管理检查参数，实现检查规则标准化与全局生效。

菜单权限

表务系统管理员；表务水表管理中心；表务总公司管理人员

数据权限

表务系统管理员、表务水表管理中心、表务总公司管理人员：可见、可操作全公司范围内检查周期配置数据。

其他角色：不可见本菜单。

核心逻辑

以检查周期配置为管理主体；变更即时生效，影响后续新建任务，不影响已下发任务。

功能需求

一级页面：检查周期配置

#整体布局

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

-- 页面为 Web 端配置管理页面，面向智慧水务中心维护全局规则

-- 页面右上角常驻「新增配置」按钮

#查询条件

-- 配置名称：模糊搜索

-- 状态：下拉单选（启用、停用）

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

#数据列表

-- 表格标题：周期检查配置列表

-- 表格字段：序号、配置名称、默认抽检比例(%)、计划周期(月)、任务时限(天)、状态、更新时间

-- 行内操作：编辑、启用/停用、删除（无关联进行中任务时可删）

#交互说明

-- 点击「新增配置」或行内「编辑」，打开「弹窗：编辑检查周期配置」

-- 点击配置名称或「详情」，打开「弹窗：配置详情」

-- 配置变更立即生效，影响后续新建检查任务，不影响已下发任务

弹窗：编辑检查周期配置

#弹窗类型

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

#整体布局

-- 宽度约 800px；表单分区：基础参数区、检查项模板区、提醒规则区

#弹窗标题

-- 新增时：新增检查周期配置；编辑时：编辑检查周期配置 - {配置名称}

#标题栏操作

-- 关闭（×）：有未保存时二次确认；全屏：无

#信息展示

-- 配置名称：必填，文本，最多 100 字

-- 默认抽检比例(%)：必填，数值

-- 计划周期(月)：必填，正整数

-- 任务时限(天)：必填，正整数

-- 检查项模板：必填，多选检查项（运行状态、表体状态、铅封状态、漏水、违规用水、现场读数等）

-- 提前提醒规则：选填，任务截止前 N 天提醒

-- 状态：启用 / 停用

#底部按钮

-- 保存；取消

#交互说明

-- 保存成功后关闭弹窗，刷新配置列表

弹窗：配置详情

#弹窗类型

-- 居中模态弹窗（小型）；遮罩：有；只读

#整体布局

-- 宽度约 720px

#标题栏操作

-- 关闭（×）：关闭弹窗

#底部按钮

-- 编辑：打开「弹窗：编辑检查周期配置」

#交互说明

-- 全部字段只读

检查任务管理

功能描述

承载周期检查计划制定与任务管理，提供抽检清单生成、人员分配及进度跟踪能力，支持管理人员直接新建检查任务并派单，实现检查任务规范化派发与监控。

菜单权限

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

数据权限

表务营业办/供水站管理人员：可见、可操作本营业办/供水站范围内检查任务；可新建本管辖范围任务。

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

表务总公司管理人员、表务水表管理中心：可见全公司检查任务数据。

表务系统管理员：可见、可操作全公司检查任务数据。

核心逻辑

以检查任务为查询主体，关联抽检水表明细及检查记录；任务下发后同步 App 待办。

功能需求

一级页面：检查任务管理

#整体布局

-- 布局骨架：上下混合；上方查询条件；下方左侧任务进度统计看板、右侧上方状态统计卡片、右侧下方任务列表

-- 页面右上角「新建检查任务」

#查询条件

-- 所属分公司、营业办/供水站、任务编号、任务名称、任务状态（草稿/待执行/执行中/已完成/已逾期/已关闭）

-- 计划开始/结束日期、检查人员、创建人；查询、重置

#统计看板

-- 左侧：任务总数、待执行、执行中、已完成、已逾期；检查水表总数、完成率

-- 右侧卡片：待执行、执行中、即将逾期（≤3天）、已逾期；点击联动列表

#数据列表

-- 表格标题：周期检查任务列表

-- 表格字段：任务编号、任务名称、所属分公司、营业办/供水站、计划开始/结束日期、检查水表数、已完成数、完成率、检查人员、任务状态、创建人、创建时间

-- 行内操作：详情；编辑（草稿/待执行）；分配人员；下发；关闭；删除（仅草稿）

#交互说明

-- 完成率 = 已完成数 / 检查水表数 × 100%，保留 1 位小数

-- 周期检查仅追加检查记录，不改变水表「在用」状态

-- 打开「弹窗：新建/编辑检查任务」「弹窗：检查任务详情」

弹窗：新建/编辑检查任务

#弹窗类型

-- 居中模态弹窗，宽度约 960px

#信息展示

-- 任务名称、所属营业办/供水站、计划开始/结束日期、检查人员、任务说明

-- 抽检方式：按配置自动抽检（默认）/ 手工选择

-- 抽检比例：自动时只读，来源于检查周期配置

-- 已选/待选水表明细 Tab；待选支持批量加入，去重校验

#底部按钮

-- 保存草稿；保存并下发；取消

#交互说明

-- 自动抽检仅抽取「在用」且已安装水表

-- 同周期内不可重复加入其他待执行/执行中任务

-- 编辑已下发任务仅可延后结束日期、改人员、追加/移除待检查明细

弹窗：检查任务详情

#弹窗类型

-- 抽屉弹窗（右侧），宽度约 1100px

#信息展示

-- 任务摘要卡片 + Tab：抽检水表明细 / 检查记录汇总 / 操作日志

-- 明细 Tab：检查状态、结果摘要；已完成可「查看检查记录」

#底部按钮

-- 分配人员；关闭任务；导出明细；关闭

#交互说明

-- 打开「子弹窗：检查记录详情」；Web 检查记录只读

子弹窗：检查记录详情

#弹窗类型

-- 居中模态弹窗，宽度约 720px；只读

#信息展示

-- 用户、水表、检查项结果、扩展检查项、现场照片、GPS、备注

#底部按钮

-- 关闭

#交互说明

-- 异常项顶部展示橙色/红色提示条

检查任务执行（App）

功能描述

面向抄表员移动端作业，提供检查任务接收、现场检查项填报、拍照定位及结果提交能力，支持外勤完成周期检查现场作业，实现检查数据实时采集与归档。

菜单权限

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

数据权限

表务营业办/供水站职员：仅可查看及操作负责人为本人的检查任务及现场填报。

表务营业办/供水站管理人员：本营业办/供水站数据。

表务分公司管理人员：本分公司及下属营业办、供水站数据。

表务总公司管理人员、表务水表管理中心、表务系统管理员：全公司数据。

核心逻辑

App 提交仅追加检查记录，不改变水表状态；与到期检定相互独立。

功能需求

一级页面：检查任务列表（App）

#整体布局

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

#页面标题

-- 标题文案：周期检查

#查询条件

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

#信息展示

-- 卡片：任务编号、任务名称、检查水表数、已完成数、计划结束日期、任务状态

#交互说明

-- 抄表员仅负责人为本人的任务；管理人员可按数据权限查看更广范围

-- 点击进入「二级页面：检查任务详情（App）」

二级页面：检查任务详情（App）

#页面标题

-- 标题文案：任务详情

#信息展示

-- 任务名称、计划日期、检查水表明细卡片（水表表号、用户名称、检查状态）

#交互说明

-- 待检查水表卡片进入「三级页面：现场检查填报（App）」

-- 已完成水表进入「三级页面：检查记录详情（App）」

三级页面：现场检查填报（App）

#信息展示

-- 水表表号：只读，支持扫码

-- 运行状态、表体完好状态、铅封完好状态：必填，下拉

-- 漏水情况、违规用水排查：必填

-- 现场抄见读数：必填；读数比对结果：系统自动计算

-- 扩展检查项：按配置模板动态展示

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

-- GPS：自动采集

-- 备注：选填

#底部按钮

-- 暂存；提交

#交互说明

-- 提交后追加检查记录，水表保持「在用」

-- 支持离线暂存；提交后 Web 完成率自动更新

三级页面：检查记录详情（App）

#信息展示

-- 检查记录全部字段只读展示

#底部按钮

-- 返回

#交互说明

-- 与 Web「子弹窗：检查记录详情」字段一致

详细设计（研发）

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

仪陇表务-功能设计-20-周期检查-V1.0

# 仪陇表务 — 功能设计 20 周期检查 V1.0

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

1. 模块概述

项 说明
模块序号 20
模块名称 周期检查
后端包（建议） com.tofly.wm.manage.inspect
业务模式 配置+任务
工单 无

2. 功能范围

  • 检查周期配置
  • 检查任务管理
  • App 执行

3. 数据模型

3.1 涉及表

  • wssmet_inspectcfg_w
  • wssmet_inspecttask_w
  • wssmet_inspecttaskmeter_w
  • wssmet_inspectrec_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 状态)。

5. 核心业务规则

  • CHECK_ITEMS JSON
  • 完成率统计

6. 接口设计（概要）

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

周期检查规则-分页查询

项 内容
接口说明 分页查询周期检查规则
请求地址 GET /api/wm/manage/inspect/inspectConfig/page
请求类型 GET

入参（Query（PageQuery））

字段 类型 说明
configName String 配置
sampleRatio String 抽检比例
planCycleMonths String 计划周期
taskDeadlineDays String 任务
checkItems String 项
remindDaysBefore String 提醒
statusCode String（枚举 code） 状态

出参

  • ResultResponse>

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

    data（PageInfo）字段

    InspectConfigVo 字段

    字段 类型 说明
    pageNum Integer 当前页码
    pageSize Integer 每页条数
    total Long 总记录数
    pages Integer 总页数
    list List 当前页数据列表
    字段 类型 说明
    id String 主键
    configName String 配置
    sampleRatio String 抽检比例
    planCycleMonths String 计划周期
    taskDeadlineDays String 任务
    checkItems String 项
    remindDaysBefore String 提醒
    statusCode String（枚举 code） 状态

    周期检查规则-列表查询

    项 内容
    接口说明 列表查询周期检查规则
    请求地址 GET /api/wm/manage/inspect/inspectConfig/list
    请求类型 GET

    入参（Query）

    字段 类型 说明
    configName String 配置
    sampleRatio String 抽检比例
    planCycleMonths String 计划周期
    taskDeadlineDays String 任务
    checkItems String 项
    remindDaysBefore String 提醒
    statusCode String（枚举 code） 状态

    出参

    • ResultResponse>

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

      data（List）元素字段

      InspectConfigVo 字段

      字段 类型 说明
      id String 主键
      configName String 配置
      sampleRatio String 抽检比例
      planCycleMonths String 计划周期
      taskDeadlineDays String 任务
      checkItems String 项
      remindDaysBefore String 提醒
      statusCode String（枚举 code） 状态

      周期检查规则-详情

      项 内容
      接口说明 查询周期检查规则详情
      请求地址 GET /api/wm/manage/inspect/inspectConfig/{id}
      请求类型 GET

      入参（Path: id）

      字段 类型 说明
      id String 主键

      出参

      • ResultResponse（含明细 list 若适用）

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

        data（InspectConfigVo）字段

        InspectConfigVo 字段

        字段 类型 说明
        id String 主键
        configName String 配置
        sampleRatio String 抽检比例
        planCycleMonths String 计划周期
        taskDeadlineDays String 任务
        checkItems String 项
        remindDaysBefore String 提醒
        statusCode String（枚举 code） 状态

        周期检查规则-新增

        项 内容
        接口说明 新增周期检查规则
        请求地址 POST /api/wm/manage/inspect/inspectConfig/
        请求类型 POST

        入参（Body: Dto）

        字段 类型 说明
        configName String 配置
        sampleRatio String 抽检比例
        planCycleMonths String 计划周期
        taskDeadlineDays String 任务
        checkItems String 项
        remindDaysBefore String 提醒
        statusCode String（枚举 code） 状态

        出参

        • ResultResponse

          • data 字段

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

          周期检查规则-修改

          项 内容
          接口说明 修改周期检查规则
          请求地址 POST /api/wm/manage/inspect/inspectConfig/update
          请求类型 POST

          入参（Body: Dto（含 id））

          字段 类型 说明
          configName String 配置
          sampleRatio String 抽检比例
          planCycleMonths String 计划周期
          taskDeadlineDays String 任务
          checkItems String 项
          remindDaysBefore String 提醒
          statusCode String（枚举 code） 状态

          出参

          • ResultResponse

            • data 无业务字段（null）。

            周期检查规则-删除

            项 内容
            接口说明 逻辑删除周期检查规则（支持批量）
            请求地址 DELETE /api/wm/manage/inspect/inspectConfig/deleteByIds?ids=1,2
            请求类型 DELETE

            入参（Query: ids）

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

            出参

            • ResultResponse

              • data 无业务字段（null）。

              周期检查任务-分页查询

              项 内容
              接口说明 分页查询周期检查任务
              请求地址 GET /api/wm/manage/inspect/inspectTask/page
              请求类型 GET

              入参（Query（PageQuery））

              字段 类型 说明
              taskCode String 任务编号
              taskName String 任务
              planStartDate Date 计划日期
              planEndDate Date 计划日期
              inspectorName String 检查人
              meterQty Integer 水表数量
              finishedQty Integer 数量
              completionRate String 完成
              taskStatusCode String（枚举 code） 任务状态
              sampleModeCode String（字典 code） 抽检方式编号
              sampleRatio String 抽检比例
              taskDesc String 任务

              出参

              • ResultResponse>

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

                data（PageInfo）字段

                InspectTaskVo 字段

                字段 类型 说明
                pageNum Integer 当前页码
                pageSize Integer 每页条数
                total Long 总记录数
                pages Integer 总页数
                list List 当前页数据列表
                字段 类型 说明
                id String 主键
                taskCode String 任务
                taskName String 任务
                orgId Long 组织ID，关联tf_org表的id字段
                planStartDate Date 计划日期
                planEndDate Date 计划日期
                inspectorId Long 检查人ID，关联tf_user表的id字段
                inspectorName String 检查人
                meterQty Integer 水表数量
                finishedQty Integer 数量
                completionRate String 完成
                taskStatusCode String（枚举 code） 任务状态
                sampleModeCode String（字典 code） 抽检方式
                sampleRatio String 抽检比例
                taskDesc String 任务

                周期检查任务-列表查询

                项 内容
                接口说明 列表查询周期检查任务
                请求地址 GET /api/wm/manage/inspect/inspectTask/list
                请求类型 GET

                入参（Query）

                字段 类型 说明
                taskCode String 任务编号
                taskName String 任务
                planStartDate Date 计划日期
                planEndDate Date 计划日期
                inspectorName String 检查人
                meterQty Integer 水表数量
                finishedQty Integer 数量
                completionRate String 完成
                taskStatusCode String（枚举 code） 任务状态
                sampleModeCode String（字典 code） 抽检方式编号
                sampleRatio String 抽检比例
                taskDesc String 任务

                出参

                • ResultResponse>

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

                  data（List）元素字段

                  InspectTaskVo 字段

                  字段 类型 说明
                  id String 主键
                  taskCode String 任务
                  taskName String 任务
                  orgId Long 组织ID，关联tf_org表的id字段
                  planStartDate Date 计划日期
                  planEndDate Date 计划日期
                  inspectorId Long 检查人ID，关联tf_user表的id字段
                  inspectorName String 检查人
                  meterQty Integer 水表数量
                  finishedQty Integer 数量
                  completionRate String 完成
                  taskStatusCode String（枚举 code） 任务状态
                  sampleModeCode String（字典 code） 抽检方式
                  sampleRatio String 抽检比例
                  taskDesc String 任务

                  周期检查任务-详情

                  项 内容
                  接口说明 查询周期检查任务详情
                  请求地址 GET /api/wm/manage/inspect/inspectTask/{id}
                  请求类型 GET

                  入参（Path: id）

                  字段 类型 说明
                  id String 主键

                  出参

                  • ResultResponse（含明细 list 若适用）

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

                    data（InspectTaskVo）字段

                    InspectTaskVo 字段

                    字段 类型 说明
                    id String 主键
                    taskCode String 任务
                    taskName String 任务
                    orgId Long 组织ID，关联tf_org表的id字段
                    planStartDate Date 计划日期
                    planEndDate Date 计划日期
                    inspectorId Long 检查人ID，关联tf_user表的id字段
                    inspectorName String 检查人
                    meterQty Integer 水表数量
                    finishedQty Integer 数量
                    completionRate String 完成
                    taskStatusCode String（枚举 code） 任务状态
                    sampleModeCode String（字典 code） 抽检方式
                    sampleRatio String 抽检比例
                    taskDesc String 任务

                    周期检查任务-新增

                    项 内容
                    接口说明 新增周期检查任务
                    请求地址 POST /api/wm/manage/inspect/inspectTask/
                    请求类型 POST

                    入参（Body: Dto）

                    字段 类型 说明
                    taskCode String 任务编号
                    taskName String 任务
                    orgId Long 组织ID，关联tf_org表的id字段
                    planStartDate Date 计划日期
                    planEndDate Date 计划日期
                    inspectorId Long 检查人ID，关联tf_user表的id字段
                    inspectorName String 检查人
                    meterQty Integer 水表数量
                    finishedQty Integer 数量
                    completionRate String 完成
                    taskStatusCode String（枚举 code） 任务状态
                    sampleModeCode String（字典 code） 抽检方式编号
                    sampleRatio String 抽检比例
                    taskDesc String 任务

                    出参

                    • ResultResponse

                      • data 字段

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

                      周期检查任务-修改

                      项 内容
                      接口说明 修改周期检查任务
                      请求地址 POST /api/wm/manage/inspect/inspectTask/update
                      请求类型 POST

                      入参（Body: Dto（含 id））

                      字段 类型 说明
                      taskCode String 任务编号
                      taskName String 任务
                      orgId Long 组织ID，关联tf_org表的id字段
                      planStartDate Date 计划日期
                      planEndDate Date 计划日期
                      inspectorId Long 检查人ID，关联tf_user表的id字段
                      inspectorName String 检查人
                      meterQty Integer 水表数量
                      finishedQty Integer 数量
                      completionRate String 完成
                      taskStatusCode String（枚举 code） 任务状态
                      sampleModeCode String（字典 code） 抽检方式编号
                      sampleRatio String 抽检比例
                      taskDesc String 任务

                      出参

                      • ResultResponse

                        • data 无业务字段（null）。

                        周期检查任务-删除

                        项 内容
                        接口说明 逻辑删除周期检查任务（支持批量）
                        请求地址 DELETE /api/wm/manage/inspect/inspectTask/deleteByIds?ids=1,2
                        请求类型 DELETE

                        入参（Query: ids）

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

                        出参

                        • ResultResponse

                          • data 无业务字段（null）。

                          周期检查现场记录-分页查询

                          项 内容
                          接口说明 分页查询周期检查现场记录
                          请求地址 GET /api/wm/manage/inspect/inspectRecord/page
                          请求类型 GET

                          入参（Query（PageQuery））

                          字段 类型 说明
                          runStatusCode String（枚举 code） 运行状态
                          bodyStatusCode String（枚举 code） 表体状态
                          sealStatusCode String（枚举 code） 铅封状态
                          leakStatusCode String（枚举 code） 漏水状态
                          illegalUseCode String（字典 code） 违规编号
                          readingValue String 读数
                          readingCompareCode String（字典 code） 读数比对编号
                          extItems String 扩展项
                          gpsLat String GPS纬度
                          gpsLng String GPS经度
                          remark String 备注

                          出参

                          • ResultResponse>

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

                            data（PageInfo）字段

                            InspectRecordVo 字段

                            字段 类型 说明
                            pageNum Integer 当前页码
                            pageSize Integer 每页条数
                            total Long 总记录数
                            pages Integer 总页数
                            list List 当前页数据列表
                            字段 类型 说明
                            id String 主键
                            taskMeterId Long 周期检查任务水表明细ID，关联wssmet_inspecttaskmeter_w表的id字段
                            runStatusCode String（枚举 code） 运行状态
                            bodyStatusCode String（枚举 code） 表体状态
                            sealStatusCode String（枚举 code） 铅封状态
                            leakStatusCode String（枚举 code） 漏水状态
                            illegalUseCode String（字典 code） 违规
                            readingValue String 读数
                            readingCompareCode String（字典 code） 读数比对
                            extItems String 扩展项
                            gpsLat String GPS纬度
                            gpsLng String GPS经度
                            remark String 备注

                            周期检查现场记录-列表查询

                            项 内容
                            接口说明 列表查询周期检查现场记录
                            请求地址 GET /api/wm/manage/inspect/inspectRecord/list
                            请求类型 GET

                            入参（Query）

                            字段 类型 说明
                            runStatusCode String（枚举 code） 运行状态
                            bodyStatusCode String（枚举 code） 表体状态
                            sealStatusCode String（枚举 code） 铅封状态
                            leakStatusCode String（枚举 code） 漏水状态
                            illegalUseCode String（字典 code） 违规编号
                            readingValue String 读数
                            readingCompareCode String（字典 code） 读数比对编号
                            extItems String 扩展项
                            gpsLat String GPS纬度
                            gpsLng String GPS经度
                            remark String 备注

                            出参

                            • ResultResponse>

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

                              data（List）元素字段

                              InspectRecordVo 字段

                              字段 类型 说明
                              id String 主键
                              taskMeterId Long 周期检查任务水表明细ID，关联wssmet_inspecttaskmeter_w表的id字段
                              runStatusCode String（枚举 code） 运行状态
                              bodyStatusCode String（枚举 code） 表体状态
                              sealStatusCode String（枚举 code） 铅封状态
                              leakStatusCode String（枚举 code） 漏水状态
                              illegalUseCode String（字典 code） 违规
                              readingValue String 读数
                              readingCompareCode String（字典 code） 读数比对
                              extItems String 扩展项
                              gpsLat String GPS纬度
                              gpsLng String GPS经度
                              remark String 备注

                              周期检查现场记录-详情

                              项 内容
                              接口说明 查询周期检查现场记录详情
                              请求地址 GET /api/wm/manage/inspect/inspectRecord/{id}
                              请求类型 GET

                              入参（Path: id）

                              字段 类型 说明
                              id String 主键

                              出参

                              • ResultResponse（含明细 list 若适用）

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

                                data（InspectRecordVo）字段

                                InspectRecordVo 字段

                                字段 类型 说明
                                id String 主键
                                taskMeterId Long 周期检查任务水表明细ID，关联wssmet_inspecttaskmeter_w表的id字段
                                runStatusCode String（枚举 code） 运行状态
                                bodyStatusCode String（枚举 code） 表体状态
                                sealStatusCode String（枚举 code） 铅封状态
                                leakStatusCode String（枚举 code） 漏水状态
                                illegalUseCode String（字典 code） 违规
                                readingValue String 读数
                                readingCompareCode String（字典 code） 读数比对
                                extItems String 扩展项
                                gpsLat String GPS纬度
                                gpsLng String GPS经度
                                remark String 备注

                                周期检查现场记录-新增

                                项 内容
                                接口说明 新增周期检查现场记录
                                请求地址 POST /api/wm/manage/inspect/inspectRecord/
                                请求类型 POST

                                入参（Body: Dto）

                                字段 类型 说明
                                taskMeterId Long 周期检查任务水表明细ID，关联wssmet_inspecttaskmeter_w表的id字段
                                runStatusCode String（枚举 code） 运行状态
                                bodyStatusCode String（枚举 code） 表体状态
                                sealStatusCode String（枚举 code） 铅封状态
                                leakStatusCode String（枚举 code） 漏水状态
                                illegalUseCode String（字典 code） 违规编号
                                readingValue String 读数
                                readingCompareCode String（字典 code） 读数比对编号
                                extItems String 扩展项
                                gpsLat String GPS纬度
                                gpsLng String GPS经度
                                remark String 备注

                                出参

                                • ResultResponse

                                  • data 字段

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

                                  周期检查现场记录-修改

                                  项 内容
                                  接口说明 修改周期检查现场记录
                                  请求地址 POST /api/wm/manage/inspect/inspectRecord/update
                                  请求类型 POST

                                  入参（Body: Dto（含 id））

                                  字段 类型 说明
                                  taskMeterId Long 周期检查任务水表明细ID，关联wssmet_inspecttaskmeter_w表的id字段
                                  runStatusCode String（枚举 code） 运行状态
                                  bodyStatusCode String（枚举 code） 表体状态
                                  sealStatusCode String（枚举 code） 铅封状态
                                  leakStatusCode String（枚举 code） 漏水状态
                                  illegalUseCode String（字典 code） 违规编号
                                  readingValue String 读数
                                  readingCompareCode String（字典 code） 读数比对编号
                                  extItems String 扩展项
                                  gpsLat String GPS纬度
                                  gpsLng String GPS经度
                                  remark String 备注

                                  出参

                                  • ResultResponse

                                    • data 无业务字段（null）。

                                    周期检查现场记录-删除

                                    项 内容
                                    接口说明 逻辑删除周期检查现场记录（支持批量）
                                    请求地址 DELETE /api/wm/manage/inspect/inspectRecord/deleteByIds?ids=1,2
                                    请求类型 DELETE

                                    入参（Query: ids）

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

                                    出参

                                    • ResultResponse

                                      • data 无业务字段（null）。