> **源文件**：仪陇表务管理系统-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)  
> 接口约定：见本文 **§接口设计（研发）**、[仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)、[00-总体框架设计-V1.0.md](../../design/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](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*



---

## 接口设计（研发）

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

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

**data（PageInfo）字段**

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

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

**入参（Query）**

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

**出参**

- ResultResponse<List<WarehouseVo>>

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

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

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 仓库-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 水表厂家-分页查询

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

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

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

**出参**

- ResultResponse<PageInfo<BrandVo>>

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

**data（PageInfo）字段**

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

**`BrandVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| 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<List<BrandVo>>

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

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

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 水表厂家-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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

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

**data（PageInfo）字段**

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

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

**入参（Query）**

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

**出参**

- ResultResponse<List<BrandModelVo>>

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

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

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 水表型号-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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

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

**data（PageInfo）字段**

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

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

**入参（Query）**

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

**出参**

- ResultResponse<List<CycleRuleVo>>

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

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

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 周期规则-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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

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

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<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） | 状态 |
#### 库存预警规则-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询库存预警规则 |
| 请求地址 | `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<List<InventoryAlertRuleVo>>

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

**data（List<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） | 状态 |
#### 库存预警规则-详情

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

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §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<Long>

**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<Void>

**data** 无业务字段（null）。
#### 库存预警规则-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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