package cn.iocoder.yudao.module.mes.service.md.item;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.bom.MesMdProductBomImportExcelVO;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.bom.MesMdProductBomImportRespVO;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.bom.MesMdProductBomPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.md.item.vo.bom.MesMdProductBomSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.md.item.MesMdProductBomDO;
import jakarta.validation.Valid;

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

/**
 * MES 产品BOM Service 接口
 *
 * @author 超级管理员
 */
public interface MesMdProductBomService {

    /**
     * 创建产品BOM
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createProductBom(@Valid MesMdProductBomSaveReqVO createReqVO);

    /**
     * 更新产品BOM
     *
     * @param updateReqVO 更新信息
     */
    void updateProductBom(@Valid MesMdProductBomSaveReqVO updateReqVO);

    /**
     * 删除产品BOM
     *
     * @param id 编号
     */
    void deleteProductBom(Long id);

    /**
     * 获得产品BOM
     *
     * @param id 编号
     * @return 产品BOM
     */
    MesMdProductBomDO getProductBom(Long id);

    /**
     * 获得产品BOM分页
     *
     * @param pageReqVO 分页查询
     * @return 产品BOM分页
     */
    PageResult<MesMdProductBomDO> getProductBomPage(MesMdProductBomPageReqVO pageReqVO);

    /**
     * 根据物料产品编号获得产品BOM列表
     *
     * @param itemId 物料产品编号
     * @return 产品BOM列表
     */
    List<MesMdProductBomDO> getProductBomListByItemId(Long itemId);

    /**
     * 根据物料产品编号批量获得产品BOM列表
     *
     * @param itemIds 物料产品编号数组
     * @return 产品BOM列表
     */
    List<MesMdProductBomDO> getProductBomListByItemIds(Collection<Long> itemIds);

    /**
     * 根据物料产品编号删除产品BOM
     *
     * @param itemId 物料产品编号
     */
    void deleteProductBomByItemId(Long itemId);

    /**
     * 导入产品 BOM（按父项/子项物料编码匹配，已存在的父子组合默认跳过，支持勾选更新用量）
     *
     * @param importList       导入数据
     * @param updateSupport    是否更新已存在的父子组合
     * @return 导入结果
     */
    MesMdProductBomImportRespVO importProductBomList(List<MesMdProductBomImportExcelVO> importList,
                                                     Boolean updateSupport);

}