# 驾驶员任务管理 - 样例数据说明

## 📅 更新时间
2025-10-16

## 🎯 概述

为驾驶员任务管理系统新增了12条不同状态的样例任务数据，覆盖任务生命周期的各个阶段，便于演示和测试系统功能。

## 📊 数据统计

### 按状态分布
| 状态 | 数量 | 百分比 | 说明 |
|------|------|--------|------|
| 待接收 | 3条 | 25% | 新分配任务，等待驾驶员确认 |
| 已接收 | 1条 | 8.3% | 驾驶员已确认，准备开始 |
| 进行中 | 2条 | 16.7% | 正在执行的任务 |
| 已暂停 | 1条 | 8.3% | 因问题暂停的任务 |
| 已完成 | 3条 | 25% | 成功完成的任务 |
| 已取消 | 2条 | 16.7% | 因各种原因取消的任务 |
| **合计** | **12条** | **100%** | - |

### 按优先级分布
| 优先级 | 数量 | 百分比 |
|--------|------|--------|
| 高 | 4条 | 33.3% |
| 中 | 6条 | 50% |
| 低 | 2条 | 16.7% |

### 按作业类型分布
| 作业类型 | 数量 | 百分比 |
|---------|------|--------|
| 耕地 | 2条 | 16.7% |
| 播种 | 2条 | 16.7% |
| 施肥 | 2条 | 16.7% |
| 喷药 | 2条 | 16.7% |
| 灌溉 | 1条 | 8.3% |
| 收获 | 2条 | 16.7% |
| 耙地 | 1条 | 8.3% |

## 📋 详细数据清单

### 1. 待接收任务（3条）

#### Task-1: 耕地作业
```yaml
任务编号: T202510160001
农机: 约翰迪尔拖拉机
驾驶员: 张三
地块: 东一地块
作业类型: 耕地
描述: 对东一地块进行深耕作业，准备春播
计划时间: 2025-10-17 08:00 - 17:00
优先级: 高
状态: 待接收
```

#### Task-2: 播种作业
```yaml
任务编号: T202510160002
农机: 久保田播种机
驾驶员: 李四
地块: 西二地块
作业类型: 播种
描述: 玉米播种作业，注意播种深度控制在3-5cm
计划时间: 2025-10-18 07:00 - 16:00
优先级: 中
状态: 待接收
```

#### Task-3: 施肥作业
```yaml
任务编号: T202510160003
农机: 雷沃施肥机
驾驶员: 王五
地块: 南三地块
作业类型: 施肥
描述: 追肥作业，使用复合肥，每亩用量30kg
计划时间: 2025-10-19 08:30 - 15:30
优先级: 低
状态: 待接收
```

---

### 2. 已接收任务（1条）

#### Task-4: 耙地作业
```yaml
任务编号: T202510150004
农机: 约翰迪尔拖拉机
驾驶员: 赵六
地块: 北四地块
作业类型: 耙地
描述: 整地作业，确保地面平整
计划时间: 2025-10-16 13:00 - 18:00
优先级: 中
状态: 已接收
接收时间: 2025-10-16 09:20
```

---

### 3. 进行中任务（2条）

#### Task-5: 喷药作业
```yaml
任务编号: T202510160005
农机: 大疆植保无人机
驾驶员: 钱七
地块: 东五地块
作业类型: 喷药
描述: 病虫害防治，喷洒杀虫剂和杀菌剂
计划时间: 2025-10-16 09:00 - 12:00
实际开始: 2025-10-16 09:10
优先级: 高
状态: 进行中
```

#### Task-6: 收获作业
```yaml
任务编号: T202510160006
农机: 洋马收割机
驾驶员: 孙八
地块: 西六地块
作业类型: 收获
描述: 小麦收获作业，注意收割高度
计划时间: 2025-10-16 07:30 - 17:30
实际开始: 2025-10-16 07:45
优先级: 高
状态: 进行中
```

---

### 4. 已暂停任务（1条）

#### Task-7: 灌溉作业（有问题）
```yaml
任务编号: T202510160007
农机: 约翰迪尔拖拉机
驾驶员: 周九
地块: 南七地块
作业类型: 灌溉
描述: 滴灌作业，确保灌溉均匀
计划时间: 2025-10-16 06:00 - 14:00
实际开始: 2025-10-16 06:10
优先级: 中
状态: 已暂停
问题: 
  - 类型: 设备故障
  - 描述: 滴灌管道出现破损，需要更换
  - 上报时间: 2025-10-16 10:30
  - 状态: 待处理
```

---

### 5. 已完成任务（3条）

#### Task-8: 播种作业
```yaml
任务编号: T202510150008
农机: 久保田播种机
驾驶员: 张三
地块: 东八地块
作业类型: 播种
描述: 大豆播种作业
计划时间: 2025-10-15 08:00 - 16:00
实际时间: 2025-10-15 08:10 - 15:50
优先级: 中
状态: 已完成
工时: 7.67小时
```

#### Task-9: 施肥作业
```yaml
任务编号: T202510140009
农机: 雷沃施肥机
驾驶员: 李四
地块: 北九地块
作业类型: 施肥
描述: 底肥施用，每亩50kg有机肥
计划时间: 2025-10-14 09:00 - 17:00
实际时间: 2025-10-14 09:05 - 16:45
优先级: 低
状态: 已完成
工时: 7.67小时
```

#### Task-10: 耕地作业
```yaml
任务编号: T202510130010
农机: 约翰迪尔拖拉机
驾驶员: 王五
地块: 西十地块
作业类型: 耕地
描述: 秋耕作业，深度25cm
计划时间: 2025-10-13 08:00 - 17:00
实际时间: 2025-10-13 08:15 - 17:10
优先级: 中
状态: 已完成
工时: 8.92小时
```

---

### 6. 已取消任务（2条）

#### Task-11: 喷药作业（天气原因）
```yaml
任务编号: T202510150011
农机: 大疆植保无人机
驾驶员: 赵六
地块: 南十一地块
作业类型: 喷药
描述: 除草剂喷洒作业
计划时间: 2025-10-15 14:00 - 17:00
优先级: 低
状态: 已取消
取消原因:
  - 类型: 天气影响
  - 描述: 突遇大风天气，不适宜喷药作业
  - 上报时间: 2025-10-15 13:50
```

#### Task-12: 收获作业（地块问题）
```yaml
任务编号: T202510140012
农机: 洋马收割机
驾驶员: 钱七
地块: 东十二地块
作业类型: 收获
描述: 水稻收获作业
计划时间: 2025-10-14 07:00 - 18:00
优先级: 高
状态: 已取消
取消原因:
  - 类型: 地块问题
  - 描述: 水稻尚未完全成熟，延后收获
  - 上报时间: 2025-10-14 06:30
```

---

## 🎭 任务生命周期展示

### 完整流程
```
创建任务
   ↓
[待接收] ← 任务刚分配
   ↓ (驾驶员确认)
[已接收] ← 准备开始
   ↓ (开始作业)
[进行中] ← 正在执行
   ↓
   ├─→ [已暂停] ← 遇到问题
   │      ↓ (解决问题)
   │      └─→ [进行中]
   ↓ (完成作业)
[已完成] ← 正常结束

或者

[进行中]
   ↓ (无法继续)
[已取消] ← 异常终止
```

### 各状态说明

#### 待接收 (3条样例)
- **触发**: 管理员创建任务后
- **特点**: 驾驶员尚未确认
- **下一步**: 驾驶员点击"接收"

#### 已接收 (1条样例)
- **触发**: 驾驶员确认接收任务
- **特点**: 准备阶段，尚未开始作业
- **下一步**: 驾驶员点击"开始"

#### 进行中 (2条样例)
- **触发**: 驾驶员开始作业
- **特点**: 记录实际开始时间
- **下一步**: 完成或暂停

#### 已暂停 (1条样例)
- **触发**: 遇到问题需要暂停
- **特点**: 有问题上报记录
- **下一步**: 继续或取消

#### 已完成 (3条样例)
- **触发**: 作业正常完成
- **特点**: 有实际开始和结束时间
- **计算**: 自动计算工时

#### 已取消 (2条样例)
- **触发**: 无法继续的异常情况
- **特点**: 有取消原因说明
- **记录**: 保留问题记录

## 📈 时间线分布

```
2025-10-13      2025-10-14      2025-10-15      2025-10-16      2025-10-17-19
    │               │               │               │               │
    ├─ Task-10     ├─ Task-9      ├─ Task-8      ├─ Task-5      ├─ Task-1
    │  已完成       │  已完成       │  已完成       │  进行中       │  待接收
    │              │              │              │              │
    │              ├─ Task-12     ├─ Task-4      ├─ Task-6      ├─ Task-2
    │              │  已取消       │  已接收       │  进行中       │  待接收
    │              │              │              │              │
    │              │              ├─ Task-11     ├─ Task-7      └─ Task-3
    │              │              │  已取消       │  已暂停          待接收
    │              │              │              │
```

## 🎯 设计��虑

### 1. 真实性
- ✅ 时间跨度：覆盖近一周的任务
- ✅ 作业类型：涵盖常见农事操作
- ✅ 时间分布：符合农业生产规律
- ✅ 问题场景：反映实际可能遇到的问题

### 2. 完整性
- ✅ 六种任务状态全覆盖
- ✅ 三种优先级全覆盖
- ✅ 七种作业类型代表性强
- ✅ 问题上报功能演示

### 3. 可测试性
- ✅ 待接收任务：测试接收功能
- ✅ 已接收任务：测试开始功能
- ✅ 进行中任务：测试完成和暂停功能
- ✅ 已暂停任务：测试继续和问题处理
- ✅ 已完成任务：测试历史记录查看
- ✅ 已取消任务：测试取消原因查看

### 4. 教学性
- ✅ 清晰展示任务流转过程
- ✅ 演示问题上报机制
- ✅ 体现优先级管理
- ✅ 展示工时计算

## 💡 使用建议

### 开发测试
1. **首次加载**: 清空 localStorage，系统将自动初始化12条样例数据
2. **重置数据**: 删除 `smart_agriculture_driver_tasks` key，刷新页面
3. **保留数据**: 已有数据不会被覆盖

### 功能演示
1. **任务接收**: 演示待接收任务 → 已接收
2. **任务执行**: 演示已接收 → 进行中 → 已完成
3. **问题上报**: 演示进行中 → 已暂停（上报问题）
4. **任务取消**: 演示各状态 → 已取消
5. **历史查看**: 演示已完成和已取消任务的详情

### 培训教学
1. **基础操作**: 使用待接收、已接收任务演示基本流程
2. **异常处理**: 使用已暂停任务演示问题上报
3. **状态管理**: 使用全部样例展示完整生命周期
4. **数据分析**: 使用已完成任务展示工时统计

## 🔄 数据扩展

### 添加更多样例
如需添加更多样例任务，在 `DriverTask.tsx` 的 `mockTasks` 数组中添加：

```typescript
{
  id: 'task-13',
  taskNumber: 'T202510160013',
  machineryId: machinery[0]?.id || 'machinery-1',
  machineryName: machinery[0]?.name || '农机名称',
  driverId: 'driver-1',
  driverName: '驾驶员姓名',
  fieldId: 'field-13',
  fieldName: '地块名称',
  operationType: '作业类型',
  description: '任务描述',
  plannedStartTime: '2025-10-17T08:00:00',
  plannedEndTime: '2025-10-17T17:00:00',
  status: '待接收', // 或其他状态
  issues: [],
  priority: 'medium', // high/medium/low
  assignedBy: '调度中心',
  assignedAt: '2025-10-16T14:00:00',
  createdAt: '2025-10-16T14:00:00',
  updatedAt: '2025-10-16T14:00:00',
}
```

### 修改样例数据
直接编辑 `DriverTask.tsx` 中的 `mockTasks` 数组，修改后刷新页面生效。

## 📝 注意事项

### 数据初始化
- 仅在 localStorage 中无任务数据时初始化
- 已有数据不会被覆盖
- 可手动清空后重新初始化

### 时间设置
- 样例数据使用相对时间（2025-10-13 至 2025-10-19）
- 可根据需要调整时间
- 建议使用 ISO 8601 格式

### 农机和驾驶员
- 样例数据引用 machinery 和 drivers
- 如无对应数据，使用默认值
- 确保相关数据已初始化

### 地块数据
- 样例数据引用地块ID
- 建议先初始化地块数据
- 地块名称使用描述性名称

## ✅ 验证清单

### 数据完整性检查
- [ ] 12条任务都正常显示
- [ ] 6种状态都有代表
- [ ] 3种优先级都有覆盖
- [ ] 7种作业类型都有展示

### 功能验证
- [ ] 待接收任务可以接收
- [ ] 已接收任务可以开始
- [ ] 进行中任务可以完成
- [ ] 进行中任务可以暂停
- [ ] 任务详情可以查看
- [ ] 问题记录正确显示

### UI显示
- [ ] 任务列表正常展示
- [ ] 状态徽章颜色正确
- [ ] 优先级颜色正确
- [ ] 时间格式正确
- [ ] 工时计算准确

## 🎉 总结

本次更新为驾驶员任务管理系统提供了12条丰富的样例数据，覆盖了任务生命周期的各个阶段，具有：

✅ **真实性**: 模拟实际农业生产场景  
✅ **完整性**: 六种状态全覆盖  
✅ **可测试性**: 方便功能测试和演示  
✅ **教学性**: 清晰展示系统功能  

这些样例数据将帮助：
- 开发人员进行功能测试
- 产品人员进行功能演示
- 培训人员进行用户培训
- 用户快速理解系统功能

---

**创建日期**: 2025-10-16  
**文档版本**: v1.0  
**数据版本**: v1.2
