# 📦 入库管理 - 手动创建功能指南

## 🎯 功能概述

入库管理现在支持两种入库模式：
1. **基于采购订单**：依据已审批通过的采购订单生成入库单
2. **手动创建**：手动选择农资、填写数量和价格信息（新功能）

## ✨ 手动创建入库功能

### 适用场景
- 🎁 供应商赠品入库
- 🔄 内部调拨入库
- 📦 退货入库
- 🆓 免费领取的农资入库
- 📋 其他没有采购订单的入库情况

### 核心功能

#### 1. 灵活的物料选择
- 从农资库中选择任意物料
- 支持添加多个不同物料
- 可随时删除已添加的物料

#### 2. 完整的信息录入
每个物料可以填写：
- ✅ 入库数量（无限制）
- ✅ 批次号（自动生成，可修改）
- ✅ 生产日期
- ✅ 有效期至
- ✅ 库位
- ✅ 单价（可编辑）
- ✅ 自动计算金额

#### 3. 供应商信息
- 供应商为可选项
- 可以不填写供应商直接入库
- 适用于无明确供应商的情况

## 🚀 快速测试步骤

### 第1步：打开手动创建（10秒）
```
1. 进入：资产管理 → 库存管理 → 入库管理
2. 点击"新增入库"按钮
3. 选择"手动创建"单选按钮
```

**预期效果**：
- ✅ 界面切换到手动创建模式
- ✅ 显示供应商选择（可选）
- ✅ 显示农资物料选择器

### 第2步：选择基本信息（20秒）
```
1. 入库仓库：保持默认"1号仓库"或选择其他
2. 入库日期：保持默认今天或修改
3. 供应商：可选择或留空
```

**提示**：供应商不是必填项，可以直接跳过

### 第3步：添加物料（30秒）
```
1. 点击"添加入库物料"下拉框
2. 选择"优质水稻种子 - 25kg/袋 - 种子"
3. 物料自动添加到下方列表
4. 继续添加更多物料（可选）
   - 选择"复合肥 - 50kg/袋 - 化肥"
```

**预期效果**：
- ✅ 每选择一个物料，立即添加到列表
- ✅ 每个物料卡片显示"手动添加"紫色标签
- ✅ 右上角有删除按钮
- ✅ 批次号、日期自动填充

### 第4步：填写物料明细（1分钟）

#### 物料1：优质水稻种子
```
- 本次入库数量：100（可任意填写）
- 批次号：保持自动生成或修改
- 库位：选择"A区-01-03"
- 生产日期：保持默认或修改
- 有效期至：保持默认或修改
- 单价：280（可修改）
```

#### 物料2：复合肥（如果添加了）
```
- 本次入库数量：50
- 批次号：保持自动生成
- 库位：选择"B区-02-01"
- 生产日期：今天
- 有效期至：一年后
- 单价：180
```

**实时计算**：
- ✅ 入库金额自动计算：100 × 280 = ¥28,000
- ✅ 总金额实时更新

### 第5步：查看汇总（10秒）
```
汇总信息卡片显示：
- 总物料项数：2 项
- 总入库数量：150 件
- 总入库金额：¥37,000
```

### 第6步：确认入库（10秒）
```
1. 可选：填写备注
2. 点击"确认入库"按钮
```

**预期效果**：
- ✅ 显示成功提示："入库成功 - 入库单号: IN-2024-XXX，共 2 项物料"
- ✅ 对话框自动关闭
- ✅ 入库记录列表顶部出现新记录

### 第7步：验证入库记录（30秒）
```
在入库记录列表中查看刚创建的记录
```

**应该看到**：
- ✅ 入库单号：IN-2024-XXX
- ✅ 类型：其他入库（灰色标签）
- ✅ 状态：已审核
- ✅ 仓库：1号仓库
- ✅ 供应商：未指定（如果没选）或选择的供应商名称
- ✅ 物料明细：
  * 优质水稻种子：100袋
  * 复合肥：50袋
- ✅ 总金额：¥37,000

## 📊 功能对比

| 功能项 | 基于订单 | 手动创建 |
|--------|----------|----------|
| 选择订单 | ✅ 必须 | ❌ 不需要 |
| 供应商 | ✅ 自动填充 | ⭕ 可选 |
| 物料来源 | 📋 订单明细 | 🎨 自由选择 |
| 添加物料 | ❌ 不可修改 | ✅ 自由添加/删除 |
| 入库数量限制 | ⚠️ 不超过剩余 | ✅ 无限制 |
| 单价编辑 | ❌ 固定 | ✅ 可编辑 |
| 自动更新订单 | ✅ 是 | ❌ 否 |
| 入库类型 | 采购入库 | 其他入库 |

## 🎨 界面特色

### 1. 物料卡片标识
```
手动添加的物料会显示：
┌─────────────────────────────────┐
│ 优质水稻种子 [25kg/袋] [手动添加] │ 🗑️
│ 单位: 袋                          │
└─────────────────────────────────┘
```

### 2. 删除功能
- 每个手动添加的物料右上角有删除按钮（垃圾桶图标）
- 点击即可移除该物料
- 基于订单的物料不显示删除按钮

### 3. 单价可编辑
```
手动创建：[  280.00  ] ← 可输入
基于订单：    ¥280     ← 仅显示
```

### 4. 提示信息
```
"从列表中选择农资物料，可添加多个物料"
```

## 📝 测试场景

### 场景1：供应商赠品入库
```
背景：供应商赠送10袋种子
操作：
1. 手动创建入库
2. 不选择供应商
3. 添加"优质水稻种子"
4. 数量：10袋
5. 单价：0（免费）
6. 确认入库

结果：
- 入库类型：其他入库
- 供应商：未指定
- 金额：¥0
```

### 场景2：多物料混合入库
```
背景：收到多种农资混合到货
操作：
1. 手动创建入库
2. 选择供应商"丰收农资批发"
3. 添加物料：
   - 水稻种子 20袋 × ¥280
   - 复合肥 30袋 × ¥180
   - 农药 15瓶 × ¥45
4. 分别填写批次和库位
5. 确认入库

结果：
- 3个物料
- 总金额：¥11,675
```

### 场景3：临时采购入库
```
背景：紧急从当地小店采购农资
操作：
1. 手动创建入库
2. 不选供应商或选择"其他"
3. 添加物料并填写实际采购价格
4. 确认入库

结果：
- 快速完成入库
- 记录实际采购价格
```

## ⚠️ 注意事项

### 1. 必填项
- ✅ 入库仓库
- ✅ 入库日期
- ✅ 至少添加一个物料
- ✅ 每个物料的：数量、批次号、库位、生产日期、单价

### 2. 数量限制
- 手动创建模式下，入库数量**没有上限**
- 可以输入任意正数
- 适合大批量入库

### 3. 供应商
- 供应商字段**不是必填**
- 未选择时显示"未指定"
- 不影响入库操作

### 4. 单价
- 必须大于0
- 支持小数点（如：280.50）
- 默认值为物料的历史价格
- 可以修改为实际价格

### 5. 重复添加
- 同一物料不能添加多次
- 如需同一物料多批次，请分批入库

## 🆚 与订单入库的区别

### 基于订单入库
```
优点：
✅ 自动关联采购订单
✅ 自动更新到货进度
✅ 供应商信息自动填充
✅ 价格与订单一致

缺点：
❌ 需要先有订单
❌ 数量受订单限制
❌ 不能编辑单价
```

### 手动创建入库
```
优点：
✅ 无需采购订单
✅ 物料自由选择
✅ 数量无限制
✅ 单价可编辑
✅ 供应商可选

缺点：
❌ 不关联采购订单
❌ 不自动更新订单进度
❌ 需要手动填写更多信息
```

## 💡 最佳实践

### 1. 何时使用手动创建
- ✅ 赠品、样品入库
- ✅ 退货返回入库
- ✅ 内部调拨入库
- ✅ 紧急临时采购
- ✅ 历史库存录入

### 2. 何时使用订单入库
- ✅ 正常采购到货
- ✅ 需要关联订单追溯
- ✅ 需要更新订单状态
- ✅ 分批到货

### 3. 填写建议
```
批次号：建议包含日期，如 BATCH-2024-1021
生产日期：尽量填写真实日期
有效期：根据物料类型设置合理期限
库位：选择空闲或适合的库位
单价：填写实际成交价格
```

## 🔮 未来扩展

### 计划中的功能
1. **物料模板**：保存常用物料组合
2. **快速复制**：复制上次入库内容
3. **批量导入**：Excel导入物料清单
4. **移动端**：支持手机扫码入库
5. **照片上传**：上传实物照片
6. **供应商自由输入**：临时供应商直接输入名称

## ✅ 功能检查清单

测试完成后，请确认：

- [ ] 可以选择"手动创建"模式
- [ ] 供应商为可选项（可不填）
- [ ] 可以添加多个物料
- [ ] 可以删除已添加的物料
- [ ] 入库数量无限制
- [ ] 单价可以编辑
- [ ] 金额自动计算
- [ ] 汇总信息实时更新
- [ ] 入库成功提示正确
- [ ] 入库记录类型为"其他入库"
- [ ] 未选供应商时显示"未指定"

## 📞 支持信息

**功能更新时间**：2024年10月21日  
**版本**：v2.1  
**状态**：✅ 已完成并可用

---

**总结**：手动创建入库功能为用户提供了灵活的入库方式，适用于各种没有采购订单的入库场景。无论是赠品、退货还是临时采购，都可以快速完成入库登记。
