package com.zt.plat.module.base.service.base;

import com.zt.plat.framework.common.pojo.PageResult;
import com.zt.plat.module.base.controller.admin.base.vo.MaterialInfomationPageReqVO;
import com.zt.plat.module.base.controller.admin.base.vo.MaterialInfomationRespVO;
import com.zt.plat.module.base.controller.admin.base.vo.MaterialInfomationSaveReqVO;
import com.zt.plat.module.base.controller.admin.base.vo.MaterialInfomationSimplePageReqVO;
import com.zt.plat.module.base.controller.admin.base.vo.MaterialInfomationSimpleRespVO;
import com.zt.plat.module.base.dal.dataobject.base.MaterialInfomationDO;
import jakarta.validation.Valid;

import java.util.List;
import java.util.Collection;

/**
 * 物料信息 Service 接口
 *
 * @author 后台管理
 */
public interface MaterialInfomationService {

    /**
     * 创建物料信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    MaterialInfomationRespVO createMaterialInfomation(@Valid MaterialInfomationSaveReqVO createReqVO);

    /**
     * 快捷创建物料信息：仅在同一小类下不存在相同编码和名称的物料时才创建
     *
     * @param createReqVO 创建信息
     * @return 操作结果描述
     */
    String createMaterialInfomationQuickly(@Valid MaterialInfomationSaveReqVO createReqVO);

    /**
     * 更新物料信息
     *
     * @param updateReqVO 更新信息
     */
    void updateMaterialInfomation(@Valid MaterialInfomationSaveReqVO updateReqVO);

    /**
     * 删除物料信息
     *
     * @param id 编号
     */
    void deleteMaterialInfomation(Long id);

    /**
    * 批量删除物料信息
    *
    * @param ids 编号
    */
    void deleteMaterialInfomationListByIds(List<Long> ids);

    /**
     * 获得物料信息
     *
     * @param id 编号
     * @return 物料信息
     */
    MaterialInfomationRespVO getMaterialInfomation(Long id);

    /**
     * 获得物料信息分页
     *
     * @param pageReqVO 分页查询
     * @return 物料信息分页
     */
    PageResult<MaterialInfomationRespVO> getMaterialInfomationPage(MaterialInfomationPageReqVO pageReqVO);

    String getOneTest();

    /**
     * 获得精简的物料信息分页
     *
     * @param pageReqVO 分页参数
     * @return 精简分页列表
     */
    PageResult<MaterialInfomationSimpleRespVO> getMaterialInfomationSimplePage(MaterialInfomationSimplePageReqVO pageReqVO);

    /**
     * 按 ID 批量查询物料信息（含持有属性）
     *
     * @param ids 物料 ID 集合
     * @return 物料信息列表
     */
    List<MaterialInfomationRespVO> getMaterialInfomationListByIds(Collection<Long> ids);
}