转运任务取消原因功能实现说明

一、功能概述

为转运任务增加取消原因记录功能,当用户取消任务时,需要选择取消原因并记录取消人和取消时间。

二、数据库变更

2.1 sys_task_emergency表增加三个字段

执行SQL脚本：sql/add_cancel_reason_fields.sql

ALTER TABLE sys_task_emergency 
ADD COLUMN cancel_reason VARCHAR(50) COMMENT '取消原因（关联数据字典task_cancel_reason）';

ALTER TABLE sys_task_emergency 
ADD COLUMN cancel_by VARCHAR(64) COMMENT '取消人';

ALTER TABLE sys_task_emergency 
ADD COLUMN cancel_time DATETIME COMMENT '取消时间';

2.2 数据字典配置

执行SQL脚本：sql/insert_dict_task_cancel_reason.sql

添加数据字典类型 task_cancel_reason，包含26个取消原因选项：

价格不接受
时间紧急
出车速度慢
选择其他车
病人没有生命体征
医生护士均不足
病人情况有变
其他
第三方取消
测试订单
传染性疾病
家属挂机/拒接/不接电话
护士不足
医生不足
设备不足（呼吸机）
家属没联系好床位
移交分支机构执行
移交办事处（湛江）
移交办事处（茂名）
家属不肯透露信息
所在医院/目的地医院派车
自驾车接送患者
选择其他机构车辆
外联通知取消
外联无反馈
家属无原因直接告知取消

三、后端修改

3.1 实体类修改

文件: ruoyi-system/src/main/java/com/ruoyi/system/domain/SysTaskEmergency.java

添加三个字段属性：
- private String cancelReason; - 取消原因
- private String cancelBy; - 取消人
- private java.util.Date cancelTime; - 取消时间

3.2 Mapper XML修改

文件: ruoyi-system/src/main/resources/mapper/system/SysTaskEmergencyMapper.xml

在resultMap、selectSysTaskEmergencyVo、insertSysTaskEmergency、updateSysTaskEmergency中添加三个字段的映射和处理。

3.3 控制器修改

文件: ruoyi-admin/src/main/java/com/ruoyi/web/controller/task/SysTaskController.java

3.3.1 ChangeStatusRequest增加字段

private String cancelReason;  // 取消原因（关联数据字典task_cancel_reason）

3.3.2 修改appChangeTaskStatus方法

在状态变更方法中添加取消原因处理逻辑：

// 如果是取消状态，保存取消原因
if (newStatus == TaskStatus.CANCELLED && StringUtils.isNotEmpty(request.getCancelReason())) {
    sysTaskService.saveCancelInfo(taskId, request.getCancelReason());
}

3.4 服务层修改

文件: ruoyi-system/src/main/java/com/ruoyi/system/service/ISysTaskService.java

添加接口方法：

/**
 * 保存任务取消信息（仅限转运任务）
 * 
 * @param taskId 任务ID
 * @param cancelReason 取消原因（数据字典task_cancel_reason的value）
 * @return 结果
 */
public int saveCancelInfo(Long taskId, String cancelReason);

文件: ruoyi-system/src/main/java/com/ruoyi/system/service/impl/SysTaskServiceImpl.java

实现saveCancelInfo方法，保存取消原因、取消人和取消时间：

@Override
@Transactional
public int saveCancelInfo(Long taskId, String cancelReason) {
    // 获取任务信息
    SysTask task = sysTaskMapper.selectSysTaskByTaskId(taskId);
    if (task == null) {
        throw new RuntimeException("任务不存在");
    }
    
    // 只有转运任务才保存取消信息
    if (!"EMERGENCY_TRANSFER".equals(task.getTaskType())) {
        return 0;
    }
    
    // 获取转运任务扩展信息
    SysTaskEmergency emergency = sysEmergencyTaskService.selectSysTaskEmergencyByTaskId(taskId);
    if (emergency == null) {
        return 0;
    }
    
    // 设置取消信息
    emergency.setCancelReason(cancelReason);
    emergency.setCancelBy(SecurityUtils.getUsername());
    emergency.setCancelTime(DateUtils.getNowDate());
    emergency.setUpdateBy(SecurityUtils.getUsername());
    emergency.setUpdateTime(DateUtils.getNowDate());
    
    // 更新数据库
    return sysTaskEmergencyMapper.updateSysTaskEmergency(emergency);
}

四、前端修改

4.1 任务详情页修改

文件: app/pagesTask/detail.vue

4.1.1 data中添加字段

data() {
  return {
    taskDetail: null,
    taskId: null,
    paymentInfo: null,
    cancelReasonList: [],      // 取消原因列表
    showCancelDialog: false,   // 显示取消原因对话框
    selectedCancelReason: ''   // 选中的取消原因
  }
}

4.1.2 onLoad中加载字典

onLoad(options) {
  this.taskId = options.id
  this.loadTaskDetail()
  this.loadCancelReasonDict() // 加载取消原因字典
}

4.1.3 修改取消按钮处理逻辑

case 'cancel':
  // 取消 -> 显示取消原因选择对话框
  this.showCancelReasonDialog();
  break;

4.1.4 添加方法

loadCancelReasonDict() - 从后端加载取消原因字典
showCancelReasonDialog() - 显示取消原因选择弹窗
confirmCancelTask() - 确认取消任务
closeCancelDialog() - 关闭取消弹窗
selectCancelReason(e) - 选择取消原因
updateTaskStatusWithCancelReason() - 带取消原因的状态更新
getCancelReasonLabel() - 根据value获取label显示

4.1.5 修改getLocationAndUpdateStatus方法

添加cancelReason参数，在状态更新请求中传递取消原因：

// 如果有取消原因，添加到请求数据中
if (cancelReason) {
  statusData.cancelReason = cancelReason
}

4.1.6 添加UI组件

取消原因选择弹窗：

<uni-popup ref="cancelPopup" type="center" :is-mask-click="false">
  <view class="cancel-dialog">
    <view class="dialog-title">请选择取消原因</view>
    <picker mode="selector" :range="cancelReasonList" range-key="label" @change="selectCancelReason">
      <view class="reason-picker">
        <view class="picker-label">取消原因</view>
        <view class="picker-value">
          {{ selectedCancelReason ? cancelReasonList.find(r => r.value === selectedCancelReason)?.label : '请选择' }}
        </view>
        <uni-icons type="arrowright" size="16"></uni-icons>
      </view>
    </picker>
    <view class="dialog-buttons">
      <button class="cancel-btn" @click="closeCancelDialog">取消</button>
      <button class="confirm-btn" @click="confirmCancelTask">确定</button>
    </view>
  </view>
</uni-popup>

取消信息显示区域（仅在任务已取消且有取消原因时显示）：

<view class="detail-section" v-if="taskDetail.taskStatus === 'CANCELLED' && taskDetail.emergencyInfo && taskDetail.emergencyInfo.cancelReason">
  <view class="section-title">取消信息</view>
  <view class="info-item">
    <view class="label">取消原因</view>
    <view class="value">{{ getCancelReasonLabel(taskDetail.emergencyInfo.cancelReason) }}</view>
  </view>
  <view class="info-item" v-if="taskDetail.emergencyInfo.cancelBy">
    <view class="label">取消人</view>
    <view class="value">{{ taskDetail.emergencyInfo.cancelBy }}</view>
  </view>
  <view class="info-item" v-if="taskDetail.emergencyInfo.cancelTime">
    <view class="label">取消时间</view>
    <view class="value">{{ formatTime(taskDetail.emergencyInfo.cancelTime) }}</view>
  </view>
</view>

4.1.7 添加样式

为取消原因弹窗添加样式，包括对话框、选择器和按钮样式。

五、使用流程

5.1 取消任务流程

用户在任务详情页点击"取消"按钮
系统弹出取消原因选择对话框
用户从26个预设选项中选择取消原因
用户点击"确定"按钮
系统调用状态更新接口，传递取消原因
后端保存取消原因、取消人（当前用户）和取消时间（当前时间）
任务状态变更为"已取消"

5.2 查看取消信息

在任务详情页，如果任务状态为"已取消"且记录了取消原因，会在费用信息下方显示"取消信息"区块，包括：
- 取消原因（显示中文标签）
- 取消人
- 取消时间

六、注意事项

仅限转运任务：取消原因功能仅对转运任务（EMERGENCY_TRANSFER）生效
强制选择：取消任务时必须选择取消原因，否则无法提交
自动记录：取消人和取消时间由系统自动记录，无需用户输入
不可修改：取消信息一旦保存不可修改
数据字典依赖：需要先执行数据字典SQL脚本，否则前端无法加载取消原因列表

七、文件清单

SQL文件

sql/add_cancel_reason_fields.sql - 添加数据库字段
sql/insert_dict_task_cancel_reason.sql - 插入数据字典

后端文件

ruoyi-system/src/main/java/com/ruoyi/system/domain/SysTaskEmergency.java
ruoyi-system/src/main/resources/mapper/system/SysTaskEmergencyMapper.xml
ruoyi-system/src/main/java/com/ruoyi/system/service/ISysTaskService.java
ruoyi-system/src/main/java/com/ruoyi/system/service/impl/SysTaskServiceImpl.java
ruoyi-admin/src/main/java/com/ruoyi/web/controller/task/SysTaskController.java

前端文件

app/pagesTask/detail.vue

八、测试建议

测试取消原因弹窗是否正常显示
测试选择不同取消原因后是否正确保存
测试未选择取消原因时是否阻止提交
测试取消信息是否正确显示
测试非转运任务点击取消是否正常（不应显示取消原因弹窗）
测试已取消的任务是否正确显示取消信息