package cn.iocoder.yudao.module.mes.service.qc.ncr; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrDisposeReqVO; import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrDisposeRespVO; import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrPageReqVO; import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrSaveReqVO; import cn.iocoder.yudao.module.mes.dal.dataobject.qc.ncr.MesQcNcrDO; import jakarta.validation.Valid; import java.util.Collection; import java.util.Map; /** * MES 不合格品处理单(NCR) Service 接口 * * @author 超级管理员 */ public interface MesQcNcrService { /** * 创建不合格品处理单 * * @param createReqVO 创建信息 * @return 编号 */ Long createNcr(@Valid MesQcNcrSaveReqVO createReqVO); /** * 更新不合格品处理单 * * @param updateReqVO 更新信息 */ void updateNcr(@Valid MesQcNcrSaveReqVO updateReqVO); /** * 删除不合格品处理单 * * @param id 编号 */ void deleteNcr(Long id); /** * 评审不合格品处理单 * * @param id 编号 * @param disposition 处置方式 * @param responsibleDeptId 责任部门ID * @param defectLevel 缺陷等级 * @param reviewOpinion 评审意见 */ void reviewNcr(Long id, Integer disposition, Long responsibleDeptId, Integer defectLevel, String reviewOpinion); /** * 执行不合格品处置 *

* 不同处置方式会联动生成业务单据并回写库存/生产: *

* * @param disposeReqVO 处置信息(含入库仓库/库区/库位/批次号) * @return 生成的业务单据信息 */ MesQcNcrDisposeRespVO disposeNcr(@Valid MesQcNcrDisposeReqVO disposeReqVO); /** * 提交不合格品处理单审批 * * @param id 编号 */ void submitNcrApproval(Long id); /** * 更新不合格品处理单审批状态(BPM 流程回调) * * @param id 编号 * @param bpmResult BPM 审批结果 */ void updateNcrAuditStatus(Long id, String processInstanceId, Integer bpmResult); /** * 关闭不合格品处理单 * * @param id 编号 * @param closeOpinion 关闭意见 */ void closeNcr(Long id, String closeOpinion, Long reinspectionIpqcId); /** * 校验不合格品处理单存在 * * @param id 编号 * @return 不合格品处理单 */ MesQcNcrDO validateNcrExists(Long id); /** * 获得不合格品处理单 * * @param id 编号 * @return 不合格品处理单 */ MesQcNcrDO getNcr(Long id); /** * 获得不合格品处理单分页 * * @param pageReqVO 分页查询 * @return 不合格品处理单分页 */ PageResult getNcrPage(MesQcNcrPageReqVO pageReqVO); /** * 批量获取不合格品处理单 Map * * @param ids 编号集合 * @return 不合格品处理单 Map */ Map getNcrMap(Collection ids); }