package com.zt.plat.module.qms.resource.material.service;

import com.zt.plat.framework.common.pojo.PageResult;
import com.zt.plat.module.qms.resource.material.controller.vo.*;
import com.zt.plat.module.qms.resource.material.dal.dataobject.MaterialLifecycleDO;
import com.zt.plat.module.qms.resource.material.dal.dataobject.MaterialLifecycleDetailDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 物料通用流程,物料验收、退换货 Service 接口
 *
 * @author 后台管理
 */
public interface MaterialLifecycleService {

    /**
     * 创建物料通用流程,物料验收、退换货
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    MaterialLifecycleRespVO createMaterialLifecycle(@Valid MaterialLifecycleSaveReqVO createReqVO);

    /**
     * 更新物料通用流程,物料验收、退换货
     *
     * @param updateReqVO 更新信息
     */
    MaterialLifecycleDO updateMaterialLifecycle(@Valid MaterialLifecycleSaveReqVO updateReqVO);

    /**
     * 删除物料通用流程,物料验收、退换货
     *
     * @param id 编号
     */
    void deleteMaterialLifecycle(Long id);

    /**
    * 批量删除物料通用流程,物料验收、退换货
    *
    * @param ids 编号
    */
    void deleteMaterialLifecycleListByIds(List<Long> ids);

    /**
     * 获得物料通用流程,物料验收、退换货
     *
     * @param id 编号
     * @return 物料通用流程,物料验收、退换货
     */
    MaterialLifecycleRespVO getMaterialLifecycleWithDetailList(Long id);

    /**
     * 获得物料通用流程,物料验收、退换货分页
     *
     * @param pageReqVO 分页查询
     * @return 物料通用流程,物料验收、退换货分页
     */
    PageResult<MaterialLifecycleDO> getMaterialLifecyclePage(MaterialLifecyclePageReqVO pageReqVO);

    /**
     * 提交（验收等流程）
     *
     * @param id 编号
     * @return 是否成功
     */
    Boolean submitLifecycle(Long id);

    /**
     * 获得物料通用流程 - 带明细数据
     *
     * @param pageReqVO 分页查询
     * @return 物料通用流程分页
     */
    PageResult<MaterialLifecycleRespVO> getMaterialLifecycleRespVOPage(@Valid MaterialLifecyclePageReqVO pageReqVO);

    /**
     * 获得物料通用流程
     *
     * @param id 编号
     * @return 物料通用流程
     */
    MaterialLifecycleDO getMaterialLifecycle(Long id);

    /**
     * 获得物料通用流程明细
     *
     * @param lfcId 流程编号
     * @return 物料通用流程明细
     */
    List<MaterialLifecycleDetailDO> getDetailListByLfcId(Long lfcId);

    /**
     * 执行人提交（验收等流程）
     *
     * @param id 编号
     * @return 是否成功
     */
    Boolean operatorSubmitLifecycle(Long id);

    /**
     * 盘点物料
     *
     * @param inventoryReqVO 盘点信息
     * @return 盘点信息
     */
    MaterialInventoryCheckDetailRespVO inventoryCheckInfomation(@Valid MaterialInventoryCheckDetailSaveReqVO inventoryReqVO);
}