klp-oa/klp-erp/src/main/java/com/klp/erp/mapper/ErpPurchasePlanMapper.java

package com.klp.erp.mapper;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.klp.common.core.mapper.BaseMapperPlus;
import com.klp.erp.domain.ErpPurchasePlan;
import com.klp.erp.domain.vo.ErpContractOptionVo;
import com.klp.erp.domain.vo.ErpPurchasePlanItemVo;
import com.klp.erp.domain.vo.ErpPurchasePlanVo;
import org.apache.ibatis.annotations.Param;

import java.util.Collection;
import java.util.List;

/**
 * 采购计划头Mapper接口
 *
 * @author klp
 * @date 2026-06-22
 */
public interface ErpPurchasePlanMapper extends BaseMapperPlus<ErpPurchasePlanMapper, ErpPurchasePlan, ErpPurchasePlanVo> {

    /**
     * 根据销售合同ID查询合同编号（crm_order，同库跨表）
     */
    List<String> selectOrderCodes(@Param("ids") List<Long> ids);

    /**
     * 按销售合同ID批量取明细，映射为采购计划明细（来自 crm_order_item）。
     * 用于「选合同自动带出明细」：1/2/3合同 -> 1/2/3/4明细。
     */
    List<ErpPurchasePlanItemVo> selectItemsByOrderIds(@Param("ids") List<Long> ids);

    /**
     * 合同列表分页：crm_order + 该合同已挂接的采购计划数。
     */
    Page<ErpContractOptionVo> selectContractPage(IPage<ErpContractOptionVo> page, @Param("kw") String kw);

    /**
     * 某合同下的所有采购计划（经中间表挂接）。
     */
    List<ErpPurchasePlanVo> selectPlansByContract(@Param("orderId") Long orderId);

    /**
     * 按合同关键字（订单编号/合同号/合同名称）查出关联的采购计划ID，用于综合搜索。
     */
    List<Long> selectPlanIdsByContractKeyword(@Param("kw") String kw);

    /**
     * 在 WMS 钢卷表(wms_material_coil)中查出已存在且非占位(data_type<>10)的厂家卷号集合，
     * 用于判定上传到货行的卷号是否已实际到货入库。
     */
    List<String> selectExistingSupplierCoilNos(@Param("coilNos") Collection<String> coilNos);
}