> **源文件**：仪陇表务管理系统-PRD-04-功能需求说明-02-水表台账-V1.0.docx
> **导出时间**：2026-05-26 10:34


**仪陇表务管理系统
产品需求说明书
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 统计报表子功能描述一致，不自行扩展未立项指标

---

## 详细设计（研发）

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

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

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

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

## 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](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*



---

## 接口设计（研发）

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

#### 水表查询-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询水表查询 |
| 请求地址 | `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<PageInfo<MeterVo>>

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

**data（PageInfo）字段**

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

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

**data（List<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/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

- ResultResponse<MeterVo>

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

**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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/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<List<PurchaseVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/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<List<VerifyVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/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<List<InventoryInVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/list` |
| 请求类型 | GET |

**入参（Query）**

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

**出参**

- ResultResponse<List<InventoryOutVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

> `LedgerVo` 字段见关联业务表或平台 workflow 约定。
#### 安装台账-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询安装台账（不分页） |
| 请求地址 | `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<List<LedgerVo>>

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

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

> `LedgerVo` 字段见关联业务表或平台 workflow 约定。
#### 安装台账-导出

| 项 | 内容 |
|----|------|
| 接口说明 | 导出安装台账 |
| 请求地址 | `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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/list` |
| 请求类型 | GET |

**入参（Query）**

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

**出参**

- ResultResponse<List<ReplaceVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/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<InspectVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/list` |
| 请求类型 | GET |

**入参（Query）**

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

**出参**

- ResultResponse<List<RotateVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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

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

**data（PageInfo）字段**

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

**`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/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<List<ScrapVo>>

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

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

**`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<Void>（导出：响应体为文件流）

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