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

## 功能概述

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

## 主要功能

### 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. 数据库初始化
```sql
-- 执行表结构创建脚本
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. 填写任务信息：
   - 任务类型：选择维修保养、加油任务或其他
   - 任务描述：详细描述任务内容
   - 出发地址：任务起始地点
   - 目的地址：任务目标地点
   - 计划时间：设置计划开始和结束时间
   - 执行人：选择任务执行人
   - 备注：其他说明信息
4. 点击"确定"保存

### 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. **状态变更失败**：检查状态流转规则是否允许

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

## 技术支持

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