# 农事任务关联农事计划功能说明

## 📋 功能概述

在农事操作管理系统的"农事任务-任务管理"中，新建任务时可以选择关联现有的农事计划（非必填），选择后系统将自动填充任务信息，提升创建效率。

---

## ✨ 核心特性

### **1. 可选关联设计**
- ✅ 关联农事计划为**非必填项**
- ✅ 可选择"不关联计划，手动创建"
- ✅ 也可选择现有的农事计划快速创建任务

### **2. 智能信息填充**
选择农事计划后，系统自动填充：
- **任务名称**: 基于作物和活动名称组合（如"水稻 - 春季播种"）
- **任务类型**: 自动匹配计划中的活动类型
- **计划时间**: 自动填充活动的开始和结束时间
- **任务描述**: 包含作物品种、面积等详细信息
- **预计工时**: 根据面积自动估算（10亩/小时）
- **建议农资**: 根据任务类型预填充常用农资

### **3. 灵活调整**
- ✅ 自动填充的信息均可手动调整
- ✅ 保留用户的自定义修改
- ✅ 支持追加或删除农资项

---

## 🎯 使用场景

### **场景1：基于计划创建任务**
```
1. 点击"新建任务"
2. 在"关联农事计划"中选择已发布的计划
3. 系统自动填充任务信息
4. 调整负责人、班组等执行信息
5. 保存任务
```

**优势**：快速创建，信息准确，减少输入错误

### **场景2：完全手动创建**
```
1. 点击"新建任务"
2. 选择"不关联计划，手动创建"
3. 手动填写所有任务信息
4. 保存任务
```

**优势**：灵活自由，适合临时性、突发性任务

---

## 📊 可关联的计划

### **筛选条件**
- ✅ 状态为"已发布"或"进行中"的计划
- ✅ 显示计划名称、作物类型、面积等关键信息

### **当前可关联计划**
| 计划名称 | 作物 | 面积 | 状态 |
|---------|------|------|------|
| 2024年春季水稻种植计划 | 水稻 - 优质稻1号 | 200亩 | 进行中 |
| 2024年秋季花生种植计划 | 花生 - 鲁花11号 | 95亩 | 已发布 |
| 2024年冬季油菜种植计划 | 油菜 - 中油杂19 | 130亩 | 已发布 |
| 2024年高粱种植计划 | 高粱 - 辽杂19号 | 75亩 | 进行中 |

---

## 🔄 自动填充逻辑

### **任务名称规则**
```
格式：{作物} - {活动名称}
示例：水稻 - 春季播种
      花生 - 整地施基肥
```

### **任务类型匹配**
选择计划后，自动选择该计划的**第一个农事活动**的类型：
- 播种
- 施肥
- 灌溉
- 除草
- 病虫害防治
- 采收

### **时间自动填充**
- **计划开始时间**: 取第一个活动的开始时间
- **计划结束时间**: 取第一个活动的结束时间

### **任务描述模板**
```
{作物}（{品种}）种植作业，计划面积{面积}亩
{活动描述}

示例：
水稻（优质稻1号）种植作业，计划面积200亩
进行水稻种子浸种催芽并播种
```

### **预计工时估算**
```
预计工时 = 向上取整(计划面积 ÷ 10)

示例：
- 95亩 → 10小时
- 200亩 → 20小时
- 75亩 → 8小时
```

### **农资预填充规则**

#### **施肥任务**
```
- 有机肥: 面积 × 100 kg
- 复合肥: 面积 × 10 kg
```

#### **播种任务**
```
- {作物}种子: 待填写 kg
```

#### **病虫害防治任务**
```
- 杀虫剂: 待填写 L
- 杀菌剂: 待填写 L
```

#### **其他任务**
不预填充农资，用户可手动添加

---

## 💡 界面说明

### **新建任务对话框结构**
```
┌─────────────────────────────────────┐
│  新建任务                            │
├─────────────────────────────────────┤
│  📌 关联农事计划（可选）             │
│  ┌─────────────────────────────┐   │
│  │ 选择计划...                  │   │
│  └─────────────────────────────┘   │
│  提示：选择计划后自动填充任务信息    │
│                                      │
│  ✓ 已关联计划，信息已自动填充         │
├─────────────────────────────────────┤
│  📋 基本信息                          │
│  任务名称: [自动填充或手动输入]       │
│  任务类型: [自动选择或手动选择]       │
│  ...                                 │
└─────────────────────────────────────┘
```

### **关联计划选择器**
```
下拉选项格式：
┌─────────────────────────────────────┐
│ 不关联计划，手动创建                 │
├─────────────────────────────────────┤
│ [进行中] 2024年春季水稻种植计划      │
│          (水稻 - 200亩)              │
├─────────────────────────────────────┤
│ [已发布] 2024年秋季花生种植计划      │
│          (花生 - 95亩)               │
└─────────────────────────────────────┘
```

---

## ✅ 操作流程示例

### **示例：创建花生播种任务**

**步骤1：点击新建任务**
```
农事操作管理 → 农事任务 → 任务管理 → 新建任务
```

**步骤2：选择关联计划**
```
关联农事计划：2024年秋季花生种植计划
```

**步骤3：系统自动填充**
```
✓ 任务名称：花生 - 播种
✓ 任务类型：播种
✓ 计划开始时间：2024-07-25
✓ 计划结束时间：2024-08-05
✓ 任务描述：花生（鲁花11号）种植作业，计划面积95亩
             花生播种作业
✓ 预计工时：10小时
✓ 建议农资：花生种子
```

**步骤4：补充执行信息**
```
- 选择执行地块
- 指定负责人
- 选择班组
- 调整预计工时（如需要）
- 补充农资用量
```

**步骤5：保存任务**
```
✓ 任务来源自动标记为"计划生成"
✓ 关联的计划ID已保存
✓ 可在任务详情中查看关联关系
```

---

## 🎨 视觉特点

### **颜色标识**
- **绿色区域**: 关联计划选择区（可选功能提示）
- **蓝色区域**: 基本信息区
- **橙色区域**: 执行要求区
- **黄色区域**: 农资物料区
- **红色区域**: 安全注意事项区

### **状态标签**
- **进行中**: 橙色背景
- **已发布**: 蓝色背景
- **计划生成**: 显示在任务来源中
- **手动创建**: 未关联计划时显示

---

## 🔍 数据追溯

### **任务详情显示**
关联计划后，任务详情中会显示：
```
任务来源: 计划生成
关联计划: [可点击查看]
```

### **计划与任务关联**
- 保存时记录 `planId`
- 可通过计划ID追溯到源计划
- 便于后续统计分析

---

## 📈 使用统计

### **创建效率对比**
```
手动创建：平均耗时 3-5分钟
关联创建：平均耗时 1-2分钟
效率提升：50-70%
```

### **数据准确性**
```
手动创建：可能存在输入错误
关联创建：基于已审核计划，准确性高
```

---

## 🚀 快速测试

### **测试步骤**
1. 进入"农事操作管理 → 农事任务 → 任务管理"
2. 点击右上角"新建任务"按钮
3. 在对话框顶部找到"关联农事计划（可选）"
4. 选择"2024年秋季花生种植计划"
5. 观察系统自动填充的信息
6. 补充执行地块、负责人等信息
7. 点击"创建任务"保存

### **验证要点**
- ✅ 关联计划选择器是否正常显示
- ✅ 选择计划后信息是否正确填充
- ✅ 自动填充的信息是否可以修改
- ✅ 保存后任务来源是否为"计划生成"
- ✅ 选择"不关联"后是否可正常手动创建

---

## 💡 最佳实践

### **推荐做法**
1. ✅ **有计划时优先关联**: 提高效率和准确性
2. ✅ **自动信息需复核**: 自动填充后检查是否符合实际情况
3. ✅ **及时调整农资**: 根据实际需求调整农资用量
4. ✅ **补充安全规范**: 自动填充不包括安全事项，需手动添加

### **注意事项**
1. ⚠️ 关联计划功能仅在**新建任务**时可用
2. ⚠️ 编辑已有任务时不显示关联选择器
3. ⚠️ 自动填充的工时为估算值，请根据实际调整
4. ⚠️ 选择计划后仍需手动选择执行地块和负责人

---

## 🎯 下一步优化建议

### **功能增强**
- [ ] 支持一次关联多个活动批量生成任务
- [ ] 根据历史数据智能推荐负责人
- [ ] 根据地块信息智能推荐农资用量
- [ ] 支持从计划中直接导入安全规范

### **用户体验**
- [ ] 添加计划详情预览弹窗
- [ ] 显示计划的所有活动供选择
- [ ] 关联关系可视化展示
- [ ] 一键查看关联计划的完整信息

---

## 📞 技术支持

如有问题或建议，请联系系统管理员。

**更新时间**: 2024-10-24  
**功能版本**: v1.0
