# 库位管理与采购建议完整功能指南

## 📍 库位管理功能

### 功能概述
库位管理实现了仓库物理分区和精准存放管理，支持库位编码、容量监控、物料绑定和快速找货。

### 核心功能

#### 1. 库位编码规则
- **格式**: `区域-行-货架` (如 A区-01-02)
- **区域**: A区、B区、C区、D区
- **行号**: 01, 02, 03...
- **货架**: 01, 02, 03...
- **层级**: 底层、中层、高层

#### 2. 库位状态管理
- **空闲**: 库位未存放任何物料
- **使用中**: 库位正在存放物料
- **维护中**: 库位正在维护，暂不可用
- **禁用**: 库位已禁用

#### 3. 容量管理
- 记录总容量和已用容量
- 实时计算使用率
- 可视化进度条显示
- 预警超量存放

#### 4. 物料清单
- 显示库位存放的所有物料
- 物料名称、数量、单位
- 快速查找物品位置
- 支持多种物料混放

### 操作指南

#### 新增库位
1. 点击 "新增库位" 按钮
2. 选择仓库和区域
3. 填写行号和货架号（如 01、02）
4. 选择层级（底层/中层/高层）
5. 设置库位容量
6. 添加备注信息（可选）
7. 系统自动生成库位编码
8. 点击 "创建" 完成

#### 编辑库位
1. 点击库位卡片的 "编辑" 按钮
2. 修改库位信息
3. 注意：库位编码修改后会重新验证唯一性
4. 点击 "更新" 保存

#### 查看库位详情
1. 点击库位卡片的 "眼睛" 图标
2. 查看完整的库位信息
3. 查看容量使用情况
4. 查看存放物料清单
5. 支持禁用、删除操作

#### 筛选和搜索
- **搜索**: 支持库位码、仓库名、物料名搜索
- **仓库筛选**: 按仓库过滤
- **状态筛选**: 按状态过滤
- **区域筛选**: 按区域过滤
- **重置**: 一键清空所有筛选条件

### 统计数据
- 库位总数
- 使用中数量
- 空闲数量
- 平均使用率
- 维护/禁用数量

---

## 🛒 智能采购建议功能

### 功能概述
系统根据当前库存、安全库存阈值、未来N天的计划消耗量，智能计算采购建议，极大减轻人工计算负担。

### 核心算法

#### 计算公式
```
建议采购数量 = 安全库存 + 预测消耗 - 当前库存
预测消耗 = 日均消耗量 × 预测天数
```

#### 优先级判定
- **高优先级**: 当前库存 < 安全库存 × 50%（严重不足，需紧急采购）
- **中优先级**: 当前库存 < 安全库存 × 80%（需要采购）
- **低优先级**: 当前库存 ≥ 安全库存 × 80%（预防性采购）

### 主要功能

#### 1. 智能计算
- 自动分析所有物料库存状况
- 计算日均消耗量
- 预测未来N天消耗
- 生成采购建议清单
- 按优先级排序

#### 2. 预测周期设置
支持多种预测周期：
- 未来7天（短期）
- 未来15天
- 未来30天（默认）
- 未来60天
- 未来90天（长期）

#### 3. 建议卡片展示
每条建议包含：
- 物料名称和类型
- 优先级标识
- 当前库存状况
- 安全库存基准
- 日均消耗数据
- 预测消耗量
- **建议采购数量**（高亮显示）
- 预估采购金额
- 计算逻辑说明

#### 4. 数据可视化
- 库存使用率进度条
- 优先级颜色标识
- 统计卡片展示
- 数据对比分析

### 操作指南

#### 重新计算建议
1. 选择预测天数（7/15/30/60/90天）
2. 点击 "重新计算" 按钮
3. 系统自动分析所有物料
4. 计算过程显示加载动画
5. 生成新的采购建议清单

#### 查看建议详情
1. 点击建议卡片的 "详情" 按钮
2. 查看完整的数据分析
3. 了解计算逻辑
4. 查看库存状况和消耗预测
5. 查看优先级判定依据

#### 加入采购计划（单个）
1. 在建议卡片中点击 "加入采购计划"
2. 系统提示已加入成功
3. 显示物料、数量、预估金额

#### 生成采购计划（批量）
1. 点击右上角 "生成采购计划" 按钮
2. 系统将所有建议批量生成计划
3. 显示总数量和预估总金额
4. 可跳转到采购计划页面

#### 紧急采购
1. 点击 "紧急采购" 按钮
2. 仅处理高优先级建议
3. 快速生成紧急采购计划

#### 导出建议
1. 点击 "导出建议" 按钮
2. 导出Excel格式的采购建议清单
3. 包含所有计算数据和分析结果

### 统计指标
- 建议总数
- 高优先级数量
- 中优先级数量
- 预估总金额

### 计算示例

#### 示例1：优质水稻种子
- 当前库存：85袋
- 安全库存：100袋
- 日均消耗：5袋/天
- 预测周期：30天
- 预测消耗：5 × 30 = 150袋
- **建议采购**：100 + 150 - 85 = **165袋**
- 单价：¥280/袋
- **预估金额**：¥46,200

#### 示例2：机油
- 当前库存：20桶
- 安全库存：30桶
- 日均消耗：2桶/天
- 预测周期：30天
- 预测消耗：2 × 30 = 60桶
- **建议采购**：30 + 60 - 20 = **70桶**
- 单价：¥350/桶
- **预估金额**：¥24,500

---

## 🔄 业务闭环

### 库位管理闭环
1. **创建库位** → 设置编码、容量
2. **入库绑定** → 物品与库位关联
3. **物料查询** → 快速定位存放位置
4. **容量监控** → 实时掌握使用情况
5. **状态管理** → 维护、禁用、启用
6. **数据统计** → 整体分析和优化

### 采购建议闭环
1. **数据采集** → 库存、消耗、安全库存
2. **智能计算** → 自动分析和预测
3. **建议生成** → 优先级排序和金额估算
4. **人工审核** → 查看详情和调整
5. **生成计划** → 单个或批量加入
6. **执行采购** → 跳转采购订单
7. **入库更新** → 库存自动更新
8. **循环监控** → 持续优化采购

---

## 🎯 功能特点

### 库位管理
✅ **编码规范**: 统一的编码格式，便于管理  
✅ **可视化**: 直观展示库位状态和使用率  
✅ **灵活搜索**: 多维度筛选快速定位  
✅ **容量监控**: 实时掌握空间利用情况  
✅ **物料绑定**: 精准记录物品存放位置  
✅ **状态管理**: 支持多种库位状态

### 采购建议
✅ **智能计算**: 自动分析无需人工计算  
✅ **数据驱动**: 基于真实库存和消耗数据  
✅ **预测准确**: 科学预测未来需求  
✅ **优先级**: 自动分类紧急程度  
✅ **金额估算**: 预算控制和成本核算  
✅ **一键操作**: 快速生成采购计划  
✅ **完整追溯**: 详细的计算逻辑说明

---

## 🚀 快速测试

### 测试库位管理
1. 进入 **资产管理** → **库存管理** → **库位管理**
2. 查看现有6个库位的统计数据
3. 点击 "新增库位" 创建新库位（如：A区-03-01）
4. 点击库位卡片的 "详情" 查看物料清单
5. 使用搜索和筛选功能测试
6. 测试编辑和删除功能

### 测试采购建议
1. 进入 **资产管理** → **库存管理** → **采购建议**
2. 查看统计卡片（建议总数、高优先级、预估金额）
3. 修改预测天数（如改为60天）
4. 点击 "重新计算" 查看新建议
5. 点击建议卡片的 "详情" 查看完整分析
6. 测试 "加入采购计划" 功能
7. 测试 "生成采购计划" 批量功能
8. 测试 "紧急采购" 和 "导出" 功能

---

## 💡 使用建议

### 库位管理
1. **规范编码**: 制定统一的编码规则，便于查找
2. **分区管理**: 按物料类型规划区域（如A区存种子，B区存化肥）
3. **容量规划**: 合理设置容量，避免超载
4. **定期盘点**: 确保库位信息与实际一致
5. **标识标签**: 实物库位贴上编码标签

### 采购建议
1. **定期计算**: 每周或每月重新计算一次
2. **调整参数**: 根据季节调整预测天数
3. **人工审核**: 结合实际情况调整建议数量
4. **优先处理**: 先处理高优先级建议
5. **批量采购**: 合并同供应商物料降低成本
6. **记录反馈**: 记录实际采购与建议的差异，优化算法

---

## 📊 数据流向

```
库存数据 ──┐
           ├──→ 采购建议计算 ──→ 生成建议清单 ──→ 加入采购计划
消耗数据 ──┤
           │
安全库存 ──┘

采购订单 ──→ 入库管理 ──→ 库位分配 ──→ 物料绑定 ──→ 库存更新 ──→ 循环计算
```

---

## ✅ 功能验证清单

### 库位管理
- [x] 新增库位功能
- [x] 编辑库位功能
- [x] 查看库位详情
- [x] 库位搜索筛选
- [x] 容量使用率计算
- [x] 物料清单展示
- [x] 状态管理（禁用/启用）
- [x] 删除库位（空库位）
- [x] 统计数据汇总

### 采购建议
- [x] 智能计算功能
- [x] 预测周期设置
- [x] 优先级自动判定
- [x] 建议数量计算
- [x] 金额估算
- [x] 详情查看
- [x] 单个加入计划
- [x] 批量生成计划
- [x] 紧急采购
- [x] 导出功能
- [x] 计算逻辑展示
- [x] 统计数据汇总

---

## 🎉 功能亮点

1. **减轻负担**: 采购建议自动计算，无需人工逐个计算
2. **精准预测**: 基于真实消耗数据，科学预测未来需求
3. **优先排序**: 自动识别紧急程度，合理安排采购顺序
4. **成本控制**: 预估金额帮助预算管理
5. **库位精准**: 物料与库位绑定，快速找货提高效率
6. **可视化**: 数据图表直观展示，一目了然
7. **完整闭环**: 从计算到采购到入库的完整流程

---

**提示**: 库位管理与采购建议功能已全面完成，实现了完整的业务闭环！🎊
