966120
编辑 | blame | 历史 | 原始文档

通用任务管理功能使用说明

功能概述

通用任务管理功能是基于若依框架开发的完整任务管理系统，支持维修保养、加油任务、其他任务类型的全生命周期管理。

主要功能

1. 任务管理

  • 任务创建：支持创建维修保养、加油任务、其他类型任务
  • 任务查询：支持按任务编号、类型、状态、时间范围等条件查询
  • 任务编辑：支持修改任务描述、地址、时间、执行人等信息
  • 任务删除：支持单个或批量删除任务
  • 任务分配：支持将任务分配给指定执行人
  • 状态管理：支持任务状态流转（待开始→任务中→已完成，任何状态可取消）

2. 车辆管理

  • 车辆分配：支持将车辆分配给任务
  • 批量分配：支持一次性分配多辆车给任务
  • 取消分配：支持取消车辆与任务的关联
  • 车辆查询：支持查询可用车辆列表

3. 附件管理

  • 文件上传：支持上传任务相关附件（PDF、DOC、图片等）
  • 文件下载：支持下载已上传的附件
  • 文件删除：支持删除不需要的附件

4. 操作日志

  • 日志记录：自动记录所有任务操作日志
  • 日志查询：支持查看任务的操作历史
  • 操作追踪：记录操作人、操作时间、操作内容等详细信息

5. 统计功能

  • 任务统计：提供任务总数、各状态任务数量、超时任务等统计信息
  • 我的任务：支持查看当前用户创建或分配的任务
  • 超时提醒：自动识别和提醒超时任务

数据库表结构

核心表

  1. sys_task - 任务主表
  2. sys_task_vehicle - 任务车辆关联表
  3. sys_task_attachment - 任务附件表
  4. sys_task_log - 任务操作日志表

数据字典

  • sys_task_type - 任务类型字典
  • sys_task_status - 任务状态字典
  • sys_vehicle_type - 车辆类型字典
  • sys_vehicle_status - 车辆状态字典
  • sys_task_vehicle_status - 任务车辆关联状态字典

部署步骤

1. 数据库初始化

-- 执行表结构创建脚本
source sql/task_tables.sql;

-- 执行数据字典初始化脚本
source sql/task_dict_data.sql;

-- 执行菜单权限初始化脚本
source sql/task_menu.sql;

2. 后端部署

  1. 确保所有Java文件已正确放置到对应目录
  2. 重新编译项目：mvn clean compile
  3. 重启应用服务

3. 前端部署

  1. 确保所有Vue文件已正确放置到对应目录
  2. 重新构建前端：npm run build:prod
  3. 部署到Web服务器

4. 权限配置

  1. 登录系统管理后台
  2. 进入"系统管理" → "菜单管理"
  3. 确认任务管理相关菜单已正确创建
  4. 为相应角色分配任务管理权限

API接口说明

任务管理接口

  • GET /task/list - 查询任务列表
  • GET /task/{taskId} - 获取任务详情
  • POST /task - 创建任务
  • PUT /task - 更新任务
  • DELETE /task/{taskIds} - 删除任务
  • PUT /task/{taskId}/assign - 分配任务
  • PUT /task/{taskId}/status - 更新任务状态

车辆管理接口

  • GET /task/vehicle/list/{taskId} - 查询任务关联车辆
  • GET /task/vehicle/available - 查询可用车辆
  • POST /task/vehicle/assign/{taskId} - 分配车辆
  • POST /task/vehicle/assign-batch/{taskId} - 批量分配车辆
  • DELETE /task/vehicle/{taskId}/{vehicleId} - 取消车辆分配

附件管理接口

  • GET /task/attachment/list/{taskId} - 查询任务附件
  • POST /task/attachment/upload/{taskId} - 上传附件
  • DELETE /task/attachment/{attachmentId} - 删除附件

统计接口

  • GET /task/statistics - 获取任务统计信息
  • GET /task/overdue - 获取超时任务列表
  • GET /task/my - 获取我的任务列表

使用说明

1. 创建任务

  1. 进入"任务管理" → "通用任务"
  2. 点击"新增"按钮
  3. 填写任务信息：
  • 任务类型：选择维修保养、加油任务或其他
  • 任务描述：详细描述任务内容
  • 出发地址：任务起始地点
  • 目的地址：任务目标地点
  • 计划时间：设置计划开始和结束时间
  • 执行人：选择任务执行人
  • 备注：其他说明信息
  1. 点击"确定"保存

2. 分配车辆

  1. 在任务列表中点击"查看"进入任务详情
  2. 在"关联车辆"区域点击"分配车辆"
  3. 选择要分配的车辆（可多选）
  4. 填写分配备注
  5. 点击"确定"完成分配

3. 上传附件

  1. 在任务详情页面点击"上传附件"
  2. 选择要上传的文件（支持PDF、DOC、图片等格式）
  3. 文件大小不超过10MB
  4. 上传完成后可在附件列表中查看和下载

4. 状态管理

  1. 在任务列表或详情页面点击"状态变更"
  2. 选择新的任务状态
  3. 填写状态变更备注
  4. 系统会自动记录状态变更日志

权限说明

菜单权限

  • task:general:view - 任务查看权限
  • task:general:query - 任务查询权限
  • task:general:add - 任务新增权限
  • task:general:edit - 任务修改权限
  • task:general:remove - 任务删除权限
  • task:general:assign - 任务分配权限
  • task:general:status - 状态变更权限
  • task:general:export - 任务导出权限

数据权限

系统基于部门进行数据隔离，用户只能查看和操作本部门及下级部门的数据。

注意事项

  1. 任务编号：系统自动生成，格式为TASK+日期+序号
  2. 状态流转：必须按照业务规则进行状态流转，不允许跳跃式变更
  3. 文件上传：支持的文件类型和大小有限制，请按要求上传
  4. 数据备份：建议定期备份任务相关数据
  5. 性能优化：大量数据时建议使用分页查询

故障排除

常见问题

  1. 菜单不显示：检查菜单权限配置和角色分配
  2. 接口调用失败：检查后端服务是否正常启动
  3. 文件上传失败：检查文件大小和格式是否符合要求
  4. 状态变更失败：检查状态流转规则是否允许

日志查看

  • 后端日志：查看应用日志文件
  • 前端日志：打开浏览器开发者工具查看控制台
  • 数据库日志：查看数据库操作日志

技术支持

如有问题请联系系统管理员或开发团队。