package cn.iocoder.yudao.module.mes.service.qc.retentionsample;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.qc.retentionsample.vo.MesQcRetentionSamplePageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.qc.retentionsample.vo.MesQcRetentionSampleSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.qc.retentionsample.MesQcRetentionSampleDO;
import jakarta.validation.Valid;

/**
 * MES 留样记录 Service 接口
 *
 * @author 超级管理员
 */
public interface MesQcRetentionSampleService {

    /**
     * 创建留样记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createRetentionSample(@Valid MesQcRetentionSampleSaveReqVO createReqVO);

    /**
     * 更新留样记录
     *
     * @param updateReqVO 更新信息
     */
    void updateRetentionSample(@Valid MesQcRetentionSampleSaveReqVO updateReqVO);

    /**
     * 删除留样记录
     *
     * @param id 编号
     */
    void deleteRetentionSample(Long id);

    /**
     * 获得留样记录
     *
     * @param id 编号
     * @return 留样记录
     */
    MesQcRetentionSampleDO getRetentionSample(Long id);

    /**
     * 获得留样记录分页
     *
     * @param pageReqVO 分页查询
     * @return 留样记录分页
     */
    PageResult<MesQcRetentionSampleDO> getRetentionSamplePage(MesQcRetentionSamplePageReqVO pageReqVO);

    /**
     * 根据生产工单 ID 获得留样记录
     *
     * @param workOrderId 生产工单 ID
     * @return 留样记录
     */
    MesQcRetentionSampleDO getRetentionSampleByWorkOrderId(Long workOrderId);

}