# Inventory Statistics (盘存统计)

## ADDED Requirements

### Requirement: 库存统计口径

系统 SHALL 以归档完成的单据为准进行库存统计。

#### Scenario: 统计范围
- **WHEN** 系统计算库存数据
- **THEN** 系统 SHALL 仅统计归档完成的入库单和出库单
- **AND** 系统 SHALL 排除草稿、审批中、执行中的单据
- **AND** 系统 SHALL 排除已取消的单据

#### Scenario: 直销单排除
- **WHEN** 系统计算库存
- **THEN** 系统 SHALL 排除直销单类型
- **AND** 直销单 SHALL NOT 影响库存数量

---

### Requirement: 库存台账

系统 SHALL 支持按产品汇总当前库存量和库存金额。

#### Scenario: 库存台账展示
- **WHEN** 用户访问库存台账
- **THEN** 系统 SHALL 按产品显示：
  - 产品名称
  - 产品编号
  - 当前库存数量
  - 库存单位
  - 库存金额（使用入库时的实际价格，每批单独计算）

#### Scenario: 库存金额计算
- **WHEN** 系统计算库存金额
- **THEN** 系统 SHALL 使用入库时的实际价格
- **AND** 系统 SHALL NOT 使用加权平均
- **AND** 每批入库 SHALL 单独计算金额

---

### Requirement: 出入库明细

系统 SHALL 支持按时间范围列出所有入库/出库记录。

#### Scenario: 出入库明细查询
- **WHEN** 用户设置时间范围
- **THEN** 系统 SHALL 显示该范围内的所有入库记录
- **AND** 系统 SHALL 显示该范围内的所有出库记录
- **AND** 每条记录 SHALL 包含：
  - 单据编号
  - 单据类型（入库/出库）
  - 产品信息
  - 数量
  - 单价
  - 金额
  - 时间

---

### Requirement: 出入库汇总

系统 SHALL 支持按月/周汇总各产品的入库量、出库量、净变化。

#### Scenario: 按月汇总
- **WHEN** 用户选择"按月"汇总
- **THEN** 系统 SHALL 按月分组显示
- **AND** 系统 SHALL 显示每个产品的：
  - 月度入库总量
  - 月度出库总量
  - 月度净变化

#### Scenario: 按周汇总
- **WHEN** 用户选择"按周"汇总
- **THEN** 系统 SHALL 按周分组显示
- **AND** 系统 SHALL 显示每个产品的：
  - 周度入库总量
  - 周度出库总量
  - 周度净变化

---

### Requirement: 运输统计

系统 SHALL 支持按运输公司/车辆统计运输趟次和运费。

#### Scenario: 按运输公司统计
- **WHEN** 用户选择"按运输公司"统计
- **THEN** 系统 SHALL 显示每个运输公司的：
  - 运输趟次
  - 总运费
  - 平均运费

#### Scenario: 按车辆统计
- **WHEN** 用户选择"按车辆"统计
- **THEN** 系统 SHALL 显示每辆车的：
  - 运输趟次
  - 总运费
  - 运输里程

---

### Requirement: 库存预警

系统 SHALL 支持按产品设置预警阈值并提供预警通知。

#### Scenario: 预警阈值设置
- **WHEN** 管理员为产品设置预警阈值
- **THEN** 系统 SHALL 支持设置：
  - 最低库存预警
  - 最高库存预警（如适用）

#### Scenario: 预警触发
- **WHEN** 产品库存 ≤ 最低库存预警值
- **THEN** 系统 SHALL 生成库存预警
- **AND** 系统 SHALL 在工作台显示预警列表
- **AND** 预警 SHALL 包含：
  - 产品名称
  - 当前库存
  - 预警阈值
  - 预警类型（低于最低/高于最高）

#### Scenario: 预警通知
- **WHEN** 库存预警触发
- **THEN** 系统 SHALL 通过系统消息通知相关人员
- **AND** 通知 SHALL 包含产品信息和当前库存状态