package cn.iocoder.yudao.module.mes.service.wm.returnissue;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.returnissue.vo.line.MesWmReturnIssueLinePageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.returnissue.vo.line.MesWmReturnIssueLineSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnissue.MesWmReturnIssueLineDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnissue.MesWmReturnIssueLinePageVO;
|
import jakarta.validation.Valid;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* MES 生产退料单行 Service 接口
|
*/
|
public interface MesWmReturnIssueLineService {
|
|
/**
|
* 创建生产退料单行
|
*
|
* @param createReqVO 创建信息
|
* @return 编号
|
*/
|
Long createReturnIssueLine(@Valid MesWmReturnIssueLineSaveReqVO createReqVO);
|
|
/**
|
* 更新生产退料单行
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateReturnIssueLine(@Valid MesWmReturnIssueLineSaveReqVO updateReqVO);
|
|
/**
|
* 删除生产退料单行
|
*
|
* @param id 编号
|
*/
|
void deleteReturnIssueLine(Long id);
|
|
/**
|
* 获得生产退料单行
|
*
|
* @param id 编号
|
* @return 生产退料单行
|
*/
|
MesWmReturnIssueLineDO getReturnIssueLine(Long id);
|
|
/**
|
* 获得生产退料单行分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 生产退料单行分页
|
*/
|
PageResult<MesWmReturnIssueLinePageVO> getReturnIssueLinePage(MesWmReturnIssueLinePageReqVO pageReqVO);
|
|
/**
|
* 根据退料单 ID 获取行列表
|
*
|
* @param issueId 退料单 ID
|
* @return 行列表
|
*/
|
List<MesWmReturnIssueLineDO> getReturnIssueLineListByIssueId(Long issueId);
|
|
/**
|
* 根据退料单 ID 删除行
|
*
|
* @param issueId 退料单 ID
|
*/
|
void deleteReturnIssueLineByIssueId(Long issueId);
|
|
/**
|
* 校验生产退料单行是否存在
|
*
|
* @param id 编号
|
* @return 生产退料单行
|
*/
|
MesWmReturnIssueLineDO validateReturnIssueLineExists(Long id);
|
|
/**
|
* 刷新退料单下所有行的质量状态（退料类型变更时调用）
|
*
|
* @param issueId 退料单 ID
|
* @param issueType 退料类型
|
*/
|
void updateReturnIssueQualityStatusByIssueId(Long issueId, Integer issueType);
|
|
/**
|
* RQC 检验完成后，根据合格品/不合格品数量更新生产退料单行
|
*
|
* <p>拆分逻辑：
|
* <ul>
|
* <li>全部合格：直接更新行的 qualityStatus 为合格</li>
|
* <li>全部不合格：直接更新行的 qualityStatus 为不合格</li>
|
* <li>部分合格部分不合格：拆分原行（原行改为合格+数量=合格数，新增一行不合格+数量=不合格数）</li>
|
* </ul>
|
* 同时检查退料单下所有行是否都已检验完毕，若全检完则将退料单状态设为待上架。
|
*
|
* @param sourceLineId 来源行 ID
|
* @param sourceDocId 来源退料单 ID
|
* @param checkResult 检验结果
|
* @param qualifiedQuantity 合格品数量
|
* @param unqualifiedQuantity 不合格品数量
|
*/
|
void updateReturnIssueLineWhenRqcFinish(Long sourceLineId, Long sourceDocId, Integer checkResult,
|
BigDecimal qualifiedQuantity, BigDecimal unqualifiedQuantity);
|
|
}
|
