package cn.iocoder.yudao.module.erp.service.product.mapping;

/**
 * ERP 产品与 MDM 物料映射服务接口
 *
 * 说明：本项目物料统一使用 MDM 主数据管理，ERP 产品需要与 MDM 物料建立映射关系。
 * 映射策略：通过 ERP 产品条码(barCode) 与 MDM 物料编码(code) 或条码进行关联。
 */
public interface ErpMdmMappingService {

    /**
     * 根据 ERP 产品 ID 获取 MDM 物料 ID
     *
     * 映射策略：
     * 1. 查询 ERP 产品的 barCode
     * 2. 通过 barCode 匹配 MDM 物料编码(code) 或条码
     *
     * @param erpProductId ERP 产品 ID
     * @return MDM 物料 ID，未找到返回 null
     */
    Long getMdmItemId(Long erpProductId);

    /**
     * 根据 ERP 产品条码获取 MDM 物料 ID
     *
     * @param barCode ERP 产品条码
     * @return MDM 物料 ID，未找到返回 null
     */
    Long getMdmItemIdByBarCode(String barCode);

    /**
     * 根据 ERP 仓库 ID 获取 MES 仓库 ID
     *
     * 映射策略：通过仓库名称精确匹配 MES 仓库
     *
     * @param erpWarehouseId ERP 仓库 ID
     * @return MES 仓库 ID，未找到返回 null
     */
    Long getMesWarehouseId(Long erpWarehouseId);

    /**
     * 根据 ERP 仓库名称获取 MES 仓库 ID
     *
     * @param erpWarehouseName ERP 仓库名称
     * @return MES 仓库 ID，未找到返回 null
     */
    Long getMesWarehouseIdByName(String erpWarehouseName);

}