> **源文件**：仪陇表务管理系统-PRD-04-功能需求说明-10-其他检定登记-V1.0.docx
> **导出时间**：2026-05-26 10:34


**仪陇表务管理系统
产品需求说明书
04-功能需求说明
其他检定登记**

文档版本：V1.0

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

模块序号：10

模块名称：其他检定登记

## 其他检定登记

本模块覆盖除落地检、到期检、争议检以外的其他原因检定场景，由总公司检定人员在 Web 端补充登记检定记录，与水表检定记录、水表台账联动，保障全部检定记录完整可追溯。

### **其他检定登记**

#### 功能描述

承载非标准场景水表检定的补充登记，提供检定原因注明、检定数据录入及台账关联能力，支持检定员完善检定档案，实现除落地检、到期检、争议检以外检定场景的数据补录与溯源。

#### 菜单权限

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

#### 数据权限

表务水表管理中心：可见、可操作全公司范围内其他检定登记数据。

表务总公司管理人员：可见全公司范围内其他检定登记数据（只读）。

表务系统管理员：可见、可操作全公司范围内其他检定登记数据。

表务分公司管理人员、表务营业办/供水站职员：不可见本菜单。

#### 核心逻辑

以其他检定登记单为业务主体，登记时须注明检定原因。

保存后自动写入检定台账，检定属性标记为「其他检定」；可与「水表检定记录」中测量系统记录 ID 关联。

本菜单为直接登记，无需工单审批；不合格处置在返厂 / 报废等相关模块办理。

#### 功能需求

##### **一级页面：其他检定登记**

#整体布局

-- 上下结构：查询条件区 + 数据列表区；顶部「新建登记」按钮

#查询条件

-- 登记单号：文本，支持模糊搜索

-- 水表编号：文本，支持模糊搜索

-- 检定原因：下拉单选（全部、抽检复核、故障排查、其他）

-- 检定结果：下拉单选（全部、合格、不合格）

-- 登记日期：日期范围选择

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

#数据列表

-- 表格标题：其他检定登记列表

-- 表格字段：登记单号、水表编号、水表口径、水表类型、检定原因、检定结果、检定日期、检定人员、关联检定记录 ID、登记时间

-- 行内操作：详情；编辑（未关联作废检定记录时可编辑）

#交互说明

-- 点击「新建登记」打开「弹窗：新建/编辑其他检定登记」

-- 点击行或「详情」打开「弹窗：其他检定登记详情」

##### **弹窗：新建/编辑其他检定登记**

#弹窗类型

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

#整体布局

-- 宽度约 800px；表单区

#信息展示

-- 水表编号：必填，文本，支持扫码；须校验水表存在于系统中

-- 水表口径：只读，选择水表后自动带出

-- 水表类型：只读，选择水表后自动带出

-- 检定原因：必填，下拉单选（抽检复核、故障排查、返厂复检、其他）；选「其他」时须填写原因说明

-- 原因说明：选填，文本，检定原因为「其他」时必填，最多 200 字

-- 检定结果：必填，单选（合格、不合格）

-- 检定日期：必填，日期，默认当前日期

-- 检定人员：只读，默认当前登录用户

-- 关联检定记录 ID：选填，文本或选择，与「水表检定记录」中测量系统记录关联

-- 检定数据摘要：选填，多行文本（检定读数、误差等要点）

-- 备注：选填，多行文本，最多 500 字

#底部按钮

-- 保存：校验必填项后保存

-- 取消：关闭弹窗

#交互说明

-- 保存成功后刷新一级页面列表，并驱动检定台账自动关联（检定属性标记为「其他检定」）

-- 不合格水表按业务规则进入返厂或报废流程，不在本菜单办理

##### **弹窗：其他检定登记详情**

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有

#整体布局

-- 宽度约 900px；只读展示登记全部字段

#底部按钮

-- 关闭

-- 编辑：登记未作废且当前用户有权限时显示

#交互说明

-- 关联检定记录 ID 可跳转「水表检定记录」对应记录（新窗口或页内路由）

---

## 详细设计（研发）

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

### 仪陇表务-功能设计-10-其他检定登记-V1.0

# 仪陇表务 — 功能设计 10 其他检定登记 V1.0

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

## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 10 |
| 模块名称 | 其他检定登记 |
| 后端包（建议） | `com.tofly.wm.manage.verify.other` |
| 业务模式 | 登记直办 |
| 工单 | 无 |

## 2. 功能范围

- 其他检定登记

## 3. 数据模型

### 3.1 涉及表

- `wssmet_otherverify_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. 核心业务规则

- VERIFY_ATTR=其他检定

## 6. 接口设计（概要）

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | `/otherVerify/` | 见 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/verify/other`；各接口 **出参** 须为具体泛型（见下文，**禁止** `T`/`Vo` 占位）；公共约定见 [仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)。

#### 其他检定登记-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询其他检定登记 |
| 请求地址 | `GET /api/wm/manage/verify/other/otherVerify/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| verifyReasonCode | String（字典 code） | 检定原因编号 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<OtherVerifyVo>>

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

**data（PageInfo）字段**

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

**`OtherVerifyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| verifyReasonCode | String（字典 code） | 检定原因 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定结果 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |
#### 其他检定登记-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询其他检定登记 |
| 请求地址 | `GET /api/wm/manage/verify/other/otherVerify/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| verifyReasonCode | String（字典 code） | 检定原因编号 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<OtherVerifyVo>>

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

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

**`OtherVerifyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| verifyReasonCode | String（字典 code） | 检定原因 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定结果 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |
#### 其他检定登记-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询其他检定登记详情 |
| 请求地址 | `GET /api/wm/manage/verify/other/otherVerify/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（OtherVerifyVo）字段**

**`OtherVerifyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| verifyReasonCode | String（字典 code） | 检定原因 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定结果 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |

#### 其他检定登记-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增其他检定登记 |
| 请求地址 | `POST /api/wm/manage/verify/other/otherVerify/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| verifyReasonCode | String（字典 code） | 检定原因编号 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 其他检定登记-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改其他检定登记 |
| 请求地址 | `POST /api/wm/manage/verify/other/otherVerify/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| verifyReasonCode | String（字典 code） | 检定原因编号 |
| reasonDesc | String | 原因 |
| verifyResultCode | String（枚举 code） | 检定 |
| verifyDate | Date | 检定日期 |
| verifyUserId | Long | 检定用户ID，关联tf_user表的id字段 |
| verifyRecordId | Long | 检定记录编号，关联wssmet_verifyrecord_w表的record_id字段 |
| verifySummary | String | 检定摘要 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 其他检定登记-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除其他检定登记（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/verify/other/otherVerify/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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