# 库房管理模块实施方案

## 1. 建设目标

本方案用于先把库房管理业务闭环走通，再进入前端页面、后端接口和 SQL 脚本开发。第一版建设范围包括：

1. 库房管理模块。
2. 库房对应库位管理。
3. 物料入库、出库、退库、移库、调拨等库存变动。
4. 物料盘点、盘盈、盘亏、差异确认。
5. 物料综合查询。
6. 物料正向查询和逆向查询：查物料在哪些库位，也查某个库位放置了哪些物料。

核心原则：真实库存必须落到具体库房、具体库位、具体物料，所有库存数量变化都必须通过业务单据和库存流水产生，不允许只修改结果表而不留变动记录。

## 2. 总体业务架构

### 2.1 主数据

库房管理依赖以下主数据：

| 主数据 | 说明 | 维护入口 |
| --- | --- | --- |
| 库房 | 仓储空间的一级单位，如一楼仓库、三楼仓库、外协暂存库 | 新增库房管理页面 |
| 库位 | 库房下的具体存放位置，如 A01-01、B02-03 | 新增或复用货位管理页面 |
| 物料 | 现有物料主文件，字段包含物料编码、物料名称、图号或型号、规格、单位等 | 现有物料维护 |
| 库存现存量 | 某物料在某库房、某库位的当前库存数量 | 由出入库、盘点、调拨自动维护 |
| 库存变动流水 | 每一次入库、出库、盘点、调拨产生的数量变化记录 | 由业务单据自动写入 |

### 2.2 单据数据

| 单据 | 说明 | 影响库存 |
| --- | --- | --- |
| 入库单 | 采购件、自制件、退料、其他入库 | 增加指定库位库存 |
| 出库单 | 领料、生产出库、销售出库、其他出库 | 减少指定库位库存 |
| 移库单 | 同库房或跨库房从一个库位移动到另一个库位 | 原库位减少，目标库位增加 |
| 盘点单 | 按库房、库位、物料生成盘点任务并录入实盘数量 | 差异确认后调整库存 |
| 库存调整单 | 非盘点场景的库存调整，需权限控制 | 按调整方向增减库存 |

## 3. 业务流程设计

### 3.1 库房与库位建档流程

1. 仓库主管新增库房，维护库房编号、库房名称、库房类型、负责人、启用状态。
2. 在库房下新增库位，维护库位编号、库位名称、库区、货架、层号、容量、是否允许混放、启用状态。
3. 系统校验同一库房下库位编号唯一。
4. 已发生库存业务的库位不允许物理删除，只允许停用。
5. 停用库位如果仍有库存，禁止停用或提示先完成移库。

### 3.2 入库流程

1. 用户选择入库来源：采购入库、自制件入库、退料入库、其他入库。
2. 系统带出物料、批次、供应商、订单或生产任务等来源信息。
3. 仓库人员选择实际上架库房和库位。
4. 系统校验库房、库位启用状态，校验数量大于 0。
5. 提交后写入入库单主表、入库单明细表。
6. 同一事务内更新库存现存量：
   - 如果该物料、批次、库位已存在库存记录，则累加库存数量。
   - 如果不存在，则新增库存现存量记录。
7. 写入库存变动流水，变动类型为“入库”，变动数量为正数。

### 3.3 出库流程

1. 用户选择出库来源：领料单、生产任务、销售发货、其他出库。
2. 系统按物料查询可用库存，展示该物料在哪些库房、库位有库存。
3. 仓库人员选择出库库位和出库数量。
4. 系统校验出库数量必须小于等于该库位可用库存。
5. 提交后写入出库单主表、出库单明细表。
6. 同一事务内扣减库存现存量。
7. 写入库存变动流水，变动类型为“出库”，变动数量为负数。
8. 如果库存扣减后为 0，保留库存现存量记录，便于追溯历史库位；查询时可默认过滤 0 库存。

### 3.4 移库和调拨流程

移库用于同一库房或不同库房之间调整物料位置。

1. 用户选择需要移动的物料库存记录。
2. 系统带出原库房、原库位、当前库存。
3. 用户选择目标库房、目标库位和移库数量。
4. 系统校验移库数量大于 0 且不超过原库位库存。
5. 提交后写入移库单主表、移库单明细表。
6. 同一事务内扣减原库位库存、增加目标库位库存。
7. 写入两条库存变动流水：
   - 原库位“移出”，数量为负数。
   - 目标库位“移入”，数量为正数。

### 3.5 盘点流程

1. 仓库主管创建盘点单，选择盘点库房、库位范围、物料范围。
2. 系统按当前库存现存量生成盘点明细，记录账面数量。
3. 盘点人员录入实盘数量，也可补录账面不存在但现场存在的物料和库位。
4. 系统计算差异数量：差异数量 = 实盘数量 - 账面数量。
5. 无差异明细可直接确认。
6. 有差异明细需要仓库主管确认差异原因。
7. 确认后生成库存调整：
   - 盘盈：增加库存。
   - 盘亏：减少库存。
8. 写入库存变动流水，变动类型为“盘盈”或“盘亏”。
9. 盘点单状态流转为：草稿、盘点中、待确认、已确认、已作废。

### 3.6 物料综合查询流程

物料综合查询用于按物料维度查看当前库存、库位分布和出入库历史。

查询条件：

| 条件 | 说明 |
| --- | --- |
| 物料编码 | 精确或模糊查询 |
| 物料名称 | 模糊查询 |
| 图号或型号 | 模糊查询 |
| 规格 | 模糊查询 |
| 库房 | 按库房过滤 |
| 库位 | 按库位过滤 |
| 是否只看有库存 | 默认是 |

返回内容：

| 信息 | 说明 |
| --- | --- |
| 物料基础信息 | 编码、名称、图号、规格、单位 |
| 总库存 | 该物料所有库位库存合计 |
| 主库位 | 库存数量最大的库位，用于快速定位 |
| 库位明细 | 每个库位的库存数量 |
| 最近入库 | 最近一次入库时间、数量、来源单号 |
| 最近出库 | 最近一次出库时间、数量、来源单号 |

### 3.7 正向查询和逆向查询

正向查询：物料在哪些库位。

1. 输入物料编码、物料名称、图号或型号。
2. 系统查询库存现存量表。
3. 返回该物料所有库存大于 0 的库房、库位、批次、库存数量。
4. 支持点击库位查看该库位其他物料。

逆向查询：某库位放置哪些物料。

1. 选择库房和库位。
2. 系统查询该库位所有库存大于 0 的物料。
3. 返回物料编码、物料名称、图号或型号、规格、批次、库存数量。
4. 支持点击物料反查该物料在其他库位的分布。

## 4. 表结构设计

以下为推荐新表或标准化表结构。若数据库中已有同名或相近表，应优先复用现有表，并通过新增字段、视图或存储过程兼容现有业务。

### 4.1 库房主表

表名：`仓储管理_库房主表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 库房流水号 | int identity | 是 | 主键 |
| 库房编号 | nvarchar(50) | 是 | 业务编号，唯一 |
| 库房名称 | nvarchar(100) | 是 | 库房名称 |
| 库房类型 | nvarchar(50) | 否 | 原料库、成品库、半成品库、暂存库等 |
| 地址 | nvarchar(200) | 否 | 库房位置 |
| 负责人流水号 | int | 否 | 对应人员表 |
| 负责人 | nvarchar(50) | 否 | 冗余显示 |
| 联系电话 | nvarchar(50) | 否 | 联系方式 |
| 是否启用 | bit | 是 | 默认 1 |
| 排序号 | int | 否 | 页面排序 |
| 备注 | nvarchar(500) | 否 | 备注 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 修改人 | int | 否 | UserID |
| 修改时间 | datetime | 否 | 修改时间 |

主键：`PK_仓储管理_库房主表`，字段 `库房流水号`。

唯一约束：`UK_仓储管理_库房主表_库房编号`，字段 `库房编号`。

### 4.2 库位主表

表名：`仓储管理_库位主表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 库位流水号 | int identity | 是 | 主键 |
| 库房流水号 | int | 是 | 外键，关联库房 |
| 库位编号 | nvarchar(50) | 是 | 同一库房下唯一 |
| 库位名称 | nvarchar(100) | 是 | 页面显示名称 |
| 库区 | nvarchar(50) | 否 | 如 A 区、B 区 |
| 货架 | nvarchar(50) | 否 | 货架编号 |
| 层号 | nvarchar(50) | 否 | 货架层号 |
| 容量 | decimal(18,4) | 否 | 可选容量 |
| 容量单位 | nvarchar(20) | 否 | 件、箱、kg 等 |
| 是否允许混放 | bit | 是 | 默认 1 |
| 是否启用 | bit | 是 | 默认 1 |
| 备注 | nvarchar(500) | 否 | 备注 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 修改人 | int | 否 | UserID |
| 修改时间 | datetime | 否 | 修改时间 |

主键：`PK_仓储管理_库位主表`，字段 `库位流水号`。

外键：`FK_仓储管理_库位主表_库房`，`库房流水号` 关联 `仓储管理_库房主表.库房流水号`。

唯一约束：`UK_仓储管理_库位主表_库房库位编号`，字段 `库房流水号、库位编号`。

### 4.3 库存现存量表

表名：`仓储管理_库存现存量`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 库存流水号 | bigint identity | 是 | 主键 |
| 物料流水号 | int | 是 | 关联物料主文件 |
| 物料编码 | nvarchar(100) | 否 | 冗余字段，便于查询 |
| 物料名称 | nvarchar(200) | 是 | 冗余字段 |
| 图号或型号 | nvarchar(200) | 否 | 冗余字段 |
| 规格 | nvarchar(200) | 否 | 冗余字段 |
| 单位 | nvarchar(50) | 否 | 冗余字段 |
| 库房流水号 | int | 是 | 外键，关联库房 |
| 库位流水号 | int | 是 | 外键，关联库位 |
| 批次编号 | nvarchar(100) | 否 | 有批次管理时必填 |
| 库存数量 | decimal(18,4) | 是 | 当前库存数量 |
| 冻结数量 | decimal(18,4) | 是 | 默认 0 |
| 可用数量 | AS | 否 | 建议计算列：库存数量 - 冻结数量 |
| 最后入库时间 | datetime | 否 | 最近入库时间 |
| 最后出库时间 | datetime | 否 | 最近出库时间 |
| 最后变动时间 | datetime | 是 | 最近库存变化时间 |
| 状态 | nvarchar(20) | 是 | 正常、冻结、停用 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 修改人 | int | 否 | UserID |
| 修改时间 | datetime | 否 | 修改时间 |

主键：`PK_仓储管理_库存现存量`，字段 `库存流水号`。

外键：

| 外键 | 字段 | 关联表 |
| --- | --- | --- |
| FK_仓储管理_库存现存量_库房 | 库房流水号 | 仓储管理_库房主表.库房流水号 |
| FK_仓储管理_库存现存量_库位 | 库位流水号 | 仓储管理_库位主表.库位流水号 |
| FK_仓储管理_库存现存量_物料 | 物料流水号 | 库存管理_物料主文件_基本.物料流水号 |

唯一约束：`UK_仓储管理_库存现存量_物料库位批次`，字段 `物料流水号、库位流水号、批次编号`。如果批次允许为空，需要在存储过程中统一把空批次处理为固定空值，避免 SQL Server 唯一约束对 NULL 的差异影响。

### 4.4 库存变动流水表

表名：`仓储管理_库存变动流水`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 库存变动流水号 | bigint identity | 是 | 主键 |
| 库存流水号 | bigint | 否 | 关联库存现存量 |
| 业务类型 | nvarchar(50) | 是 | 入库、出库、退库、移库、盘盈、盘亏、调整 |
| 业务单号 | nvarchar(100) | 否 | 入库单号、出库单号、盘点单号等 |
| 业务主表流水号 | bigint | 否 | 来源主表流水号 |
| 业务明细流水号 | bigint | 否 | 来源明细流水号 |
| 物料流水号 | int | 是 | 物料 |
| 物料编码 | nvarchar(100) | 否 | 冗余 |
| 物料名称 | nvarchar(200) | 是 | 冗余 |
| 图号或型号 | nvarchar(200) | 否 | 冗余 |
| 库房流水号 | int | 是 | 变动发生库房 |
| 库位流水号 | int | 是 | 变动发生库位 |
| 批次编号 | nvarchar(100) | 否 | 批次 |
| 变动前数量 | decimal(18,4) | 是 | 变动前库存 |
| 变动数量 | decimal(18,4) | 是 | 入库为正，出库为负 |
| 变动后数量 | decimal(18,4) | 是 | 变动后库存 |
| 对方库房流水号 | int | 否 | 移库时使用 |
| 对方库位流水号 | int | 否 | 移库时使用 |
| 操作人 | int | 是 | UserID |
| 操作时间 | datetime | 是 | 默认 GETDATE() |
| 备注 | nvarchar(500) | 否 | 备注 |

主键：`PK_仓储管理_库存变动流水`，字段 `库存变动流水号`。

索引：

| 索引 | 字段 | 用途 |
| --- | --- | --- |
| IX_库存变动流水_物料时间 | 物料流水号、操作时间 | 物料追溯 |
| IX_库存变动流水_库位时间 | 库位流水号、操作时间 | 库位追溯 |
| IX_库存变动流水_业务单据 | 业务类型、业务主表流水号、业务明细流水号 | 单据追溯 |

### 4.5 入库单主表

表名：`仓储管理_入库单主表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 入库单流水号 | bigint identity | 是 | 主键 |
| 入库单号 | nvarchar(100) | 是 | 业务单号 |
| 入库类型 | nvarchar(50) | 是 | 采购入库、自制件入库、退料入库、其他入库 |
| 来源单号 | nvarchar(100) | 否 | 采购合同、生产任务等 |
| 供应商 | nvarchar(200) | 否 | 采购入库时使用 |
| 入库人 | int | 是 | UserID |
| 入库日期 | datetime | 是 | 入库时间 |
| 状态 | nvarchar(20) | 是 | 草稿、已入库、已作废 |
| 备注 | nvarchar(500) | 否 | 备注 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 修改人 | int | 否 | UserID |
| 修改时间 | datetime | 否 | 修改时间 |

主键：`PK_仓储管理_入库单主表`。

唯一约束：`UK_仓储管理_入库单主表_入库单号`。

### 4.6 入库单明细表

表名：`仓储管理_入库单明细表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 入库明细流水号 | bigint identity | 是 | 主键 |
| 入库单流水号 | bigint | 是 | 外键，关联入库主表 |
| 物料流水号 | int | 是 | 物料 |
| 物料编码 | nvarchar(100) | 否 | 冗余 |
| 物料名称 | nvarchar(200) | 是 | 冗余 |
| 图号或型号 | nvarchar(200) | 否 | 冗余 |
| 规格 | nvarchar(200) | 否 | 冗余 |
| 单位 | nvarchar(50) | 否 | 冗余 |
| 库房流水号 | int | 是 | 入库库房 |
| 库位流水号 | int | 是 | 入库库位 |
| 批次编号 | nvarchar(100) | 否 | 批次 |
| 入库数量 | decimal(18,4) | 是 | 入库数量 |
| 来源明细流水号 | bigint | 否 | 来源明细 |
| 备注 | nvarchar(500) | 否 | 备注 |

主键：`PK_仓储管理_入库单明细表`。

外键：

| 外键 | 字段 | 关联表 |
| --- | --- | --- |
| FK_入库明细_主表 | 入库单流水号 | 仓储管理_入库单主表.入库单流水号 |
| FK_入库明细_库房 | 库房流水号 | 仓储管理_库房主表.库房流水号 |
| FK_入库明细_库位 | 库位流水号 | 仓储管理_库位主表.库位流水号 |

### 4.7 出库单主表

表名：`仓储管理_出库单主表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 出库单流水号 | bigint identity | 是 | 主键 |
| 出库单号 | nvarchar(100) | 是 | 业务单号 |
| 出库类型 | nvarchar(50) | 是 | 领料出库、生产出库、销售出库、其他出库 |
| 来源单号 | nvarchar(100) | 否 | 领料单、销售单等 |
| 领用部门 | nvarchar(100) | 否 | 领用部门 |
| 领用人 | nvarchar(100) | 否 | 领用人 |
| 出库人 | int | 是 | UserID |
| 出库日期 | datetime | 是 | 出库时间 |
| 状态 | nvarchar(20) | 是 | 草稿、已出库、已作废 |
| 备注 | nvarchar(500) | 否 | 备注 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 修改人 | int | 否 | UserID |
| 修改时间 | datetime | 否 | 修改时间 |

主键：`PK_仓储管理_出库单主表`。

唯一约束：`UK_仓储管理_出库单主表_出库单号`。

### 4.8 出库单明细表

表名：`仓储管理_出库单明细表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 出库明细流水号 | bigint identity | 是 | 主键 |
| 出库单流水号 | bigint | 是 | 外键，关联出库主表 |
| 物料流水号 | int | 是 | 物料 |
| 物料编码 | nvarchar(100) | 否 | 冗余 |
| 物料名称 | nvarchar(200) | 是 | 冗余 |
| 图号或型号 | nvarchar(200) | 否 | 冗余 |
| 规格 | nvarchar(200) | 否 | 冗余 |
| 单位 | nvarchar(50) | 否 | 冗余 |
| 库房流水号 | int | 是 | 出库库房 |
| 库位流水号 | int | 是 | 出库库位 |
| 批次编号 | nvarchar(100) | 否 | 批次 |
| 出库数量 | decimal(18,4) | 是 | 出库数量 |
| 来源明细流水号 | bigint | 否 | 来源明细 |
| 备注 | nvarchar(500) | 否 | 备注 |

主键：`PK_仓储管理_出库单明细表`。

外键：

| 外键 | 字段 | 关联表 |
| --- | --- | --- |
| FK_出库明细_主表 | 出库单流水号 | 仓储管理_出库单主表.出库单流水号 |
| FK_出库明细_库房 | 库房流水号 | 仓储管理_库房主表.库房流水号 |
| FK_出库明细_库位 | 库位流水号 | 仓储管理_库位主表.库位流水号 |

### 4.9 移库单主表

表名：`仓储管理_移库单主表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 移库单流水号 | bigint identity | 是 | 主键 |
| 移库单号 | nvarchar(100) | 是 | 业务单号 |
| 移库类型 | nvarchar(50) | 是 | 同库移位、跨库调拨 |
| 移库人 | int | 是 | UserID |
| 移库日期 | datetime | 是 | 移库时间 |
| 状态 | nvarchar(20) | 是 | 草稿、已移库、已作废 |
| 备注 | nvarchar(500) | 否 | 备注 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 修改人 | int | 否 | UserID |
| 修改时间 | datetime | 否 | 修改时间 |

### 4.10 移库单明细表

表名：`仓储管理_移库单明细表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 移库明细流水号 | bigint identity | 是 | 主键 |
| 移库单流水号 | bigint | 是 | 外键，关联移库主表 |
| 物料流水号 | int | 是 | 物料 |
| 批次编号 | nvarchar(100) | 否 | 批次 |
| 原库房流水号 | int | 是 | 原库房 |
| 原库位流水号 | int | 是 | 原库位 |
| 目标库房流水号 | int | 是 | 目标库房 |
| 目标库位流水号 | int | 是 | 目标库位 |
| 移库数量 | decimal(18,4) | 是 | 移库数量 |
| 备注 | nvarchar(500) | 否 | 备注 |

### 4.11 盘点单主表

表名：`仓储管理_盘点单主表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 盘点单流水号 | bigint identity | 是 | 主键 |
| 盘点单号 | nvarchar(100) | 是 | 业务单号 |
| 盘点名称 | nvarchar(200) | 是 | 盘点任务名称 |
| 盘点范围 | nvarchar(50) | 是 | 全库、库房、库位、物料 |
| 库房流水号 | int | 否 | 按库房盘点时使用 |
| 开始时间 | datetime | 否 | 开始时间 |
| 结束时间 | datetime | 否 | 结束时间 |
| 状态 | nvarchar(20) | 是 | 草稿、盘点中、待确认、已确认、已作废 |
| 创建人 | int | 是 | UserID |
| 创建时间 | datetime | 是 | 默认 GETDATE() |
| 确认人 | int | 否 | UserID |
| 确认时间 | datetime | 否 | 确认时间 |
| 备注 | nvarchar(500) | 否 | 备注 |

### 4.12 盘点单明细表

表名：`仓储管理_盘点单明细表`

| 字段名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| 盘点明细流水号 | bigint identity | 是 | 主键 |
| 盘点单流水号 | bigint | 是 | 外键，关联盘点主表 |
| 库存流水号 | bigint | 否 | 来源库存记录 |
| 物料流水号 | int | 是 | 物料 |
| 物料编码 | nvarchar(100) | 否 | 冗余 |
| 物料名称 | nvarchar(200) | 是 | 冗余 |
| 图号或型号 | nvarchar(200) | 否 | 冗余 |
| 库房流水号 | int | 是 | 库房 |
| 库位流水号 | int | 是 | 库位 |
| 批次编号 | nvarchar(100) | 否 | 批次 |
| 账面数量 | decimal(18,4) | 是 | 生成盘点时库存数量 |
| 实盘数量 | decimal(18,4) | 否 | 盘点录入数量 |
| 差异数量 | decimal(18,4) | 否 | 实盘 - 账面 |
| 差异原因 | nvarchar(500) | 否 | 差异说明 |
| 处理方式 | nvarchar(50) | 否 | 盘盈、盘亏、不调整 |
| 是否已确认 | bit | 是 | 默认 0 |
| 备注 | nvarchar(500) | 否 | 备注 |

## 5. 表关系设计

```mermaid
erDiagram
  仓储管理_库房主表 ||--o{ 仓储管理_库位主表 : 包含
  仓储管理_库房主表 ||--o{ 仓储管理_库存现存量 : 拥有
  仓储管理_库位主表 ||--o{ 仓储管理_库存现存量 : 存放
  库存管理_物料主文件_基本 ||--o{ 仓储管理_库存现存量 : 对应
  仓储管理_入库单主表 ||--o{ 仓储管理_入库单明细表 : 包含
  仓储管理_出库单主表 ||--o{ 仓储管理_出库单明细表 : 包含
  仓储管理_移库单主表 ||--o{ 仓储管理_移库单明细表 : 包含
  仓储管理_盘点单主表 ||--o{ 仓储管理_盘点单明细表 : 包含
  仓储管理_库存现存量 ||--o{ 仓储管理_库存变动流水 : 产生
```

关系说明：

| 关系 | 说明 |
| --- | --- |
| 一个库房有多个库位 | `仓储管理_库位主表.库房流水号` 指向库房 |
| 一个库位可放多个物料 | 通过 `仓储管理_库存现存量` 表体现 |
| 一个物料可在多个库位 | 通过 `仓储管理_库存现存量` 表体现 |
| 入库、出库、移库、盘点都写流水 | `仓储管理_库存变动流水` 记录库存变化来源 |
| 查询库存以现存量为准 | 综合查询不直接汇总单据，默认读取库存现存量 |
| 追溯库存以流水为准 | 查原因时读取库存变动流水和来源单据 |

## 6. 库存处理存储过程设计

### 6.1 公共库存增加过程

建议新增公共过程：`仓储管理_库存_增加`

入参：

| 参数 | 说明 |
| --- | --- |
| 物料流水号 | 物料 |
| 库房流水号 | 库房 |
| 库位流水号 | 库位 |
| 批次编号 | 批次 |
| 数量 | 增加数量 |
| 业务类型 | 入库、退料、盘盈、移入 |
| 业务单号 | 来源单号 |
| 业务主表流水号 | 来源主表 |
| 业务明细流水号 | 来源明细 |
| 操作人 | UserID |
| 备注 | 备注 |

处理规则：

1. 在事务内锁定 `仓储管理_库存现存量` 的对应物料、库位、批次记录。
2. 存在则更新 `库存数量 = 库存数量 + 数量`。
3. 不存在则新增库存记录。
4. 写入库存变动流水。
5. 返回库存流水号和变动后数量。

### 6.2 公共库存扣减过程

建议新增公共过程：`仓储管理_库存_扣减`

处理规则：

1. 在事务内锁定对应库存记录。
2. 校验库存记录存在。
3. 校验 `库存数量 - 冻结数量 >= 数量`。
4. 更新 `库存数量 = 库存数量 - 数量`。
5. 写入库存变动流水，`变动数量 = -数量`。
6. 返回库存流水号和变动后数量。

### 6.3 公共库存移库过程

建议新增公共过程：`仓储管理_库存_移库`

处理规则：

1. 开启事务。
2. 调用或复用扣减逻辑扣减原库位库存。
3. 调用或复用增加逻辑增加目标库位库存。
4. 写入移库单和移库明细。
5. 写入库存变动流水。
6. 提交事务。

注意：扣减和增加必须在同一个事务内完成，不能由前端拆成两个请求。

### 6.4 公共盘点确认过程

建议新增公共过程：`仓储管理_库存盘点_确认`

处理规则：

1. 校验盘点单状态为待确认。
2. 遍历盘点明细。
3. 差异数量为 0 的明细只标记确认。
4. 差异数量大于 0 的明细调用库存增加逻辑，业务类型为“盘盈”。
5. 差异数量小于 0 的明细调用库存扣减逻辑，业务类型为“盘亏”。
6. 明细全部处理完成后，盘点单状态改为已确认。

## 7. 前端页面设计

### 7.1 库房管理页面

建议路径：`src/views/WarehouseManagement/Warehouse/index.vue`

页面结构：

1. 搜索栏：库房编号、库房名称、库房类型、是否启用。
2. 表格：库房编号、库房名称、库房类型、地址、负责人、是否启用、备注。
3. 操作：新增、编辑、停用、查看库位。

接口名称建议：

| 操作 | name |
| --- | --- |
| 查询 | 仓储管理_库房_查询 |
| 新增 | 仓储管理_库房_增加 |
| 编辑 | 仓储管理_库房_编辑 |
| 停用 | 仓储管理_库房_停用 |

### 7.2 库位管理页面

建议优先复用或改造现有 `src/views/WarehouseManagement/LocationManagement`。

页面结构：

1. 搜索栏：库房、库区、库位编号、库位名称、是否启用。
2. 表格：库房名称、库位编号、库位名称、库区、货架、层号、容量、是否允许混放、是否启用。
3. 操作：新增、编辑、停用、查看物料。

接口名称建议：

| 操作 | name |
| --- | --- |
| 查询 | 仓储管理_库位_查询 |
| 新增 | 仓储管理_库位_增加 |
| 编辑 | 仓储管理_库位_编辑 |
| 停用 | 仓储管理_库位_停用 |
| 查询库位物料 | 仓储管理_库位_物料明细_查询 |

### 7.3 物料入库页面

建议优先兼容现有 `src/views/WarehouseManagement/PurchasePartsStorage`、`Inboundscanning`、`WarehousingRecord` 等入库入口。

页面要求：

1. 入库时必须选择库房和库位。
2. 优先显示该物料已有库存库位。
3. 没有已有库存库位时显示全部启用库位。
4. 提交时传入 `库房流水号`、`库位流水号`、`物料流水号`、`入库数量`。
5. 后端必须通过公共库存增加过程维护库存。

### 7.4 物料出库页面

建议路径可结合现有领料和出库页面，例如 `MaterialRequisition`、`OutboundDetails`。

页面要求：

1. 选择物料后展示该物料所有可用库存库位。
2. 用户选择具体库位和出库数量。
3. 页面校验数量，但最终以数据库事务校验为准。
4. 出库成功后刷新物料库位库存。

### 7.5 物料盘点页面

建议优先改造现有 `src/views/WarehouseManagement/InventoryCheck/index.vue`。

页面功能：

1. 创建盘点单。
2. 生成盘点明细。
3. 按库房、库位、物料录入实盘数量。
4. 显示账面数量、实盘数量、差异数量。
5. 差异确认后更新库存。
6. 支持导出盘点表。

### 7.6 物料综合查询页面

建议优先改造现有 `src/views/WarehouseManagement/InventoryQuery/index.vue`。

页面功能：

1. 主表按物料聚合显示总库存。
2. 主库位显示库存数量最大的库位。
3. 点击主库位弹出库位明细。
4. 点击物料编码弹出库存流水。
5. 支持正向查询和逆向查询切换。

## 8. 查询 SQL 设计思路

### 8.1 物料正向查询

```sql
SELECT
  k.物料流水号,
  k.物料编码,
  k.物料名称,
  k.图号或型号,
  k.规格,
  f.库房编号,
  f.库房名称,
  w.库位编号,
  w.库位名称,
  k.批次编号,
  k.库存数量,
  k.冻结数量,
  k.最后变动时间
FROM 仓储管理_库存现存量 k
LEFT JOIN 仓储管理_库房主表 f ON k.库房流水号 = f.库房流水号
LEFT JOIN 仓储管理_库位主表 w ON k.库位流水号 = w.库位流水号
WHERE ISNULL(k.库存数量, 0) > 0
  AND (@物料流水号 IS NULL OR k.物料流水号 = @物料流水号)
ORDER BY f.库房编号, w.库位编号;
```

### 8.2 库位逆向查询

```sql
SELECT
  f.库房编号,
  f.库房名称,
  w.库位编号,
  w.库位名称,
  k.物料流水号,
  k.物料编码,
  k.物料名称,
  k.图号或型号,
  k.规格,
  k.批次编号,
  k.库存数量,
  k.最后变动时间
FROM 仓储管理_库存现存量 k
LEFT JOIN 仓储管理_库房主表 f ON k.库房流水号 = f.库房流水号
LEFT JOIN 仓储管理_库位主表 w ON k.库位流水号 = w.库位流水号
WHERE ISNULL(k.库存数量, 0) > 0
  AND k.库位流水号 = @库位流水号
ORDER BY k.物料编码, k.物料名称;
```

### 8.3 物料综合查询

```sql
WITH 汇总 AS (
  SELECT
    物料流水号,
    MAX(物料编码) AS 物料编码,
    MAX(物料名称) AS 物料名称,
    MAX(图号或型号) AS 图号或型号,
    MAX(规格) AS 规格,
    SUM(ISNULL(库存数量, 0)) AS 总库存
  FROM 仓储管理_库存现存量
  WHERE ISNULL(库存数量, 0) > 0
  GROUP BY 物料流水号
),
主库位 AS (
  SELECT
    k.物料流水号,
    f.库房名称,
    w.库位名称,
    k.库存数量,
    ROW_NUMBER() OVER (
      PARTITION BY k.物料流水号
      ORDER BY ISNULL(k.库存数量, 0) DESC, k.库位流水号 ASC
    ) AS 排名
  FROM 仓储管理_库存现存量 k
  LEFT JOIN 仓储管理_库房主表 f ON k.库房流水号 = f.库房流水号
  LEFT JOIN 仓储管理_库位主表 w ON k.库位流水号 = w.库位流水号
  WHERE ISNULL(k.库存数量, 0) > 0
)
SELECT
  h.物料流水号,
  h.物料编码,
  h.物料名称,
  h.图号或型号,
  h.规格,
  h.总库存,
  z.库房名称 AS 主库房名称,
  z.库位名称 AS 主库位名称,
  z.库存数量 AS 主库位库存
FROM 汇总 h
LEFT JOIN 主库位 z ON h.物料流水号 = z.物料流水号 AND z.排名 = 1;
```

## 9. 实施步骤

### 9.1 第一阶段：数据库方案落地

1. 核对现有表：库房、货位、物料与货位对照、入库记录、出库记录、库存盘点。
2. 确认哪些表复用，哪些表新增。
3. 建立或补齐主外键关系。
4. 建立库存现存量唯一约束。
5. 建立库存变动流水表。
6. 编写公共库存增加、扣减、移库、盘点确认存储过程。
7. 在测试库 `ERPTOOL_JY_20250826Back` 编译并验证。

### 9.2 第二阶段：入库和出库闭环

1. 改造入库接口，提交时必须传库房和库位。
2. 入库接口调用公共库存增加过程。
3. 改造出库接口，出库时必须指定库存现存量或库位。
4. 出库接口调用公共库存扣减过程。
5. 验证同一物料多库位、多批次场景。

### 9.3 第三阶段：盘点闭环

1. 盘点页面支持生成盘点单。
2. 盘点明细记录账面数量。
3. 支持录入实盘数量和差异原因。
4. 确认盘点时调用盘点确认过程。
5. 验证盘盈、盘亏、无差异三类场景。

### 9.4 第四阶段：综合查询闭环

1. 新增物料综合查询接口。
2. 新增物料库位明细查询接口。
3. 新增库位物料明细查询接口。
4. 前端支持正向查询和逆向查询。
5. 前端支持点击主库位查看全部库位库存。
6. 前端支持点击物料查看库存变动流水。

### 9.5 第五阶段：历史数据整理

1. 从现有 `库存管理_物料与货位对照表` 或相近库存表迁移当前库存。
2. 迁移时必须保留物料、货位、库存数量、批次等关键字段。
3. 对没有库房归属的货位先补齐库房。
4. 对重复物料库位批次记录进行合并。
5. 迁移后核对物料总库存和原库存查询结果是否一致。
6. 历史 0 库存记录可暂不迁移，后续按盘点结果清理。

## 10. 验收标准

| 验收项 | 标准 |
| --- | --- |
| 库房管理 | 可新增、编辑、停用库房 |
| 库位管理 | 库位必须归属库房，同一库房库位编号不可重复 |
| 入库 | 入库后指定库位库存增加，并生成库存流水 |
| 出库 | 出库后指定库位库存减少，并生成库存流水 |
| 库存不足 | 出库、移库、盘亏时库存不足必须阻止提交 |
| 移库 | 原库位减少，目标库位增加，事务一致 |
| 盘点 | 差异确认后库存正确增减 |
| 正向查询 | 可查询某物料在哪些库位 |
| 逆向查询 | 可查询某库位有哪些物料 |
| 综合查询 | 总库存等于所有库位库存合计 |
| 追溯 | 每一次库存变化都能查到来源单据和操作人 |

## 11. 风险与控制

| 风险 | 控制措施 |
| --- | --- |
| 多人同时出库导致负库存 | 数据库事务内加锁并重新校验库存 |
| 前端拆分请求导致只扣不加 | 移库、盘点确认必须由后端单事务完成 |
| 历史库存和新库存表不一致 | 迁移前备份，迁移后做总量对账 |
| 库位停用后仍被选择 | 所有业务查询默认只返回启用库位 |
| 物料多库位导致扣错库存 | 出库必须指定库位或库存流水号 |
| 批次为空导致唯一约束失效 | 存储过程统一处理空批次 |

## 12. 推荐开发顺序

1. 先建立库房、库位、库存现存量、库存变动流水四张核心表。
2. 再做公共库存增加和扣减过程。
3. 再把入库和出库接入公共库存过程。
4. 再做移库和盘点。
5. 最后做综合查询、正向查询、逆向查询和报表优化。

这样做的原因是：只要库存现存量和库存变动流水先稳定，后续所有业务都只是围绕“增加、扣减、移动、调整”四类库存动作扩展，业务链路会更稳。

## 13. 后续开发对象清单

### 13.1 SQL 脚本

建议新增：

```text
sql/仓储管理_库房库位库存基础表.sql
sql/仓储管理_库存公共过程.sql
sql/仓储管理_入库出库接入库存.sql
sql/仓储管理_盘点流程.sql
sql/仓储管理_库存综合查询.sql
```

### 13.2 前端页面

建议新增或改造：

```text
src/views/WarehouseManagement/Warehouse/index.vue
src/views/WarehouseManagement/LocationManagement/index.vue
src/views/WarehouseManagement/InventoryQuery/index.vue
src/views/WarehouseManagement/InventoryCheck/index.vue
src/views/WarehouseManagement/PurchasePartsStorage/index.vue
src/views/WarehouseManagement/OutboundDetails/index.vue
```

### 13.3 后端接口名称

建议新增：

```text
仓储管理_库房_查询
仓储管理_库房_增加
仓储管理_库房_编辑
仓储管理_库房_停用
仓储管理_库位_查询
仓储管理_库位_增加
仓储管理_库位_编辑
仓储管理_库位_停用
仓储管理_库存_物料正向查询
仓储管理_库存_库位逆向查询
仓储管理_库存_综合查询
仓储管理_库存_变动流水_查询
仓储管理_库存盘点_创建
仓储管理_库存盘点_明细_查询
仓储管理_库存盘点_实盘_编辑
仓储管理_库存盘点_确认
```

修改人:Ld 修改时间:2026-07-28 15:37:19