# 物资领用 - 领用申请功能完整指南

## 功能概述

物资领用申请功能是资产管理系统的核心模块，实现了从申请、审批到出库的完整闭环管理。本模块支持在线填写电子申请单、附件上传、智能验证等功能。

## 主要功能特性

### 1. 电子申请单填写

领用人可以在线填写完整的领用申请信息，包括：

- **基本信息**
  - 申请人（自动填充当前用户）
  - 所属部门（必填）
  - 申请时间（自动生成）

- **关联信息**
  - 关联任务（可选）：可选择具体的农事任务
  - 关联地块（可选）：可选择具体的田块或大棚
  - 这些关联信息是成本核算和溯源的关键数据

- **计划信息**
  - 计划领用时间（必填）：系统会限制只能选择今天或未来日期
  - 优先级（必填）：高/中/低，帮助审批人判断紧急程度

- **用途说明**
  - 领用用途（必填）：详细说明物资的用途，例如施肥作业、除草作业等

### 2. 物品清单管理

支持添加多项物品，每项物品包含：

- **物资选择**：从系统中已有的物资库中选择
- **申请数量**：输入需要领用的数量
- **库存提示**：
  - 自动显示当前库存数量
  - 如果申请数量超过库存，会显示红色警告提示
  - 帮助申请人合理填写申请数量

- **预估金额**：
  - 自动计算每项物品的预估金额
  - 显示总计金额，便于审批决策

### 3. 附件上传功能

支持多种方式上传附件：

**上传方式**
- 点击上传区域选择文件
- 拖拽文件到上传区域（支持批量拖拽）

**支持的文件格式**
- PDF 文档（.pdf）
- Word 文档（.doc, .docx）
- 图片文件（.jpg, .jpeg, .png, .gif）
- 文本文件（.txt）

**文件限制**
- 单个文件大小：不超过 10MB
- 文件数量：无限制（建议不超过5个）

**附件管理**
- 实时显示已上传文件列表
- 显示文件名和文件大小
- 支持删除已上传的文件

### 4. 表单验证

系统会在提交前进行完整验证：

✅ **必填项检查**
- 领用用途必须填写
- 计划领用时间必须选择
- 至少添加一项物品

✅ **物品信息检查**
- 每项物品必须选择物资
- 每项物品必须填写申请数量
- 申请数量必须大于0

✅ **库存检查**
- 如果任何物品的申请数量超过库存，会提示错误
- 确保申请的合理性

### 5. 智能提示

- **填写说明**：在表单顶部提供填写指南
- **库存警告**：申请数量超出库存时实时提醒
- **成功反馈**：提交成功后显示详细信息（物品数、附件数）

## 使用流程

### 第一步：新建申请

1. 点击"新建领用申请"按钮
2. 系统打开申请表单对话框

### 第二步：填写基本信息

1. 选择所属部门
2. 选择关联任务（可选）
3. 选择关联地块（可选）
4. 选择计划领用时间
5. 选择优先级
6. 填写领用用途（必填，详细说明）

### 第三步：添加物品清单

1. 点击"添加物品"按钮
2. 为每项物品选择物资名称
3. 输入申请数量
4. 查看库存提示，确保数量合理
5. 可添加多项物品
6. 如需删除，点击对应物品的"删除"按钮

### 第四步：上传附件（可选）

1. 点击上传区域或拖拽文件
2. 选择相关说明文件（如作业方案、施肥计划等）
3. 查看已上传文件列表
4. 如需删除，点击文件右侧的删除按钮

### 第五步：填写备注（可选）

在备注栏填写其他需要说明的信息

### 第六步：提交申请

1. 点击"提交申请"按钮
2. 系统自动验证表单
3. 验证通过后提交，生成申请单号
4. 自动进入审批流程

## 数据示例

### 物资库存数据（当前可选）

| 物资名称 | 类型 | 当前库存 | 单位 | 预估单价 |
|---------|------|---------|------|---------|
| 复合肥   | 肥料 | 500     | 袋   | ¥150    |
| 尿素     | 肥料 | 200     | 袋   | ¥100    |
| 除草剂   | 农药 | 80      | 瓶   | ¥50     |
| 滴灌管   | 农具 | 1000    | 米   | ¥5      |
| 杀虫剂   | 农药 | 120     | 瓶   | ¥80     |
| 地膜     | 农具 | 300     | 卷   | ¥20     |

### 关联任务（可选）

- 任务-2024001 - 水稻田施肥
- 任务-2024002 - 玉米田除草
- 任务-2024003 - 蔬菜大棚灌溉
- 任务-2024004 - 果树修剪

### 关联地块（可选）

- 1号田块 (水稻)
- 2号田块 (玉米)
- 3号大棚 (蔬菜)
- 4号果园 (苹果)
- 5号大棚 (草莓)

## 申请示例

### 示例1：水稻田施肥申请

**基本信息**
- 所属部门：种植一队
- 关联任务：任务-2024001 - 水稻田施肥
- 关联地块：1号田块 (水稻)
- 计划领用时间：2024-10-20
- 优先级：高

**用途说明**
```
用于1号田块水稻施肥作业，预计施肥面积50亩。
根据土壤检测结果和水稻生长期需求，需要进行追肥作业。
施肥时间安排在10月20日上午，需提前领取物资。
```

**物品清单**
1. 复合肥 - 100袋（当前库存：500袋）
2. 尿素 - 50袋（当前库存：200袋）

**附件**
- 施肥方案.pdf
- 土壤检测报告.pdf

**预估总金额**：¥20,000

### 示例2：玉米田除草申请

**基本信息**
- 所属部门：种植二队
- 关联任务：任务-2024002 - 玉米田除草
- 关联地块：2号田块 (玉米)
- 计划领用时间：2024-10-22
- 优先级：中

**用途说明**
```
2号田块玉米生长到拔节期，杂草开始快速生长，
需要及时进行除草作业，防止杂草与玉米竞争养分。
计划喷洒除草剂，覆盖面积30亩。
```

**物品清单**
1. 除草剂 - 20瓶（当前库存：80瓶）

**附件**
- 除草方案.pdf
- 现场照片.jpg

**预估总金额**：¥1,000

## 后续流程

提交申请后，系统会自动：

1. **生成申请单号**：格式为 LY + 日期 + 序号，例如：LY202410220001
2. **触发审批流程**：根据申请金额和物资类型，自动分配审批人
3. **消息通知**：通过系统消息、短信等方式通知审批人
4. **状态跟踪**：可在"领用申请"列表中查看申请状态

### 申请状态说明

- **待提交**：草稿状态，可继续编辑
- **待审批**：已提交，等待审批人审批
- **已通过**：审批通过，等待仓库出库
- **已驳回**：审批未通过，需修改后重新提交
- **已出库**：仓库已完成出库，库存已核减
- **已核销**：领用完成，已核销

## 注意事项

⚠️ **重要提示**

1. **准确填写用途**：用途说明是成本核算和质量溯源的关键信息，请详细填写
2. **关联任务或地块**：强烈建议填写关联信息，便于后期追踪和分析
3. **合理申请数量**：根据实际需求填写，避免浪费
4. **注意库存**：申请数量不能超过当前库存
5. **附件完整性**：重要的说明文件建议上传附件
6. **计划时间**：计划领用时间需要合理安排，给审批和出库留出时间

## 常见问题

**Q1: 可以同时选择多个关联任务吗？**
A: 目前只支持选择一个关联任务，如果涉及多个任务，建议在用途中详细说明。

**Q2: 申请数量超过库存怎么办？**
A: 系统会提示错误并阻止提交。您可以：
   - 减少申请数量
   - 联系仓库管理员确认实际库存
   - 等待补货后再提交申请

**Q3: 提交后发现信息填错了怎么办？**
A: 在审批前，可以联系审批人驳回申请，然后重新提交。

**Q4: 附件上传失败怎么办？**
A: 请检查：
   - 文件格式是否支持
   - 文件大小是否超过10MB
   - 网络连接是否正常

**Q5: 紧急申请如何处理？**
A: 将优先级设置为"高"，并在用途中说明紧急原因，审批人会优先处理。

## 技术支持

如遇到问题，请联系系统管理员或查看系统帮助文档。

---

**文档版本**: v1.0  
**更新日期**: 2024-10-22  
**适用系统**: 智慧农业生产管理系统 - 资产管理模块
