krd-srm-java/src/main/java/com/xujie/modules/inspection/service/InspectionRequestService.java

package com.xujie.modules.inspection.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.xujie.common.utils.PageUtils;
import com.xujie.modules.inspection.data.*;
import com.xujie.modules.inspection.entity.InspectionRequestHeader;
import com.xujie.modules.inspection.entity.QcPersonList;
import com.xujie.modules.order.vo.PODetailVo;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.List;

/**
 * <p>
 * 检验申请单头表 服务类
 * </p>
 * @since 2026-05-21
 */
public interface InspectionRequestService extends IService<InspectionRequestHeader> {

    PageUtils myPage(InspectionRequestHeader page);

    PageUtils queryPoPage(InspectionRequestItemVO vo);

    PageUtils queryPoSupplierPage(InspectionRequestItemVO vo);

    PageUtils queryPoSupplierOrderPage(InspectionRequestItemVO vo);

    void saveRequest(InspectionRequestSaveVO vo);

    void cancel(String requestNo);

    void delete(String requestNo);

    /**
     * 确认验货申请
     */
    void confirm(String requestNo);

    /**
     * 审核验货申请
     */
    void audit(String requestNo);

    /**
     * 预览上传的 Excel 数据
     */
    List<InspectionRequestExcelDTO> previewUpload(MultipartFile file) throws IOException;

    /**
     * 批量保存上传的数据
     */
    void batchSave(MultipartFile file) throws Exception;

    PageUtils getQcPersonList(QcPersonList qc);

    void schedule(InspectionScheduleVO vo);

    List<InspectionScheduleViewVO> queryScheduleView(String qcOperator, String site, String startDate);

    void updateRequest(InspectionRequestHeader header);

    /**
     * 开始验货
     */
    void startInspection(String requestNo, Integer itemNo);

    /**
     * 刷新明细的验货结果
     * 将明细状态改为验货完成，如果所有明细都是验货完成，则主记录也改为验货完成
     */
    void refreshInspectionResult(String site, String requestNo, Integer itemNo);

    /**
     * 回滚验货结果
     * 将明细状态从验货完成回滚到验货中，如果存在未完成的明细，则主记录也回滚到验货中
     */
    void rollbackInspectionResult(String site, String requestNo, Integer itemNo);
}