Etusivu Tutki Apua
Kirjaudu sisään
zenghaiyang
/
ylsw-bw
1
0
Fork 0
Tiedostot Ongelmat 0 Pull-pyynnöt 0 Wiki
Puu: 85a21dde45
Haarat Tagit
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-10-其他检定登记-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-10-其他检定登记-V1.0.md 15 KB
Historia Raaka

源文件：仪陇表务管理系统-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、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；实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc（`wssmet_` 表名），不参照存量业务表与接口。*

接口设计（研发）

统一前缀：/api/wm/manage/verify/other；各接口 出参 须为具体泛型（见下文，禁止 T/Vo 占位）；公共约定见 仪陇表务-公共接口说明-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>

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

    data（PageInfo）字段

    OtherVerifyVo 字段

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

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

      data（List）元素字段

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

        • 外层包装 ResultResponse 含 code、message、data，见 公共接口说明 §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

          • 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

            • data 无业务字段（null）。

            其他检定登记-删除

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

            入参（Query: ids）

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

            出参

            • ResultResponse

              • data 无业务字段（null）。