Startseite Erkunden Hilfe
Anmelden
zenghaiyang
/
ylsw-bw
1
0
Fork 0
Dateien Issues 0 Pull-Requests 0 Wiki
Struktur: 85a21dde45
Branches Tags
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-22-配置管理-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-22-配置管理-V1.0.md 36 KB
Verlauf Originalformat

源文件：仪陇表务管理系统-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）。