zkxw/openspec/changes/production-material-inventory/specs/consumable-inventory/spec.md

ADDED Requirements

Requirement: Consumable inventory fields

系统 SHALL 在 biz_consumable 表上新增以下库存字段：

• stock_qty DECIMAL(18,4) NOT NULL DEFAULT 0 — 当前库存量
• warning_qty DECIMAL(18,4) NOT NULL DEFAULT 0 — 预警库存量
• status CHAR(1) NOT NULL DEFAULT '1' — 启用/停用状态（1=启用，0=停用）

后端 SQLAlchemy Model BizConsumable SHALL 同步新增对应字段。前端列表和表单 SHALL 展示这些字段。

Scenario: Existing consumables have zero stock after migration

• WHEN 数据库迁移完成，已有耗材记录存在
• THEN 所有已有耗材的 stock_qty 为 0，warning_qty 为 0，status 为 '1'

Scenario: Consumable list shows stock info

• WHEN 用户访问耗材管理列表
• THEN 列表显示当前库存量、预警库存量、状态列

Requirement: Manual stock-in for consumable

系统 SHALL 支持对单个耗材进行手动入库操作。入库数量必须大于 0。入库后 stock_qty 增加，同时生成一条变动记录（source_type=manual_in，change_type=in）。

Scenario: Successful stock-in

• WHEN 用户对库存为 10 的耗材入库 5
• THEN 耗材 stock_qty 变为 15，生成变动记录 change_qty=5, stock_after=15, source_type=manual_in

Scenario: Stock-in with disabled consumable

• WHEN 用户对已停用的耗材执行入库
• THEN 系统拒绝并提示"物料「XX」已停用，无法入库"

Requirement: Manual stock-out for consumable

系统 SHALL 支持对单个耗材进行手动出库操作。出库数量必须大于 0，且不能超过当前库存。出库必须填写领用人。出库后 stock_qty 减少，同时生成一条变动记录（source_type=manual_out，change_type=use，change_qty 为负数）。

Scenario: Successful stock-out

• WHEN 用户对库存为 10 的耗材出库 3，领用人为"张三"
• THEN 耗材 stock_qty 变为 7，生成变动记录 change_qty=-3, stock_after=7, source_type=manual_out, receiver=张三

Scenario: Stock-out exceeds inventory

• WHEN 用户对库存为 2 的耗材出库 5
• THEN 系统拒绝并提示"物料「XX」库存不足，当前库存 2，需出库 5"

Scenario: Stock-out without receiver

• WHEN 用户出库时不填写领用人
• THEN 系统拒绝并提示"请选择领用人"

Requirement: Batch stock-in for consumables

系统 SHALL 支持对多个耗材批量入库。所有条目在同一事务内处理，任一条目失败则全部回滚。每条入库记录独立生成变动记录。

Scenario: Successful batch stock-in

• WHEN 用户批量入库 3 种耗材，数量分别为 5、10、2
• THEN 3 种耗材库存分别增加，生成 3 条变动记录，全部在同一事务内

Scenario: Batch stock-in with one invalid item

• WHEN 用户批量入库 3 种耗材，其中一种已停用
• THEN 全部回滚，没有任何耗材库存变化

Requirement: Batch stock-out for consumables

系统 SHALL 支持对多个耗材批量出库。批量出库需统一填写领用人和用途。所有条目在同一事务内处理，任一条目失败则全部回滚。

Scenario: Successful batch stock-out

• WHEN 用户批量出库 3 种耗材，领用人"张三"，数量分别为 2、1、3
• THEN 3 种耗材库存分别减少，生成 3 条变动记录（source_type=manual_out）

Scenario: Batch stock-out with insufficient stock

• WHEN 用户批量出库 3 种耗材，其中一种库存不足
• THEN 全部回滚，提示具体哪个物料库存不足

Requirement: Delete protection for stocked consumable

系统 SHALL 禁止删除库存量大于 0 的耗材。

Scenario: Delete consumable with stock

• WHEN 用户尝试删除库存为 5 的耗材
• THEN 系统拒绝并提示"该物料仍有库存，无法删除"

Scenario: Delete consumable with zero stock

• WHEN 用户删除库存为 0 的耗材
• THEN 软删除成功（del_flag=1）

Requirement: Consumable stock-out disabled status check

出库和入库操作 SHALL 检查物料状态，已停用物料不允许出入库。

Scenario: Stock-out with disabled status

• WHEN 用户对 status='0' 的耗材执行出库
• THEN 系统拒绝并提示"物料「XX」已停用，无法出库"

Requirement: Row-level locking for concurrent stock operations

出入库操作 SHALL 使用 with_for_update() 行锁，防止并发操作导致库存数据不一致。

Scenario: Concurrent stock-in

• WHEN 两个用户同时对同一耗材入库
• THEN 行锁保证两次操作串行执行，库存结果正确

Requirement: Consumable stock log table

系统 SHALL 新建 biz_consumable_stock_log 变动记录表，字段参照 biz_material_stock_log 并增加生产溯源字段：

• material_id — 耗材 ID
• material_code / material_name — 快照字段
• change_type — in(入库) / use(使用/出库)
• change_qty — 变动数量（入库正数，出库负数）
• stock_before — 变动前库存
• stock_after — 变动后库存
• source_type — manual_in / manual_out / step_save
• step_id / task_id / task_no — 步骤溯源字段（step_save 时有值）
• receiver / purpose — 领用人/用途（manual_out 时有值）
• 公共字段

Scenario: Stock log created on stock-in

• WHEN 耗材入库 5
• THEN 变动记录 change_type=in, change_qty=5, source_type=manual_in, stock_before=旧库存, stock_after=新库存