> **源文件**：仪陇表务管理系统-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)  
> 接口约定：见本文 **§接口设计（研发）**、[仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)、[00-总体框架设计-V1.0.md](../../design/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](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*



---

## 接口设计（研发）

> 统一前缀：`/api/wm/manage/inspect`；各接口 **出参** 须为具体泛型（见下文，**禁止** `T`/`Vo` 占位）；公共约定见 [仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-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<PageInfo<InspectConfigVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

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

**`InspectConfigVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| 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<List<InspectConfigVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<InspectConfigVo>）元素字段**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 周期检查规则-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**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<PageInfo<InspectTaskVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<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 | 任务 |
#### 周期检查任务-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询周期检查任务 |
| 请求地址 | `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<List<InspectTaskVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<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 | 任务 |
#### 周期检查任务-详情

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

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<InspectTaskVo>（含明细 list 若适用）

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 周期检查任务-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**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<PageInfo<InspectRecordVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<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 | 备注 |
#### 周期检查现场记录-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询周期检查现场记录 |
| 请求地址 | `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<List<InspectRecordVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<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 | 备注 |
#### 周期检查现场记录-详情

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

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<InspectRecordVo>（含明细 list 若适用）

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 周期检查现场记录-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。