zenghaiyang/ylsw-bw @ 85a21dde455f4862709dd83f66dcd9997b252be1

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

文档版本：V1.0

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

模块序号：02

模块名称：水表台账

水表台账

本模块汇总水表全生命周期资产档案及按业务类型分类台账，对应《PRD-01》水表台账模块。含 Web 菜单：水表查询、采购台账、检定台账、入库/出库台账（总仓/分仓）、安装台账、换表台账、周检台账、轮换台账、报废台账、统计报表。

水表查询

功能描述

页面展示水表基础信息列表，并附带全生命周期时间轴视图；支持多维度检索与单表全流程追溯。

菜单权限

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

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的水表基础信息数据。

核心逻辑

以水表基础信息为列表主体；详情页以水表生命周期记录按时间轴展示各阶段流转。

列表与详情只读，不提供资产状态变更操作（变更由各业务模块办理）。

功能需求

一级页面：水表查询

#整体布局

-- 布局骨架：左右结构；左区查询条件 + 列表，右区生命周期时间轴（选中行后展示）

#查询条件

-- 所属仓库：下拉

-- 管辖分公司：组织树 / 下拉

-- 水表口径：下拉

-- 水表类型：下拉

-- 水表编号（表号）：文本，模糊

-- 出厂编号：文本，模糊

-- 水表状态：下拉（全部及在库/在用/检定中等字典项）

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

#数据列表

-- 表格标题：水表资产列表

-- 表格字段：水表编号、出厂编号、水表口径、水表类型、当前状态、所属仓库、管辖分公司、最近业务时间

-- 行内操作：详情

#交互说明

-- 选中列表行，右区刷新该水表生命周期时间轴

-- 点击「详情」打开「弹窗：水表资产详情」

弹窗：水表资产详情

#弹窗类型

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

#整体布局

-- 宽度约 1100px；Tab：基础信息 / 生命周期时间轴 / 关联业务单据

#弹窗标题

-- 水表资产详情 - {水表编号}

#信息展示

-- 基础信息：表号、出厂编码、口径、类型、状态、仓库、用户绑定信息（在用时）等

-- 时间轴：按时间倒序展示到货、落地检、入库、出库、安装、换表、检定、报废等阶段

-- 关联单据：跳转或只读展示关联采购、领用、安装、换表等业务单号

#底部按钮

-- 关闭

采购台账

功能描述

页面展示采购台账列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购；表务分公司管理人员；表务分公司库管员

数据权限

可见、可查询当前用户所属部门及管辖部门范围内、关联采购申请部门为本部门范围的采购计划及到货数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：采购台账

#整体布局

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

#查询条件

-- 采购计划单号

-- 厂家

-- 到货日期

-- 到货状态

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：采购计划及到货

-- 表格字段：采购计划单号、厂家、水表口径、计划数量、到货数量、到货日期、到货状态、关联申请单号

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：采购台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：采购台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 采购台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

检定台账

功能描述

页面展示检定台账列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购；表务分公司管理人员；表务分公司库管员

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的检定台账数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：检定台账

#整体布局

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

#查询条件

-- 水表编号

-- 出厂编号

-- 检定类型

-- 检定时间

-- 检定结果

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：检定记录

-- 表格字段：水表编号、出厂编号、检定类型、检定时间、检定结果、检定人、关联业务单号

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：检定台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：检定台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 检定台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

入库台账-总仓

功能描述

页面展示入库台账-总仓列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购

数据权限

可见、可查询总仓全部入库业务数据（出入库方向为入库且仓库类型为总仓）。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：入库台账-总仓

#整体布局

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

#查询条件

-- 水表编号

-- 入库时间

-- 入库类型

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：总仓入库台账

-- 表格字段：入库单号、水表编号、入库类型、入库时间、所属仓库、登记人

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：入库台账-总仓详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：入库台账-总仓详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 入库台账-总仓详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

出库台账-总仓

功能描述

页面展示出库台账-总仓列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购

数据权限

可见、可查询总仓全部出库业务数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：出库台账-总仓

#整体布局

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

#查询条件

-- 水表编号

-- 出库时间

-- 出库类型

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：总仓出库台账

-- 表格字段：出库单号、水表编号、出库类型、出库时间、所属仓库、登记人

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：出库台账-总仓详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：出库台账-总仓详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 出库台账-总仓详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

入库台账-分仓

功能描述

页面展示入库台账-分仓列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购；表务分公司管理人员；表务分公司库管员

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的分仓入库数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：入库台账-分仓

#整体布局

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

#查询条件

-- 水表编号

-- 入库时间

-- 入库类型

-- 所属仓库

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：分仓入库台账

-- 表格字段：入库单号、水表编号、入库类型、入库时间、所属机构、所属仓库

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：入库台账-分仓详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：入库台账-分仓详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 入库台账-分仓详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

出库台账-分仓

功能描述

页面展示出库台账-分仓列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购；表务分公司管理人员；表务分公司库管员

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的分仓出库数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：出库台账-分仓

#整体布局

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

#查询条件

-- 水表编号

-- 出库时间

-- 出库类型

-- 所属仓库

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：分仓出库台账

-- 表格字段：出库单号、水表编号、出库类型、出库时间、所属机构、所属仓库

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：出库台账-分仓详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：出库台账-分仓详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 出库台账-分仓详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

安装台账

功能描述

页面展示安装台账列表，支持检索筛选、详情查看及导出。

菜单权限

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

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的安装台账数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：安装台账

#整体布局

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

#查询条件

-- 水表编号

-- 用户编号

-- 安装时间

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：安装记录

-- 表格字段：安装单号、水表编号、用户编号、安装地址、安装时间、安装人、验收状态

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：安装台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：安装台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 安装台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

换表台账

功能描述

页面展示换表台账列表，支持检索筛选、详情查看及导出。

菜单权限

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

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的换表台账数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：换表台账

#整体布局

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

#查询条件

-- 旧表编号

-- 用户编号

-- 换装时间

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：换表记录

-- 表格字段：换表单号、旧表编号、新表编号、用户编号、换装时间、换表类型、执行人

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：换表台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：换表台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 换表台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

周检台账

功能描述

页面展示周检台账列表，支持检索筛选、详情查看及导出。

菜单权限

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

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的周期检查台账数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：周检台账

#整体布局

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

#查询条件

-- 水表编号

-- 检查时间

-- 检查结果

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：周期检查记录

-- 表格字段：检查单号、水表编号、用户编号、检查时间、检查结果、检查人

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：周检台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：周检台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 周检台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

轮换台账

功能描述

页面展示轮换台账列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购；表务分公司管理人员；表务分公司库管员

数据权限

可见、可查询当前用户所属部门及管辖部门范围内的轮换台账数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：轮换台账

#整体布局

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

#查询条件

-- 旧水表编号

-- 轮换时间

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：轮换记录

-- 表格字段：轮换单号、旧表编号、新表编号、用户编号、轮换时间、执行人

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：轮换台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：轮换台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 轮换台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

报废台账

功能描述

页面展示报废台账列表，支持检索筛选、详情查看及导出。

菜单权限

表务总公司管理人员；表务水表管理中心；表务水表采购；表务分公司管理人员；表务分公司库管员

数据权限

可见、可查询当前用户所属部门及管辖部门范围内、申请人部门属管辖范围的报废台账数据。

核心逻辑

以对应业务台账为查询主体；列表只读归集，业务办理在源业务模块。

功能需求

一级页面：报废台账

#整体布局

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

#查询条件

-- 水表编号

-- 报废完成时间

-- 功能按钮：查询、重置、导出（有权限时）

#数据列表

-- 表格标题：报废记录

-- 表格字段：报废单号、水表编号、报废原因、报废完成时间、登记人、处置状态

-- 行内操作：详情

#交互说明

-- 点击列表行或「详情」打开「弹窗：报废台账详情」

-- 列表支持分页；默认按业务时间倒序

弹窗：报废台账详情

#弹窗类型

-- 抽屉弹窗（右侧滑出）；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 960px；全高；内部分 Tab：业务信息 / 关联水表

#弹窗标题

-- 报废台账详情 - {业务单号}

#标题栏操作

-- 关闭（×）：关闭抽屉

#信息展示

-- 各 Tab 只读展示台账主信息、明细及关联水表列表

#底部按钮

-- 关闭

#交互说明

-- 本功能为只读查询，不提供编辑入口

统计报表

功能描述

汇总资产、库存、采购、检定、报废及工单等核心业务数据，提供多维度筛选、图表展示及导出，支撑管理层经营分析。

菜单权限

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

数据权限

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

表务分公司管理人员：可见本分公司及下属机构报表数据。

核心逻辑

报表数据来源于各业务台账汇总；按组织层级、时间、口径等维度聚合。

功能需求

一级页面：统计报表

#整体布局

-- 顶部报表类型 Tab：资产汇总、库存统计、采购到货、检定质量、报废处置、工单效率等

-- 各 Tab：筛选条件区 + 图表区 + 明细表格区

#查询条件

-- 统计周期：日期范围 / 月 / 季

-- 组织范围：总公司 / 指定分公司

-- 水表口径、水表类型：下拉（部分报表）

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

#交互说明

-- 图表与表格联动；导出 Excel/PDF（按报表类型）

-- 数据口径与 01 统计报表子功能描述一致，不自行扩展未立项指标

详细设计（研发）

仪陇表务-功能设计-02-水表台账-V1.0

# 仪陇表务 — 功能设计 02 水表台账 V1.0

1. 模块概述

项	说明
模块序号	02
模块名称	水表台账
后端包（建议）	`com.tofly.wm.ledger`
业务模式	只读查询
工单	无

2. 功能范围

水表查询
采购台账
检定台账
入出库台账(总仓/分仓)
安装/换表/周检/轮换/报废台账

3. 数据模型

3.1 涉及表

wssmet_meter_w
wssmet_meterlife_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. 业务流程

跨业务表聚合查询与导出；生命周期时间轴来自 LIFECYCLE。

5. 核心业务规则

出厂编码唯一
数据权限按管辖组织

6. 接口设计（概要）

方法	路径（示例前缀）	说明
—	`/ledger/meter/page`	见 PRD 界面
—	`/ledger/purchase/page`	见 PRD 界面
—	`/ledger/verify/page`	见 PRD 界面
—	—	…各台账 /export

标准 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_` 表名），不参照存量业务表与接口。*

接口设计（研发）

水表查询-分页查询

项	内容
接口说明	分页查询水表查询
请求地址	`GET /api/wm/ledger/meter/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
meterCode	String	水表表号
factoryCode	String	出厂编码
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
meterStatusCode	String（枚举 code）	水表状态
inStockAttrCode	String（字典 code）	入库库存属性编号
sealNo	String	铅封
userNo	String	用户
userName	String	用户
installAddress	String	安装地址
meterPosition	String	水表表位
firstVerifyDate	Date	首次检定日期
lastVerifyDate	Date	最近检定日期
nextVerifyDate	Date	下次检定日期
rotateDueDate	Date	轮换到期日期
remark	String	备注

出参

ResultResponse>

data（PageInfo）字段

MeterVo 字段

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

字段	类型	说明
id	String	主键
meterCode	String	水表表号
factoryCode	String	出厂编码
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
meterStatusCode	String（枚举 code）	水表状态
inStockAttrCode	String（字典 code）	入库库存属性
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
brandModelId	Long	厂家型号ID，关联wssmet_brandmodel_w表的id字段
sealNo	String	铅封
userNo	String	用户
userName	String	用户
installAddress	String	安装地址
meterPosition	String	水表表位
firstVerifyDate	Date	首次检定日期
lastVerifyDate	Date	最近检定日期
nextVerifyDate	Date	下次检定日期
rotateDueDate	Date	轮换到期日期
purchasePlanId	Long	采购计划ID，关联wssmet_purplan_w表的id字段
manageOrgId	Long	管辖组织ID，关联tf_org表的id字段
remark	String	备注

水表查询-列表查询

项	内容
接口说明	列表查询水表查询（不分页）
请求地址	`GET /api/wm/ledger/meter/list`
请求类型	GET

入参（Query）

字段	类型	说明
meterCode	String	水表表号
factoryCode	String	出厂编码
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
meterStatusCode	String（枚举 code）	水表状态
inStockAttrCode	String（字典 code）	入库库存属性编号
sealNo	String	铅封
userNo	String	用户
userName	String	用户
installAddress	String	安装地址
meterPosition	String	水表表位
firstVerifyDate	Date	首次检定日期
lastVerifyDate	Date	最近检定日期
nextVerifyDate	Date	下次检定日期
rotateDueDate	Date	轮换到期日期
remark	String	备注

出参

ResultResponse>

data（List）元素字段

MeterVo 字段

字段	类型	说明
id	String	主键
meterCode	String	水表表号
factoryCode	String	出厂编码
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
meterStatusCode	String（枚举 code）	水表状态
inStockAttrCode	String（字典 code）	入库库存属性
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
brandModelId	Long	厂家型号ID，关联wssmet_brandmodel_w表的id字段
sealNo	String	铅封
userNo	String	用户
userName	String	用户
installAddress	String	安装地址
meterPosition	String	水表表位
firstVerifyDate	Date	首次检定日期
lastVerifyDate	Date	最近检定日期
nextVerifyDate	Date	下次检定日期
rotateDueDate	Date	轮换到期日期
purchasePlanId	Long	采购计划ID，关联wssmet_purplan_w表的id字段
manageOrgId	Long	管辖组织ID，关联tf_org表的id字段
remark	String	备注

水表查询-详情

项	内容
接口说明	按主键查询水表查询详情
请求地址	`GET /api/wm/ledger/meter/{id}`
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

ResultResponse

data（MeterVo）字段

MeterVo 字段

字段	类型	说明
id	String	主键
meterCode	String	水表表号
factoryCode	String	出厂编码
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
meterStatusCode	String（枚举 code）	水表状态
inStockAttrCode	String（字典 code）	入库库存属性
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
brandModelId	Long	厂家型号ID，关联wssmet_brandmodel_w表的id字段
sealNo	String	铅封
userNo	String	用户
userName	String	用户
installAddress	String	安装地址
meterPosition	String	水表表位
firstVerifyDate	Date	首次检定日期
lastVerifyDate	Date	最近检定日期
nextVerifyDate	Date	下次检定日期
rotateDueDate	Date	轮换到期日期
purchasePlanId	Long	采购计划ID，关联wssmet_purplan_w表的id字段
manageOrgId	Long	管辖组织ID，关联tf_org表的id字段
remark	String	备注

水表查询-导出

项	内容
接口说明	导出水表查询
请求地址	`GET /api/wm/ledger/meter/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
meterCode	String	水表表号
factoryCode	String	出厂编码
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
meterStatusCode	String（枚举 code）	水表状态
inStockAttrCode	String（字典 code）	入库库存属性编号
sealNo	String	铅封
userNo	String	用户
userName	String	用户
installAddress	String	安装地址
meterPosition	String	水表表位
firstVerifyDate	Date	首次检定日期
lastVerifyDate	Date	最近检定日期
nextVerifyDate	Date	下次检定日期
rotateDueDate	Date	轮换到期日期
remark	String	备注

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

采购台账-分页查询

项	内容
接口说明	分页查询采购台账
请求地址	`GET /api/wm/ledger/purchase/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
planCode	String	计划编号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
planQty	Integer	计划数量
contractNo	String	合同
purchaseDate	Date	采购日期
expectArriveDate	Date	到货日期
actualArriveDate	Date	实际到货日期
arriveStatusCode	String（枚举 code）	到货状态
remark	String	备注

出参

ResultResponse>

data（PageInfo）字段

PurchaseVo 字段

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

字段	类型	说明
id	String	主键
planCode	String	计划
applyId	Long	采购申请ID，关联wssmet_purapply_w表的id字段
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
planQty	Integer	计划数量
branchOrgId	Long	分公司组织ID，关联tf_org表的id字段
contractNo	String	合同
purchaseDate	Date	采购日期
expectArriveDate	Date	到货日期
actualArriveDate	Date	实际到货日期
arriveStatusCode	String（枚举 code）	到货状态
remark	String	备注

采购台账-列表查询

项	内容
接口说明	列表查询采购台账（不分页）
请求地址	`GET /api/wm/ledger/purchase/list`
请求类型	GET

入参（Query）

字段	类型	说明
planCode	String	计划编号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
planQty	Integer	计划数量
contractNo	String	合同
purchaseDate	Date	采购日期
expectArriveDate	Date	到货日期
actualArriveDate	Date	实际到货日期
arriveStatusCode	String（枚举 code）	到货状态
remark	String	备注

出参

ResultResponse>

data（List）元素字段

PurchaseVo 字段

字段	类型	说明
id	String	主键
planCode	String	计划
applyId	Long	采购申请ID，关联wssmet_purapply_w表的id字段
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
planQty	Integer	计划数量
branchOrgId	Long	分公司组织ID，关联tf_org表的id字段
contractNo	String	合同
purchaseDate	Date	采购日期
expectArriveDate	Date	到货日期
actualArriveDate	Date	实际到货日期
arriveStatusCode	String（枚举 code）	到货状态
remark	String	备注

采购台账-导出

项	内容
接口说明	导出采购台账
请求地址	`GET /api/wm/ledger/purchase/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
planCode	String	计划编号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
planQty	Integer	计划数量
contractNo	String	合同
purchaseDate	Date	采购日期
expectArriveDate	Date	到货日期
actualArriveDate	Date	实际到货日期
arriveStatusCode	String（枚举 code）	到货状态
remark	String	备注

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

检定台账-分页查询

项	内容
接口说明	分页查询检定台账
请求地址	`GET /api/wm/ledger/verify/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
meterCode	String	水表表号
verifyDate	Date	检定日期
verifyResultCode	String（枚举 code）	检定
sourceSystem	String	来源
verifyData	String	检定数据
verifyAttrCode	String（字典 code）	检定属性编号
refTableName	String	关联表
refBizCode	String	关联业务编号
recordStatusCode	String（枚举 code）	记录状态
voidReason	String	作废原因
syncTime	DateTime	同步时间

出参

ResultResponse>

data（PageInfo）字段

VerifyVo 字段

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

字段	类型	说明
id	String	主键
recordId	Long	记录
meterCode	String	水表表号
verifyDate	Date	检定日期
verifyResultCode	String（枚举 code）	检定结果
verifyUserId	Long	检定用户ID，关联tf_user表的id字段
sourceSystem	String	来源
verifyData	String	检定数据
verifyAttrCode	String（字典 code）	检定属性
refTableName	String	关联表
refTableId	Long	ref_tableID，关联（待补充）表的id字段
refBizCode	String	关联业务
recordStatusCode	String（枚举 code）	记录状态
voidReason	String	作废原因
syncTime	DateTime	同步时间

检定台账-列表查询

项	内容
接口说明	列表查询检定台账（不分页）
请求地址	`GET /api/wm/ledger/verify/list`
请求类型	GET

入参（Query）

字段	类型	说明
meterCode	String	水表表号
verifyDate	Date	检定日期
verifyResultCode	String（枚举 code）	检定
sourceSystem	String	来源
verifyData	String	检定数据
verifyAttrCode	String（字典 code）	检定属性编号
refTableName	String	关联表
refBizCode	String	关联业务编号
recordStatusCode	String（枚举 code）	记录状态
voidReason	String	作废原因
syncTime	DateTime	同步时间

出参

ResultResponse>

data（List）元素字段

VerifyVo 字段

字段	类型	说明
id	String	主键
recordId	Long	记录
meterCode	String	水表表号
verifyDate	Date	检定日期
verifyResultCode	String（枚举 code）	检定结果
verifyUserId	Long	检定用户ID，关联tf_user表的id字段
sourceSystem	String	来源
verifyData	String	检定数据
verifyAttrCode	String（字典 code）	检定属性
refTableName	String	关联表
refTableId	Long	ref_tableID，关联（待补充）表的id字段
refBizCode	String	关联业务
recordStatusCode	String（枚举 code）	记录状态
voidReason	String	作废原因
syncTime	DateTime	同步时间

检定台账-导出

项	内容
接口说明	导出检定台账
请求地址	`GET /api/wm/ledger/verify/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
meterCode	String	水表表号
verifyDate	Date	检定日期
verifyResultCode	String（枚举 code）	检定
sourceSystem	String	来源
verifyData	String	检定数据
verifyAttrCode	String（字典 code）	检定属性编号
refTableName	String	关联表
refBizCode	String	关联业务编号
recordStatusCode	String（枚举 code）	记录状态
voidReason	String	作废原因
syncTime	DateTime	同步时间

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

入库台账-分页查询

项	内容
接口说明	分页查询入库台账
请求地址	`GET /api/wm/ledger/inventoryIn/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
inCode	String	入库编号
inTypeCode	String（枚举 code）	入库类型
inDate	Date	入库日期
inStockAttrCode	String（字典 code）	入库库存属性编号
refTableName	String	关联表
refBizCode	String	关联业务编号
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出参

ResultResponse>

data（PageInfo）字段

InventoryInVo 字段

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

字段	类型	说明
id	String	主键
inCode	String	入库
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
inTypeCode	String（枚举 code）	入库类型
inDate	Date	入库日期
inStockAttrCode	String（字典 code）	入库库存属性
refTableName	String	关联表
refTableId	Long	ref_tableID，关联（待补充）表的id字段
refBizCode	String	关联业务
registrantId	Long	登记人ID，关联tf_user表的id字段
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

入库台账-列表查询

项	内容
接口说明	列表查询入库台账（不分页）
请求地址	`GET /api/wm/ledger/inventoryIn/list`
请求类型	GET

入参（Query）

字段	类型	说明
inCode	String	入库编号
inTypeCode	String（枚举 code）	入库类型
inDate	Date	入库日期
inStockAttrCode	String（字典 code）	入库库存属性编号
refTableName	String	关联表
refBizCode	String	关联业务编号
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出参

ResultResponse>

data（List）元素字段

InventoryInVo 字段

字段	类型	说明
id	String	主键
inCode	String	入库
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
inTypeCode	String（枚举 code）	入库类型
inDate	Date	入库日期
inStockAttrCode	String（字典 code）	入库库存属性
refTableName	String	关联表
refTableId	Long	ref_tableID，关联（待补充）表的id字段
refBizCode	String	关联业务
registrantId	Long	登记人ID，关联tf_user表的id字段
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

入库台账-导出

项	内容
接口说明	导出入库台账
请求地址	`GET /api/wm/ledger/inventoryIn/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
inCode	String	入库编号
inTypeCode	String（枚举 code）	入库类型
inDate	Date	入库日期
inStockAttrCode	String（字典 code）	入库库存属性编号
refTableName	String	关联表
refBizCode	String	关联业务编号
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

出库台账-分页查询

项	内容
接口说明	分页查询出库台账
请求地址	`GET /api/wm/ledger/inventoryOut/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
outCode	String	出库编号
outTypeCode	String（枚举 code）	出库类型
outDate	Date	出库日期
refTableName	String	关联表
refBizCode	String	关联业务编号
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出参

ResultResponse>

data（PageInfo）字段

InventoryOutVo 字段

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

字段	类型	说明
id	String	主键
outCode	String	出库
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
outTypeCode	String（枚举 code）	出库类型
outDate	Date	出库日期
refTableName	String	关联表
refTableId	Long	ref_tableID，关联（待补充）表的id字段
refBizCode	String	关联业务
registrantId	Long	登记人ID，关联tf_user表的id字段
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出库台账-列表查询

项	内容
接口说明	列表查询出库台账（不分页）
请求地址	`GET /api/wm/ledger/inventoryOut/list`
请求类型	GET

入参（Query）

字段	类型	说明
outCode	String	出库编号
outTypeCode	String（枚举 code）	出库类型
outDate	Date	出库日期
refTableName	String	关联表
refBizCode	String	关联业务编号
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出参

ResultResponse>

data（List）元素字段

InventoryOutVo 字段

字段	类型	说明
id	String	主键
outCode	String	出库
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
outTypeCode	String（枚举 code）	出库类型
outDate	Date	出库日期
refTableName	String	关联表
refTableId	Long	ref_tableID，关联（待补充）表的id字段
refBizCode	String	关联业务
registrantId	Long	登记人ID，关联tf_user表的id字段
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出库台账-导出

项	内容
接口说明	导出出库台账
请求地址	`GET /api/wm/ledger/inventoryOut/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
outCode	String	出库编号
outTypeCode	String（枚举 code）	出库类型
outDate	Date	出库日期
refTableName	String	关联表
refBizCode	String	关联业务编号
registrantName	String	登记人
statusCode	String（枚举 code）	状态
remark	String	备注

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

安装台账-分页查询

项	内容
接口说明	分页查询安装台账
请求地址	`GET /api/wm/ledger/install/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
taskStatusCode	String（枚举 code）	任务状态
remark	String	备注

出参

ResultResponse>

data（PageInfo）字段

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

项	内容
接口说明	列表查询安装台账（不分页）
请求地址	`GET /api/wm/ledger/install/list`
请求类型	GET

入参（Query）

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
taskStatusCode	String（枚举 code）	任务状态
remark	String	备注

出参

ResultResponse>

data（List）元素字段

项	内容
接口说明	导出安装台账
请求地址	`GET /api/wm/ledger/install/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
taskCode	String	任务编号
taskSourceCode	String（枚举 code）	任务来源
contractNo	String	合同
meterCode	String	水表表号
planUserNo	String	计划用户
installAddress	String	安装地址
taskStatusCode	String（枚举 code）	任务状态
remark	String	备注

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

换表台账-分页查询

项	内容
接口说明	分页查询换表台账
请求地址	`GET /api/wm/ledger/replace/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
taskCode	String	任务编号
replaceTypeCode	String（枚举 code）	换表类型
planUserNo	String	计划用户
taskStatusCode	String（枚举 code）	任务状态
oldMeterCollectStatusCode	String（枚举 code）	旧水表归集状态

出参

ResultResponse>

data（PageInfo）字段

ReplaceVo 字段

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

字段	类型	说明
id	String	主键
taskCode	String	任务
applyId	Long	换表申请ID，关联wssmet_replaceapply_w表的id字段
replaceTypeCode	String（枚举 code）	换表类型
planUserNo	String	计划用户
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
oldMeterCollectStatusCode	String（枚举 code）	旧水表归集状态

换表台账-列表查询

项	内容
接口说明	列表查询换表台账（不分页）
请求地址	`GET /api/wm/ledger/replace/list`
请求类型	GET

入参（Query）

字段	类型	说明
taskCode	String	任务编号
replaceTypeCode	String（枚举 code）	换表类型
planUserNo	String	计划用户
taskStatusCode	String（枚举 code）	任务状态
oldMeterCollectStatusCode	String（枚举 code）	旧水表归集状态

出参

ResultResponse>

data（List）元素字段

ReplaceVo 字段

字段	类型	说明
id	String	主键
taskCode	String	任务
applyId	Long	换表申请ID，关联wssmet_replaceapply_w表的id字段
replaceTypeCode	String（枚举 code）	换表类型
planUserNo	String	计划用户
executorId	Long	执行人ID，关联tf_user表的id字段
taskStatusCode	String（枚举 code）	任务状态
outRecordId	Long	出库主单ID，关联wssmet_invout_w表的id字段
oldMeterCollectStatusCode	String（枚举 code）	旧水表归集状态

换表台账-导出

项	内容
接口说明	导出换表台账
请求地址	`GET /api/wm/ledger/replace/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
taskCode	String	任务编号
replaceTypeCode	String（枚举 code）	换表类型
planUserNo	String	计划用户
taskStatusCode	String（枚举 code）	任务状态
oldMeterCollectStatusCode	String（枚举 code）	旧水表归集状态

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

周检台账-分页查询

项	内容
接口说明	分页查询周检台账
请求地址	`GET /api/wm/ledger/inspect/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>

data（PageInfo）字段

InspectVo 字段

字段	类型	说明
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/ledger/inspect/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>

data（List）元素字段

InspectVo 字段

字段	类型	说明
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/ledger/inspect/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
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（导出：响应体为文件流）

data 无业务字段（null）。

轮换台账-分页查询

项	内容
接口说明	分页查询轮换台账
请求地址	`GET /api/wm/ledger/rotate/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
taskCode	String	任务编号
taskName	String	任务
planFinishDate	Date	计划完成日期
meterQty	Integer	水表数量
finishedQty	Integer	数量
taskStatusCode	String（枚举 code）	任务状态
taskDesc	String	任务
creatorName	String	创建人
dispatchTime	DateTime	分派时间

出参

ResultResponse>

data（PageInfo）字段

RotateVo 字段

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

字段	类型	说明
id	String	主键
taskCode	String	任务
taskName	String	任务
orgId	Long	组织ID，关联tf_org表的id字段
executorId	Long	执行人ID，关联tf_user表的id字段
planFinishDate	Date	计划完成日期
meterQty	Integer	水表数量
finishedQty	Integer	数量
taskStatusCode	String（枚举 code）	任务状态
taskDesc	String	任务
creatorId	Long	创建人ID，关联tf_user表的id字段
creatorName	String	创建人
dispatchTime	DateTime	分派时间

轮换台账-列表查询

项	内容
接口说明	列表查询轮换台账（不分页）
请求地址	`GET /api/wm/ledger/rotate/list`
请求类型	GET

入参（Query）

字段	类型	说明
taskCode	String	任务编号
taskName	String	任务
planFinishDate	Date	计划完成日期
meterQty	Integer	水表数量
finishedQty	Integer	数量
taskStatusCode	String（枚举 code）	任务状态
taskDesc	String	任务
creatorName	String	创建人
dispatchTime	DateTime	分派时间

出参

ResultResponse>

data（List）元素字段

RotateVo 字段

字段	类型	说明
id	String	主键
taskCode	String	任务
taskName	String	任务
orgId	Long	组织ID，关联tf_org表的id字段
executorId	Long	执行人ID，关联tf_user表的id字段
planFinishDate	Date	计划完成日期
meterQty	Integer	水表数量
finishedQty	Integer	数量
taskStatusCode	String（枚举 code）	任务状态
taskDesc	String	任务
creatorId	Long	创建人ID，关联tf_user表的id字段
creatorName	String	创建人
dispatchTime	DateTime	分派时间

轮换台账-导出

项	内容
接口说明	导出轮换台账
请求地址	`GET /api/wm/ledger/rotate/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
taskCode	String	任务编号
taskName	String	任务
planFinishDate	Date	计划完成日期
meterQty	Integer	水表数量
finishedQty	Integer	数量
taskStatusCode	String（枚举 code）	任务状态
taskDesc	String	任务
creatorName	String	创建人
dispatchTime	DateTime	分派时间

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

报废台账-分页查询

项	内容
接口说明	分页查询报废台账
请求地址	`GET /api/wm/ledger/scrap/page`
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
registerCode	String	登记编号
scrapReasonCode	String（字典 code）	报废原因编号
registerStatusCode	String（枚举 code）	登记状态
sealTime	DateTime	铅封时间
sealUserName	String	铅封用户
disposeStatusCode	String（枚举 code）	处置状态
remark	String	备注
workOrderCode	String	工单编号（展示/台账查询）
approveStatus	String（枚举 code）	审批状态

出参

ResultResponse>

data（PageInfo）字段

ScrapVo 字段

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

字段	类型	说明
id	String	主键
registerCode	String	登记
applyId	Long	applyID，关联（待补充）表的id字段
scrapReasonCode	String（字典 code）	报废原因
registerStatusCode	String（枚举 code）	登记状态
sealTime	DateTime	铅封时间
sealUserId	Long	封签人ID，关联tf_user表的id字段
sealUserName	String	铅封用户
outRecordId	Long	out_recordID，关联（待补充）表的id字段
disposeStatusCode	String（枚举 code）	处置状态
remark	String	备注
processInstanceId	Long	workflow 流程实例ID（工单中心外挂，不落本地工单表）
workOrderCode	String	工单编号（展示/台账查询）
approveStatus	String（枚举 code）	审批状态

报废台账-列表查询

项	内容
接口说明	列表查询报废台账（不分页）
请求地址	`GET /api/wm/ledger/scrap/list`
请求类型	GET

入参（Query）

字段	类型	说明
registerCode	String	登记编号
scrapReasonCode	String（字典 code）	报废原因编号
registerStatusCode	String（枚举 code）	登记状态
sealTime	DateTime	铅封时间
sealUserName	String	铅封用户
disposeStatusCode	String（枚举 code）	处置状态
remark	String	备注
workOrderCode	String	工单编号（展示/台账查询）
approveStatus	String（枚举 code）	审批状态

出参

ResultResponse>

data（List）元素字段

ScrapVo 字段

字段	类型	说明
id	String	主键
registerCode	String	登记
applyId	Long	applyID，关联（待补充）表的id字段
scrapReasonCode	String（字典 code）	报废原因
registerStatusCode	String（枚举 code）	登记状态
sealTime	DateTime	铅封时间
sealUserId	Long	封签人ID，关联tf_user表的id字段
sealUserName	String	铅封用户
outRecordId	Long	out_recordID，关联（待补充）表的id字段
disposeStatusCode	String（枚举 code）	处置状态
remark	String	备注
processInstanceId	Long	workflow 流程实例ID（工单中心外挂，不落本地工单表）
workOrderCode	String	工单编号（展示/台账查询）
approveStatus	String（枚举 code）	审批状态

报废台账-导出

项	内容
接口说明	导出报废台账
请求地址	`GET /api/wm/ledger/scrap/export`
请求类型	GET

入参（Query（同 page））

字段	类型	说明
registerCode	String	登记编号
scrapReasonCode	String（字典 code）	报废原因编号
registerStatusCode	String（枚举 code）	登记状态
sealTime	DateTime	铅封时间
sealUserName	String	铅封用户
disposeStatusCode	String（枚举 code）	处置状态
remark	String	备注
workOrderCode	String	工单编号（展示/台账查询）
approveStatus	String（枚举 code）	审批状态

出参

ResultResponse（导出：响应体为文件流）

data 无业务字段（null）。

仪陇表务管理系统-PRD-04-功能需求说明-02-水表台账-V1.0.md 69 KB História Raw

水表台账

水表查询

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：水表查询

弹窗：水表资产详情

采购台账

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：采购台账

弹窗：采购台账详情

检定台账

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：检定台账

弹窗：检定台账详情

入库台账-总仓

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：入库台账-总仓

弹窗：入库台账-总仓详情

出库台账-总仓

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：出库台账-总仓

弹窗：出库台账-总仓详情

入库台账-分仓

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：入库台账-分仓

弹窗：入库台账-分仓详情

出库台账-分仓

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：出库台账-分仓

弹窗：出库台账-分仓详情

安装台账

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：安装台账

弹窗：安装台账详情

换表台账

功能描述

菜单权限

数据权限

核心逻辑

功能需求

一级页面：换表台账

弹窗：换表台账详情

周检台账

功能描述

菜单权限

数据权限

核心逻辑

功能需求

仪陇表务管理系统-PRD-04-功能需求说明-02-水表台账-V1.0.md 69 KB

História Raw