package com.ruoyi.device.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.common.core.domain.Result;
import com.ruoyi.device.dto.DeviceMaintenancePlanDetailsDto;
import com.ruoyi.device.dto.DeviceMaintenancePlanDto;
import com.ruoyi.device.pojo.Device;
import com.ruoyi.device.pojo.DeviceMaintenanceAttachment;
import com.ruoyi.device.pojo.DeviceMaintenancePlan;
import com.ruoyi.device.pojo.DeviceMaintenancePlanDetails;
import org.springframework.web.multipart.MultipartFile;

import jakarta.servlet.http.HttpServletResponse;
import java.time.LocalDate;
import java.util.List;

/**
 * <p>
 * 设备保养计划表 服务类
 * </p>
 *
 * @author 江苏鵷雏网络科技有限公司
 * @since 2024-12-16 06:10:52
 */
public interface DeviceMaintenancePlanService extends IService<DeviceMaintenancePlan> {

    /**
     * 分页查询设备保养计划
     * @param page 当前页
     * @param deviceMaintenancePlanDto 设备保养计划
     * @return
     */
    Result<IPage<DeviceMaintenancePlan>> selectDeviceMaintenancePlanByPage(Page page, DeviceMaintenancePlanDto deviceMaintenancePlanDto);

    /**
     * 新增设备保养计划
     *
     * @param deviceMaintenancePlanDto 设备保养计划
     */
    Result addMaintenancePlan(DeviceMaintenancePlanDto deviceMaintenancePlanDto);

    /**
     * 修改设备保养计划
     *
     * @param deviceMaintenancePlanDto 设备保养计划
     */
    Result updateMaintenancePlan(DeviceMaintenancePlanDto deviceMaintenancePlanDto);

    /**
     * 删除设备保养计划
     * @param deviceMaintenancePlanDto 设备保养计划
     */
    Result deleteMaintenancePlan(DeviceMaintenancePlanDto deviceMaintenancePlanDto);

    /**
     * 导出设备保养计划
     *
     * @param maintenancePlanId 设备保养计划id
     * @param response          响应
     */
    Result exportDeviceMaintenancePlanDto(Integer maintenancePlanId, HttpServletResponse response);

    /**
     * 查看设备保养计划详情
     * @param maintenancePlanId 设备保养计划id
     * @return
     */
    Result<DeviceMaintenancePlanDto> getMaintenancePlanDetail(Integer maintenancePlanId);

    /**
     * 提交审核
     * @param deviceMaintenancePlanDto
     * @return
     */
    Result submitReviewMaintenancePlanStatus(DeviceMaintenancePlanDto deviceMaintenancePlanDto);

    /**
     * 审核设备保养计划状态
     * @param deviceMaintenancePlanDto 设备保养计划
     * @return
     */
    Result reviewMaintenancePlanStatus(DeviceMaintenancePlanDto deviceMaintenancePlanDto);

    /**
     * 按年份查询设备保养计划（不存在则自动创建），并自动补全已到点的设备明细
     * @param planYear 计划年份
     * @return 设备保养计划
     */
    DeviceMaintenancePlanDto getOrCreatePlanByYear(String planYear);

    /**
     * 保养计划年份列表：删除没有任何明细的空年份计划后，返回有明细的年份（倒序）
     * @return 年份列表
     */
    List<String> getMaintenancePlanYears();

    /**
     * 设备档案变更后，立即把设备登记到下次保养日期所在年份的设备保养计划明细
     * @param device 设备
     */
    void syncDeviceMaintenanceDetail(Device device);

    /**
     * 审核通过后，按审核通过当天滚动设备档案的最近/下次保养日期
     * @param deviceId 设备id
     * @param maintenanceDate 保养完成日期（审核通过当天）
     */
    void updateDeviceMaintenanceDate(Integer deviceId, LocalDate maintenanceDate);

    /**
     * 审核通过后，把计划明细归到审核完成年份的计划下（提前完成的明细不再留在原计划年份）
     * @param maintenancePlanDetailId 保养计划明细id
     * @param reviewDate 审核完成日期
     */
    void reclassifyMaintenanceDetailByReviewDate(Integer maintenancePlanDetailId, LocalDate reviewDate);

    /**
     * 分页查询设备保养计划详情（含到点标红）
     */
    IPage<DeviceMaintenancePlanDetailsDto> pageMaintenancePlanDetail(Page page, Integer planId, String deviceName, String deviceNumber);

    /**
     * 为保养记录找一条可关联的计划明细；没有可用明细时在当前年度计划新增本轮明细
     * @param deviceId 设备id
     * @param maintenancePlanDetailId 指定的计划明细id，为空则自动匹配
     * @param maintenanceDate 保养日期
     */
    DeviceMaintenancePlanDetails resolveMaintenancePlanDetail(Integer deviceId, Integer maintenancePlanDetailId, LocalDate maintenanceDate);

    /**
     * 修改设备保养计划详情（已审核的明细不允许修改）
     */
    boolean updateMaintenancePlanDetail(DeviceMaintenancePlanDetails detail);

    /**
     * 删除设备保养计划详情；已出审核结果的记录随历史留档，未审核的记录随明细一起删除
     */
    boolean removeMaintenancePlanDetail(Integer maintenancePlanDetailId);

    /**
     * 查询计划明细附件列表
     */
    List<DeviceMaintenanceAttachment> selectAttachments(Integer maintenancePlanDetailId);

    /**
     * 上传计划明细附件
     */
    DeviceMaintenanceAttachment uploadAttachment(Integer maintenancePlanDetailId, MultipartFile file);

    /**
     * 删除计划明细附件
     */
    boolean deleteAttachment(Long id);
}