package cn.iocoder.yudao.module.mes.service.wm.outsourcereceipt;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.wm.outsourcereceipt.vo.MesWmOutsourceReceiptPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.wm.outsourcereceipt.vo.MesWmOutsourceReceiptSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.outsourcereceipt.MesWmOutsourceReceiptDO;
import jakarta.validation.Valid;

import java.math.BigDecimal;

/**
 * MES 外协入库单 Service 接口
 */
public interface MesWmOutsourceReceiptService {

    /**
     * 创建外协入库单
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createOutsourceReceipt(@Valid MesWmOutsourceReceiptSaveReqVO createReqVO);

    /**
     * 修改外协入库单
     *
     * @param updateReqVO 修改信息
     */
    void updateOutsourceReceipt(@Valid MesWmOutsourceReceiptSaveReqVO updateReqVO);

    /**
     * 删除外协入库单（级联删除行+明细）
     *
     * @param id 编号
     */
    void deleteOutsourceReceipt(Long id);

    /**
     * 获得外协入库单
     *
     * @param id 编号
     * @return 外协入库单
     */
    MesWmOutsourceReceiptDO getOutsourceReceipt(Long id);

    /**
     * 获得外协入库单分页
     *
     * @param pageReqVO 分页参数
     * @return 外协入库单分页
     */
    PageResult<MesWmOutsourceReceiptDO> getOutsourceReceiptPage(MesWmOutsourceReceiptPageReqVO pageReqVO);

    /**
     * 提交外协入库单（草稿 → 审批中）
     *
     * @param id 编号
     */
    void submitOutsourceReceipt(Long id);

    /**
     * 执行上架（审批中 → 已审批）
     *
     * @param id 编号
     */
    void stockOutsourceReceipt(Long id);

    /**
     * 完成入库（已审批 → 已完成），更新库存台账
     *
     * @param id 编号
     */
    void finishOutsourceReceipt(Long id);

    /**
     * 取消外协入库单（任意非已完成/已取消状态 → 已取消）
     *
     * @param id 编号
     */
    void cancelOutsourceReceipt(Long id);

    /**
     * IQC 检验完成后回写外协入库单（拆分行 + 推进主表状态）
     *
     * @param receiptId           外协入库单编号
     * @param lineId              入库单行编号
     * @param iqcId               IQC 检验单编号
     * @param qualifiedQuantity   合格品数量
     * @param unqualifiedQuantity 不合格品数量
     */
    void updateOutsourceReceiptWhenIqcFinish(Long receiptId, Long lineId, Long iqcId,
                                             BigDecimal qualifiedQuantity, BigDecimal unqualifiedQuantity);

    /**
     * 校验外协入库单和行存在
     *
     * @param receiptId 入库单编号
     * @param lineId 行编号
     */
    void validateOutsourceReceiptAndLineExists(Long receiptId, Long lineId);

    /**
     * 根据供应商 ID 统计外协入库单数量
     *
     * @param vendorId 供应商 ID
     * @return 数量
     */
    Long getOutsourceReceiptCountByVendorId(Long vendorId);

}