Files
smart-crop-ui/src/TASK_STATUS_UPDATE.md

9.7 KiB
Raw Blame History

驾驶员任务状态更新说明

📅 更新时间

2025-10-16

🎯 更新概述

对驾驶员任务管理的状态流转和操作按钮进行了优化,简化任务管理流程。

主要变更

1. 去掉"已中断"状态

变更前:

  • 任务状态包含:待接收、已接收、进行中、已完成、已中断、已取消

变更后:

  • 任务状态包含:待接收、已接收、进行中、已完成、已取消
  • 移除了"已中断"状态,简化状态流转

原因:

  • "已中断"状态使用频率低
  • 与"已取消"状态功能重叠
  • 简化状态流转,提升用户体验

2. 添加取消任务功能

新增功能:

  • 待接收状态: 显示"取消"按钮(红色 XCircle 图标)
  • 已接收状态: 显示"取消"按钮(红色 XCircle 图标)

取消流程:

待接收任务 → [点击取消] → 确认提示 → 任务变为"已取消"
已接收任务 → [点击取消] → 确认提示 → 任务变为"已取消"

安全确认:

  • 点击取消按钮会弹出确认提示
  • 提示内容:"确定要取消任务 T202510160001 吗?取消后将无法恢复。"
  • 只有确认后才会真正取消

3. 更新状态流转图 🔄

变更前:

待接收 → 已接收 → 进行中 → 已完成
                    ↓
                  已中断

变更后:

待接收 → 已接收 → 进行中 → 已完成
   ↓         ↓
 已取消    已取消

说明:

  • 待接收和已接收状态可以直接取消
  • 进行中的任务不能取消(避免误操作)
  • 如需停止进行中的任务,应先完成或上报问题

4. 更新操作按钮 🔘

待接收状态

变更前:

  • 👁️ 查看详情
  • 接收任务

变更后:

  • 👁️ 查看详情
  • 接收任务
  • 取消任务(新增,红色)

已接收状态

变更前:

  • 👁️ 查看详情
  • ▶️ 开始任务

变更后:

  • 👁️ 查看详情
  • ▶️ 开始任务
  • 取消任务(新增,红色)

进行中状态

变更前:

  • 👁️ 查看详情
  • 完成任务
  • ⚠️ 中断任务
  • 💬 上报问题

变更后:

  • 👁️ 查看详情
  • 完成任务
  • 💬 上报问题

移除了: ⚠️ 中断任务按钮

5. 更新状态颜色 🎨

状态 颜色 CSS类 说明
待接收 灰色 bg-gray-100 text-gray-700 等待接收
已接收 蓝色 bg-blue-100 text-blue-700 已确认
进行中 绿色 bg-green-100 text-green-700 执行中
已完成 紫色 bg-purple-100 text-purple-700 已完成
已中断 橙色 已移除 已移除
已取消 红色 bg-red-100 text-red-700 已取消

6. 更新样例数据 📊

变更内容:

  • 将原"已暂停"状态的 Task-7 改为"进行中"
  • 该任务保留问题上报记录,演示进行中任务的问题处理

Task-7 变更:

# 变更前
状态: 已暂停
说明: 有问题上报,任务暂停

# 变更后
状态: 进行中
说明: 有问题上报,但任务继续进行

📁 修改文件清单

核心代码文件

  1. /types/driver.ts

    • 更新 TaskStatus 类型定义
    • 移除"已中断"状态
  2. /components/machinery/driver/DriverTask.tsx

    • 添加 handleCancelTask 取消任务函数
    • 更新 getStatusColor 状态颜色函数(移除已中断)
    • 更新待接收状态操作按钮(添加取消)
    • 更新已接收状态操作按钮(添加取消)
    • 更新进行中状态操作按钮(移除中断)
    • 更新样例数据Task-7 从已暂停改为进行中)

文档文件

以下文档需要参考本更新说明进行理解:

  • /components/machinery/driver/TASK_MANAGEMENT_GUIDE.md
  • /components/machinery/driver/TASK_QUICK_START.md
  • /components/machinery/driver/TASK_SAMPLE_DATA.md
  • /DRIVER_TASK_FEATURE_CHECK.md

🎯 功能对比

取消 vs 中断

特性 取消任务 中断任务(已移除)
适用状态 待接收、已接收 进行中
使用场景 任务分配错误、计划变更 遇到问题临时停止
是否可恢复 不可恢复 可以继续
确认机制 需要确认 需要确认
颜色标识 红色 橙色
当前状态 保留 已移除

优化后的优势

状态更清晰

  • 减少状态数量从6个减少到5个
  • 状态含义更明确

操作更直观

  • 取消按钮用红色醒目标识
  • 操作位置更合理

流程更简洁

  • 减少不必要的状态流转
  • 降低用户学习成本

安全性提升

  • 取消操作需要二次确认
  • 避免误操作

🚀 使用指南

如何取消任务

场景1: 取消待接收任务

1. 在任务列表中找到待接收的任务
2. 点击红色的 ❌ 图标(取消按钮)
3. 弹出确认提示:"确定要取消任务 T202510160001 吗?取消后将无法恢复。"
4. 点击"确定"
5. 任务状态变为"已取消"(红色标签)
6. 系统提示:"任务状态更新成功"

适用场景:

  • 任务分配错误,需要重新分配
  • 驾驶员请假,无法执行
  • 天气原因,任务取消
  • 计划变更,任务不再需要

场景2: 取消已接收任务

1. 在任务列表中找到已接收的任务
2. 点击红色的 ❌ 图标(取消按钮)
3. 确认取消
4. 任务状态变为"已取消"

适用场景:

  • 驾驶员确认后发现无法执行
  • 农机设备故障,无法作业
  • 紧急情况需要终止
  • 其他不可抗力因素

进行中任务如何处理

问题: 进行中的任务没有取消按钮,如何停止?

方案1: 完成任务

点击"完成"按钮 → 任务标记为已完成

适用于:任务已经完成或大部分完成

方案2: 上报问题

点击"上报问题" → 填写问题详情 → 提交

适用于:遇到问题需要处理,任务继续进行

方案3: 联系管理员

联系系统管理员 → 从后台修改任务状态

适用于:特殊情况需要强制停止

为什么进行中任务不能取消?

🔐 安全考虑:

  • 任务已经开始执行,贸然取消可能造成数据不完整
  • 实际工时已经产生,需要有记录
  • 避免驾驶员误操作

最佳实践:

  • 进行中的任务应该正常完成
  • 如遇问题,通过"上报问题"功能处理
  • 管理员可以在问题管理中查看和处理

📊 状态统计更新

任务列表顶部的统计卡片保持不变:

  • 任务总数
  • 待接收
  • 进行中
  • 已完成
  • 有问题

已取消任务不单独统计,计入总数中。

⚠️ 注意事项

数据兼容性

向后兼容

  • 如果现有数据中有"已中断"状态的任务
  • 系统会正常显示,使用灰色默认颜色
  • 建议手动修改为"已完成"或"已取消"

操作提示

⚠️ 取消任务

  • 取消操作不可逆,请谨慎操作
  • 取消前会有确认提示
  • 取消后任务无法恢复

⚠️ 进行中任务

  • 进行中任务无法直接取消
  • 如需停止,请先完成或上报问题
  • 特殊情况联系管理员处理

🎓 培训要点

告知用户

  1. 状态变更

    • "已中断"状态已移除
    • 新增取消任务功能
  2. 操作变化

    • 待接收和已接收任务可以取消
    • 取消按钮为红色 图标
    • 进行中任务无取消按钮
  3. 使用建议

    • 仔细检查后再点击取消
    • 注意确认提示内容
    • 进行中任务不要随意操作

常见问题解答

Q1: 为什么去掉了"已中断"状态? A: 简化状态流转,"已中断"与"已取消"功能重叠,使用频率低。

Q2: 进行中的任务如何停止? A: 正常完成或上报问题,特殊情况联系管理员。

Q3: 取消后能恢复吗? A: 不能,取消操作不可逆,请谨慎操作。

Q4: 什么时候应该取消任务? A: 任务分配错误、计划变更、不可抗力等情况下使用。

Q5: 原来"已暂停"的样例任务哪去了? A: 改为"进行中"状态,保留问题上报记录。

📈 后续优化建议

短期优化

  • 添加取消原因字段
  • 记录取消操作人和时间
  • 取消任务时保存备注

中期优化

  • 支持批量取消任务
  • 取消任务的撤销功能(时间窗口内)
  • 取消任务的统计分析

长期优化

  • 取消任务的审批流程
  • 基于取消原因的智能建议
  • 自动识别可取消任务

验证清单

更新后请验证:

  • 待接收任务显示取消按钮(红色)
  • 已接收任务显示取消按钮(红色)
  • 进行中任务不显示取消按钮
  • 进行中任务不显示中断按钮
  • 点击取消按钮出现确认提示
  • 确认取消后任务变为已取消状态
  • 已取消任务显示红色标签
  • Task-7 样例任务状态为进行中
  • 状态颜色显示正确
  • 操作流程顺畅

📚 相关文档

  • 任务管理指南: /components/machinery/driver/TASK_MANAGEMENT_GUIDE.md
  • 快速开始: /components/machinery/driver/TASK_QUICK_START.md
  • 样例数据说明: /components/machinery/driver/TASK_SAMPLE_DATA.md
  • 问题管理: /ISSUE_MANAGEMENT_UPDATE.md

🎉 总结

本次更新通过:

去掉"已中断"状态 - 简化状态流转
添加取消任务功能 - 待接收和已接收可取消
优化操作按钮 - 更直观的红色取消按钮
增强安全性 - 二次确认避免误操作

实现了更简洁、更安全、更易用的任务管理流程!


更新人: AI助手
更新日期: 2025-10-16
版本: v1.3
影响范围: 驾驶员任务管理模块