package com.aucma.dms.service;

import com.aucma.dms.domain.DmsRepairWorkOrder;

import java.util.List;

/**
 * 维修工单Service接口
 * 
 * @author Cascade AI
 * @date 2025-01-10
 */
public interface IDmsRepairWorkOrderService {
    
    /**
     * 查询维修工单
     * 
     * @param workOrderId 维修工单主键
     * @return 维修工单
     */
    DmsRepairWorkOrder selectDmsRepairWorkOrderByWorkOrderId(Long workOrderId);

    /**
     * 查询维修工单列表
     * 
     * @param dmsRepairWorkOrder 维修工单
     * @return 维修工单集合
     */
    List<DmsRepairWorkOrder> selectDmsRepairWorkOrderList(DmsRepairWorkOrder dmsRepairWorkOrder);

    /**
     * 新增维修工单（含工程和材料）
     * 
     * @param dmsRepairWorkOrder 维修工单
     * @return 结果
     */
    int insertDmsRepairWorkOrder(DmsRepairWorkOrder dmsRepairWorkOrder);

    /**
     * 修改维修工单（含工程和材料）
     * 
     * @param dmsRepairWorkOrder 维修工单
     * @return 结果
     */
    int updateDmsRepairWorkOrder(DmsRepairWorkOrder dmsRepairWorkOrder);

    /**
     * 批量删除维修工单
     * 
     * @param workOrderIds 需要删除的维修工单主键集合
     * @return 结果
     */
    int deleteDmsRepairWorkOrderByWorkOrderIds(Long[] workOrderIds);

    /**
     * 删除维修工单信息
     * 
     * @param workOrderId 维修工单主键
     * @return 结果
     */
    int deleteDmsRepairWorkOrderByWorkOrderId(Long workOrderId);

    /**
     * 派工
     * 
     * @param dmsRepairWorkOrder 维修工单（含executorId、executorName）
     * @return 结果
     */
    int dispatchWorkOrder(DmsRepairWorkOrder dmsRepairWorkOrder);

    /**
     * 开始维修
     * 
     * @param workOrderId 维修工单ID
     * @return 结果
     */
    int startWorkOrder(Long workOrderId);

    /**
     * 完成维修
     * 
     * @param dmsRepairWorkOrder 维修工单（含repairResult、actualCost等）
     * @return 结果
     */
    int completeWorkOrder(DmsRepairWorkOrder dmsRepairWorkOrder);

    /**
     * 审批
     * 
     * @param dmsRepairWorkOrder 维修工单（含approveStatus、approver、approveRemark）
     * @return 结果
     */
    int approveWorkOrder(DmsRepairWorkOrder dmsRepairWorkOrder);

    /**
     * 根据故障报修ID查询维修工单
     * 
     * @param faultInstanceId 故障报修ID
     * @return 维修工单
     */
    DmsRepairWorkOrder selectByFaultInstanceId(Long faultInstanceId);
}
