package cn.iocoder.yudao.module.mes.service.qc.template;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mes.controller.admin.qc.template.vo.item.MesQcTemplateItemPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.qc.template.vo.item.MesQcTemplateItemSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.qc.template.MesQcTemplateItemDO;
|
import cn.iocoder.yudao.module.mes.enums.qc.MesQcTypeEnum;
|
import jakarta.validation.Valid;
|
|
import java.util.List;
|
|
/**
|
* MES 质检方案-产品关联 Service 接口
|
*
|
* @author 超级管理员
|
*/
|
public interface MesQcTemplateItemService {
|
|
/**
|
* 创建产品关联
|
*
|
* @param createReqVO 创建信息
|
* @return 编号
|
*/
|
Long createTemplateItem(@Valid MesQcTemplateItemSaveReqVO createReqVO);
|
|
/**
|
* 更新产品关联
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateTemplateItem(@Valid MesQcTemplateItemSaveReqVO updateReqVO);
|
|
/**
|
* 删除产品关联
|
*
|
* @param id 编号
|
*/
|
void deleteTemplateItem(Long id);
|
|
/**
|
* 获得产品关联
|
*
|
* @param id 编号
|
* @return 产品关联
|
*/
|
MesQcTemplateItemDO getTemplateItem(Long id);
|
|
/**
|
* 获得产品关联分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 产品关联分页
|
*/
|
PageResult<MesQcTemplateItemDO> getTemplateItemPage(MesQcTemplateItemPageReqVO pageReqVO);
|
|
/**
|
* 根据方案编号删除所有产品关联
|
*
|
* @param templateId 质检方案编号
|
*/
|
void deleteTemplateItemByTemplateId(Long templateId);
|
|
/**
|
* 根据产品物料 ID 和 QC 类型查找检验模板的产品关联（必须存在，否则抛异常）
|
*
|
* @param itemId 产品物料 ID
|
* @param qcType 检测种类（枚举 {@link MesQcTypeEnum}）
|
* @return 匹配的产品关联
|
*/
|
MesQcTemplateItemDO getRequiredTemplateByItemIdAndType(Long itemId, Integer qcType);
|
|
/**
|
* 根据产品物料（或工单/任务）和 QC 类型，获取所有可用的质检方案产品关联列表
|
*
|
* @param itemId 产品物料 ID（mes_md_item.id）；与 workOrderId/taskId 至少其一
|
* @param qcType 检测种类（枚举 {@link MesQcTypeEnum}）
|
* @param workOrderId 生产工单 ID（可选，IPQC 场景用于解析产品物料）
|
* @param taskId 生产任务 ID（可选，优先用于解析产品物料）
|
* @return 匹配的产品关联列表（保持原顺序），无匹配返回空列表
|
*/
|
List<MesQcTemplateItemDO> getTemplateItemList(Long itemId, Integer qcType, Long workOrderId, Long taskId);
|
|
}
|
