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.device.dto.DeviceExaminePlanDetailsDto;
import com.ruoyi.device.dto.DeviceExaminePlanDto;
import com.ruoyi.device.pojo.Device;
import com.ruoyi.device.pojo.DeviceExamineAttachment;
import com.ruoyi.device.pojo.DeviceExaminePlan;
import com.ruoyi.device.pojo.DeviceExaminePlanDetails;
import org.springframework.web.multipart.MultipartFile;

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

/**
 * <p>
 * 设备核查计划主表 服务类
 * </p>
 *
 * @author 江苏鵷雏网络科技有限公司
 * @since 2024-12-16 07:14:04
 */
public interface DeviceExaminePlanService extends IService<DeviceExaminePlan> {

    /**
     * 新增设备核查计划
     * @param examinePlanDto
     * @return
     */
    boolean addDeviceExaminePlan(DeviceExaminePlanDto examinePlanDto);

    /**
     * 导入设备核查计划
     * @param file
     * @return
     */
    boolean importDeviceExaminePlan(MultipartFile file);

    /**
     * 提交批准
     * @param deviceExaminePlan
     * @return
     */
    boolean submitRatifyDeviceExaminePlan(DeviceExaminePlan deviceExaminePlan);

    /**
     * 设备核查计划批准
     * @param DeviceExaminePlan
     * @return
     */
    boolean ratifyDeviceExaminePlan(DeviceExaminePlan DeviceExaminePlan);

    /**
     * 设备核查计划列表
     * @param page
     * @param DeviceExaminePlan
     * @return
     */
    IPage<DeviceExaminePlanDto> pageDeviceExaminePlan(Page page, DeviceExaminePlan DeviceExaminePlan);

    /**
     * 设备核查计划详情列表
     * @param page
     * @param DeviceExaminePlanDetails
     * @return
     */
    IPage<DeviceExaminePlanDetailsDto> pageDeviceExaminePlanDetail(Page page, DeviceExaminePlanDetails DeviceExaminePlanDetails);


    /**
     * 导出设备核查计划
     * @param deviceExaminePlanId 设备核查计划id
     * @param response 响应
     */
    void exportDeviceExaminePlanDetail(Integer deviceExaminePlanId, HttpServletResponse response);

    /**
     * 批量修改设备核查计划
     * @param examinePlanDto
     * @return
     */
    boolean updateDeviceExaminePlan(DeviceExaminePlanDto examinePlanDto);

    /**
     * 查询设备核查计划详情
     * @param planId
     * @return
     */
    DeviceExaminePlanDto getDeviceExaminePlan(Integer planId);

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

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

    /**
     * 核查记录复核通过后，滚动设备档案的最近/下次核查日期，并登记下一轮计划
     * @param planDetailsId 计划明细id
     */
    void updateDeviceExamineDate(Integer planDetailsId);

    /**
     * 为指定设备找一条可录入核查记录的计划明细，没有则新增本轮明细
     * @param deviceId 设备id
     * @param checkTime 核查月份（yyyy-MM），决定明细所属的计划年份
     * @return 计划明细
     */
    DeviceExaminePlanDetails resolveExaminePlanDetail(Integer deviceId, String checkTime);

    /**
     * 查找指定设备可复用的核查记录计划明细（只查询，不新增计划或明细）
     * @param deviceId 设备id
     * @param checkTime 核查月份（yyyy-MM）
     * @return 可复用的计划明细，没有时返回 null
     */
    DeviceExaminePlanDetails findExaminePlanDetail(Integer deviceId, String checkTime);

    /**
     * 修改计划明细（核查月份跨年时归到对应年份的计划）
     * @param detail 计划明细
     * @return 是否修改成功
     */
    boolean updateExaminePlanDetail(DeviceExaminePlanDetails detail);

    /**
     * 删除计划明细（已有核查记录的不允许删除）
     * @param planDetailsId 计划明细id
     * @return 是否删除成功
     */
    boolean removeExaminePlanDetail(Integer planDetailsId);

    /**
     * 查询核查记录的附件列表
     * @param planDetailsId 计划明细id
     * @return 附件列表
     */
    List<DeviceExamineAttachment> selectAttachments(Integer planDetailsId);

    /**
     * 上传核查记录的附件（支持任意格式，可多个）
     * @param planDetailsId 计划明细id
     * @param file 文件
     * @return 附件信息
     */
    DeviceExamineAttachment uploadAttachment(Integer planDetailsId, MultipartFile file);

    /**
     * 删除核查记录的附件
     * @param id 附件id
     * @return 是否删除成功
     */
    boolean deleteAttachment(Long id);
}