ylsw-bw/business/water-meter/doc/demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-22-配置管理-V1.0.md

源文件：仪陇表务管理系统-PRD-04-功能需求说明-22-配置管理-V1.0.docx 导出时间：2026-05-26 10:34

仪陇表务管理系统 产品需求说明书 04-功能需求说明 配置管理

文档版本：V1.0

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

模块序号：22

模块名称：配置管理

配置管理

本模块维护仓库、厂家型号、周期策略及库存预警等全局基础参数，对应《PRD-01》配置管理能力。含 Web 菜单：仓库管理、库存预警设置（暂不开发）、周期设置、厂家管理。变更即时生效并影响后续业务。

仓库管理

功能描述

维护总仓与分仓基础信息。仓库类型包含总仓、分仓，为出入库、领取、调拨等业务提供仓储基础数据。

菜单权限

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

数据权限

表务系统管理员：可见、可操作全公司范围内仓库配置数据。

表务水表管理中心、表务总公司管理人员：可见、可操作全公司范围内仓库配置数据。

表务分公司管理人员：可见、可操作本分公司及下属营业办、供水站、仓库范围内的分仓配置数据。

核心逻辑

以仓库档案为管理主体；停用仓库不参与新业务引用，历史数据保留。

功能需求

一级页面：仓库管理

#整体布局

-- 上下结构：查询条件 + 仓库列表；顶部「新建仓库」

#查询条件

-- 仓库名称：文本，模糊搜索

-- 仓库类型：下拉（全部、总仓、分仓）

-- 所属机构：组织树 / 下拉选择

-- 状态：下拉（全部、启用、停用）

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

#数据列表

-- 表格字段：仓库名称、仓库类型、所属机构、地址、状态、更新时间

-- 行内操作：编辑、停用/启用、详情

#交互说明

-- 新建 / 编辑打开「弹窗：新建/编辑仓库」

-- 已有关联业务数据的仓库不可物理删除，仅可停用

弹窗：新建/编辑仓库

#弹窗类型

-- 居中弹窗；遮罩：有

#信息展示

-- 仓库名称：必填，文本

-- 仓库类型：必填，单选（总仓、分仓）

-- 所属机构：必填，组织选择（分仓须选分公司及下属机构）

-- 地址：选填，文本

-- 状态：必填，启用 / 停用

-- 备注：选填

#底部按钮

-- 保存；取消

#交互说明

-- 保存后刷新列表；总仓仅允许一条启用记录（若业务规则限制则在保存时校验提示）

弹窗：仓库详情

#弹窗类型

-- 抽屉弹窗（右侧）；只读

#信息展示

-- 展示仓库全部基础字段

#底部按钮

-- 关闭；编辑（有权限时）

库存预警设置（暂不开发）

功能描述

配置总仓及分仓水表库存上下限预警规则，驱动低库存 / 超储预警清单与消息提醒。本期暂不开发，保留菜单占位。

菜单权限

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

数据权限

本期菜单可见角色同上；页面无业务数据操作权限。

核心逻辑

本期不实现规则维护与自动预警生成；后续版本按 01 子功能描述落地。

功能需求

一级页面：库存预警设置

#整体布局

-- 本期暂不开发：页面展示「功能建设中」占位，不提供规则维护与预警清单入口（与原始 PRD 标注一致）。

#交互说明

-- 菜单保留用于后续版本；启用后按《PRD-01》子功能描述补充规则配置与预警清单能力。

周期设置

功能描述

配置水表检定、轮换、报废等全局周期参数，按口径、类型差异化维护，支撑到期检定提醒、轮换提醒及报废预警自动触发。

菜单权限

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

数据权限

表务系统管理员、表务水表管理中心、表务总公司管理人员：可见、可操作全公司范围内周期规则配置数据。

其他角色：不可见本菜单（无菜单权限）。

核心逻辑

以周期规则为配置主体；系统按规则及水表最近业务时间每日计算预警与待办清单。

功能需求

一级页面：周期设置

#整体布局

-- 查询条件 + 周期规则列表；顶部「新建规则」

#查询条件

-- 规则类型：下拉（全部、检定周期、轮换周期、报废周期）

-- 水表口径：下拉

-- 水表类型：下拉

-- 状态：启用 / 停用

#数据列表

-- 表格字段：规则类型、水表口径、水表类型、周期值、提前预警月数、状态、更新时间

-- 行内操作：编辑、停用/启用

#交互说明

-- 规则变更即时生效；驱动到期检定提醒、轮换提醒、报废预警等任务生成

弹窗：新建/编辑周期规则

#弹窗类型

-- 居中弹窗

#信息展示

-- 规则类型：必填，单选（检定周期、轮换周期、报废周期）

-- 水表口径：必填，下拉

-- 水表类型：必填，下拉

-- 周期值：必填，正整数，单位年（检定 / 轮换 / 报废周期）

-- 提前预警月数：必填，非负整数（如报废周期 6 年、提前 6 个月预警）

-- 状态：启用 / 停用

-- 备注：选填

#底部按钮

-- 保存；取消

厂家管理

功能描述

用于管理厂家以及该厂家下的水表型号，为采购与资产溯源提供基础数据。

菜单权限

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

数据权限

表务系统管理员、表务水表管理中心、表务总公司管理人员：可见、可操作全公司范围内厂家及型号档案数据。

其他角色：不可见本菜单。

核心逻辑

以厂家档案为左侧主体，型号为从属数据；变更影响后续采购、台账录入时的可选范围。

功能需求

一级页面：厂家管理

#整体布局

-- 左右结构：左侧厂家列表，右侧型号列表；顶部「新建厂家」

#左侧面板

-- 面板类型：普通列表

-- 列表项：厂家名称、状态

-- 默认选中：第一条启用厂家

-- 选中联动：右侧加载该厂家下水表型号列表

#数据列表

-- 右侧表格标题：水表型号列表

-- 表格字段：型号名称、水表口径、水表类型、规格说明、状态

-- 行内操作：编辑型号、停用；厂家区：编辑厂家、新建型号

#交互说明

-- 厂家与型号为父子关系；型号被采购 / 台账引用后不可删除，仅可停用

弹窗：新建/编辑厂家

#弹窗类型

-- 居中弹窗

#信息展示

-- 厂家名称：必填；联系人：选填；联系电话：选填；状态：启用/停用；备注：选填

#底部按钮

-- 保存；取消

弹窗：新建/编辑水表型号

#弹窗类型

-- 居中弹窗

#信息展示

-- 所属厂家：只读，取左侧选中厂家

-- 型号名称：必填；水表口径：必填；水表类型：必填；规格说明：选填；状态：启用/停用

#底部按钮

-- 保存；取消

---

详细设计（研发）

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

仪陇表务-功能设计-22-配置管理-V1.0

# 仪陇表务 — 功能设计 22 配置管理 V1.0

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

1. 模块概述

项	说明
模块序号	22
模块名称	配置管理
后端包（建议）	com.tofly.wm.manage.config
业务模式	主数据 CRUD
工单	无

2. 功能范围

• 仓库管理
• 厂家管理
• 周期设置
• 库存预警(占位)

3. 数据模型

3.1 涉及表

• wssmet_warehouse_w
• wssmet_meterbrand_w
• wssmet_brandmodel_w
• wssmet_cyclerule_w
• wssmet_invalert_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. 核心业务规则

• 库存预警暂不开发

6. 接口设计（概要）

方法	路径（示例前缀）	说明
—	/warehouse/	见 PRD 界面
—	/brand/	见 PRD 界面
—	/cycleRule/	见 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/config；各接口 出参 须为具体泛型（见下文，禁止 T/Vo 占位）；公共约定见 仪陇表务-公共接口说明-V1.0.md。

仓库-分页查询

项	内容
接口说明	分页查询仓库
请求地址	GET /api/wm/manage/config/warehouse/page
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse>

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

data（PageInfo）字段

WarehouseVo 字段

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

字段	类型	说明
id	String	主键
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
orgId	Long	组织ID，关联tf_org表的id字段
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

仓库-列表查询

项	内容
接口说明	列表查询仓库
请求地址	GET /api/wm/manage/config/warehouse/list
请求类型	GET

入参（Query）

字段	类型	说明
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse>

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

data（List）元素字段

WarehouseVo 字段

字段	类型	说明
id	String	主键
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
orgId	Long	组织ID，关联tf_org表的id字段
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

仓库-详情

项	内容
接口说明	查询仓库详情
请求地址	GET /api/wm/manage/config/warehouse/{id}
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

• ResultResponse（含明细 list 若适用）

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

data（WarehouseVo）字段

WarehouseVo 字段

字段	类型	说明
id	String	主键
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
orgId	Long	组织ID，关联tf_org表的id字段
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

仓库-新增

项	内容
接口说明	新增仓库
请求地址	POST /api/wm/manage/config/warehouse/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
orgId	Long	组织ID，关联tf_org表的id字段
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse

data 字段

字段	类型	说明
id	Long	新增记录主键

仓库-修改

项	内容
接口说明	修改仓库
请求地址	POST /api/wm/manage/config/warehouse/update
请求类型	POST

入参（Body: Dto（含 id））

字段	类型	说明
warehouseName	String	仓库
warehouseTypeCode	String（枚举 code）	仓库类型
orgId	Long	组织ID，关联tf_org表的id字段
address	String	地址
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse

data 无业务字段（null）。

仓库-删除

项	内容
接口说明	逻辑删除仓库（支持批量）
请求地址	DELETE /api/wm/manage/config/warehouse/deleteByIds?ids=1,2
请求类型	DELETE

入参（Query: ids）

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

出参

• ResultResponse

data 无业务字段（null）。

水表厂家-分页查询

项	内容
接口说明	分页查询水表厂家
请求地址	GET /api/wm/manage/config/brand/page
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse>

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

data（PageInfo）字段

BrandVo 字段

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

字段	类型	说明
id	String	主键
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

水表厂家-列表查询

项	内容
接口说明	列表查询水表厂家
请求地址	GET /api/wm/manage/config/brand/list
请求类型	GET

入参（Query）

字段	类型	说明
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse>

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

data（List）元素字段

BrandVo 字段

字段	类型	说明
id	String	主键
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

水表厂家-详情

项	内容
接口说明	查询水表厂家详情
请求地址	GET /api/wm/manage/config/brand/{id}
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

• ResultResponse（含明细 list 若适用）

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

data（BrandVo）字段

BrandVo 字段

字段	类型	说明
id	String	主键
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

水表厂家-新增

项	内容
接口说明	新增水表厂家
请求地址	POST /api/wm/manage/config/brand/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse

data 字段

字段	类型	说明
id	Long	新增记录主键

水表厂家-修改

项	内容
接口说明	修改水表厂家
请求地址	POST /api/wm/manage/config/brand/update
请求类型	POST

入参（Body: Dto（含 id））

字段	类型	说明
brandName	String	厂家
contact	String	联系人
phone	String	联系电话
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse

data 无业务字段（null）。

水表厂家-删除

项	内容
接口说明	逻辑删除水表厂家（支持批量）
请求地址	DELETE /api/wm/manage/config/brand/deleteByIds?ids=1,2
请求类型	DELETE

入参（Query: ids）

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

出参

• ResultResponse

data 无业务字段（null）。

水表型号-分页查询

项	内容
接口说明	分页查询水表型号
请求地址	GET /api/wm/manage/config/brandModel/page
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
modelName	String	型号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
specDesc	String	规格
statusCode	String（枚举 code）	状态

出参

• ResultResponse>

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

data（PageInfo）字段

BrandModelVo 字段

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

字段	类型	说明
id	String	主键
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
modelName	String	型号
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
specDesc	String	规格
statusCode	String（枚举 code）	状态

水表型号-列表查询

项	内容
接口说明	列表查询水表型号
请求地址	GET /api/wm/manage/config/brandModel/list
请求类型	GET

入参（Query）

字段	类型	说明
modelName	String	型号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
specDesc	String	规格
statusCode	String（枚举 code）	状态

出参

• ResultResponse>

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

data（List）元素字段

BrandModelVo 字段

字段	类型	说明
id	String	主键
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
modelName	String	型号
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
specDesc	String	规格
statusCode	String（枚举 code）	状态

水表型号-详情

项	内容
接口说明	查询水表型号详情
请求地址	GET /api/wm/manage/config/brandModel/{id}
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

• ResultResponse（含明细 list 若适用）

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

data（BrandModelVo）字段

BrandModelVo 字段

字段	类型	说明
id	String	主键
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
modelName	String	型号
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
specDesc	String	规格
statusCode	String（枚举 code）	状态

水表型号-新增

项	内容
接口说明	新增水表型号
请求地址	POST /api/wm/manage/config/brandModel/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
modelName	String	型号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
specDesc	String	规格
statusCode	String（枚举 code）	状态

出参

• ResultResponse

data 字段

字段	类型	说明
id	Long	新增记录主键

水表型号-修改

项	内容
接口说明	修改水表型号
请求地址	POST /api/wm/manage/config/brandModel/update
请求类型	POST

入参（Body: Dto（含 id））

字段	类型	说明
brandId	Long	厂家ID，关联wssmet_meterbrand_w表的id字段
modelName	String	型号
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
specDesc	String	规格
statusCode	String（枚举 code）	状态

出参

• ResultResponse

data 无业务字段（null）。

水表型号-删除

项	内容
接口说明	逻辑删除水表型号（支持批量）
请求地址	DELETE /api/wm/manage/config/brandModel/deleteByIds?ids=1,2
请求类型	DELETE

入参（Query: ids）

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

出参

• ResultResponse

data 无业务字段（null）。

周期规则-分页查询

项	内容
接口说明	分页查询周期规则
请求地址	GET /api/wm/manage/config/cycleRule/page
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse>

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

data（PageInfo）字段

CycleRuleVo 字段

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

字段	类型	说明
id	String	主键
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

周期规则-列表查询

项	内容
接口说明	列表查询周期规则
请求地址	GET /api/wm/manage/config/cycleRule/list
请求类型	GET

入参（Query）

字段	类型	说明
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse>

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

data（List）元素字段

CycleRuleVo 字段

字段	类型	说明
id	String	主键
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

周期规则-详情

项	内容
接口说明	查询周期规则详情
请求地址	GET /api/wm/manage/config/cycleRule/{id}
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

• ResultResponse（含明细 list 若适用）

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

data（CycleRuleVo）字段

CycleRuleVo 字段

字段	类型	说明
id	String	主键
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

周期规则-新增

项	内容
接口说明	新增周期规则
请求地址	POST /api/wm/manage/config/cycleRule/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse

data 字段

字段	类型	说明
id	Long	新增记录主键

周期规则-修改

项	内容
接口说明	修改周期规则
请求地址	POST /api/wm/manage/config/cycleRule/update
请求类型	POST

入参（Body: Dto（含 id））

字段	类型	说明
ruleTypeCode	String（枚举 code）	规则类型
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
cycleYears	String	周期
warnMonthsAhead	String	预警
statusCode	String（枚举 code）	状态
remark	String	备注

出参

• ResultResponse

data 无业务字段（null）。

周期规则-删除

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

入参（Query: ids）

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

出参

• ResultResponse

data 无业务字段（null）。

库存预警规则-分页查询

项	内容
接口说明	分页查询库存预警规则
请求地址	GET /api/wm/manage/config/inventoryAlertRule/page
请求类型	GET

入参（Query（PageQuery））

字段	类型	说明
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
inStockAttrCode	String（字典 code）	入库库存属性编号
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

出参

• ResultResponse>

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

data（PageInfo）字段

InventoryAlertRuleVo 字段

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

字段	类型	说明
id	String	主键
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
inStockAttrCode	String（字典 code）	入库库存属性
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

库存预警规则-列表查询

项	内容
接口说明	列表查询库存预警规则
请求地址	GET /api/wm/manage/config/inventoryAlertRule/list
请求类型	GET

入参（Query）

字段	类型	说明
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
inStockAttrCode	String（字典 code）	入库库存属性编号
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

出参

• ResultResponse>

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

data（List）元素字段

InventoryAlertRuleVo 字段

字段	类型	说明
id	String	主键
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
inStockAttrCode	String（字典 code）	入库库存属性
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

库存预警规则-详情

项	内容
接口说明	查询库存预警规则详情
请求地址	GET /api/wm/manage/config/inventoryAlertRule/{id}
请求类型	GET

入参（Path: id）

字段	类型	说明
id	String	主键

出参

• ResultResponse（含明细 list 若适用）

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

data（InventoryAlertRuleVo）字段

InventoryAlertRuleVo 字段

字段	类型	说明
id	String	主键
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
caliberCode	String（字典 code）	口径
meterTypeCode	String（字典 code）	水表类型
inStockAttrCode	String（字典 code）	入库库存属性
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

库存预警规则-新增

项	内容
接口说明	新增库存预警规则
请求地址	POST /api/wm/manage/config/inventoryAlertRule/
请求类型	POST

入参（Body: Dto）

字段	类型	说明
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
inStockAttrCode	String（字典 code）	入库库存属性编号
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

出参

• ResultResponse

data 字段

字段	类型	说明
id	Long	新增记录主键

库存预警规则-修改

项	内容
接口说明	修改库存预警规则
请求地址	POST /api/wm/manage/config/inventoryAlertRule/update
请求类型	POST

入参（Body: Dto（含 id））

字段	类型	说明
warehouseId	Long	仓库ID，关联wssmet_warehouse_w表的id字段
caliberCode	String（字典 code）	口径编号
meterTypeCode	String（字典 code）	水表类型编号
inStockAttrCode	String（字典 code）	入库库存属性编号
minQty	Integer	下限数量
maxQty	Integer	上限数量
warnLeadDays	String	预警提前
notifyUsers	String	通知
statusCode	String（枚举 code）	状态

出参

• ResultResponse

data 无业务字段（null）。

库存预警规则-删除

项	内容
接口说明	逻辑删除库存预警规则（支持批量）
请求地址	DELETE /api/wm/manage/config/inventoryAlertRule/deleteByIds?ids=1,2
请求类型	DELETE

入参（Query: ids）

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

出参

• ResultResponse

data 无业务字段（null）。