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

import java.util.*;
import jakarta.validation.*;
import com.zt.plat.module.base.controller.admin.quantityUnitRelation.vo.*;
import com.zt.plat.module.base.dal.dataobject.quantityUnitRelation.QuantityUnitRelationDO;
import com.zt.plat.framework.common.pojo.PageResult;
import com.zt.plat.module.base.controller.admin.quantityUnitRelation.vo.QuantityUnitRelationSimplePageReqVO;

/**
 * 计量单位量与单位关联 Service 接口
 *
 * @author 后台管理-1
 */
public interface QuantityUnitRelationService {

    /**
     * 创建计量单位量与单位关联
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    QuantityUnitRelationRespVO createQuantityUnitRelation(@Valid QuantityUnitRelationSaveReqVO createReqVO);

    /**
     * 更新计量单位量与单位关联
     *
     * @param updateReqVO 更新信息
     */
    void updateQuantityUnitRelation(@Valid QuantityUnitRelationSaveReqVO updateReqVO);

    /**
     * 删除计量单位量与单位关联
     *
     * @param id 编号
     */
    void deleteQuantityUnitRelation(Long id);

    /**
    * 批量删除计量单位量与单位关联
    *
    * @param ids 编号
    */
    void deleteQuantityUnitRelationListByIds(List<Long> ids);

    /**
     * 获得计量单位量与单位关联
     *
     * @param id 编号
     * @return 计量单位量与单位关联
     */
    QuantityUnitRelationDO getQuantityUnitRelation(Long id);

    /**
     * 获得计量单位量与单位关联分页
     *
     * @param pageReqVO 分页查询
     * @return 计量单位量与单位关联分页
     */
    PageResult<QuantityUnitRelationDO> getQuantityUnitRelationPage(QuantityUnitRelationPageReqVO pageReqVO);

    /**
     * 批量保存计量单位量与单位关联
     * 根据传入的量纲ID和单位列表,进行新增、更新和逻辑删除操作
     *
     * @param batchSaveReqVO 批量保存请求
     */
    void batchSaveQuantityUnitRelations(@Valid QuantityUnitRelationBatchSaveReqVO batchSaveReqVO);

    /**
     * 创建单位并关联到量纲（组合接口）
     * 1. 创建计量单位
     * 2. 创建量纲-单位关联关系
     *
     * @param createReqVO 创建信息
     * @return 关联关系响应VO
     */
    QuantityUnitRelationRespVO createUnitWithRelation(@Valid CreateUnitWithRelationReqVO createReqVO);

    /**
     * 删除单位及关联关系（组合接口）
     * 1. 删除量纲-单位关联关系
     * 2. 删除计量单位
     *
     * @param deleteReqVO 删除信息
     */
    void deleteUnitWithRelation(@Valid DeleteUnitWithRelationReqVO deleteReqVO);

    /**
    * 查询精简的量纲-单位关联分页，用于下拉框
    *
    * @param pageReqVO 分页查询条件
    * @return 关联关系列表
     */
    PageResult<QuantityUnitRelationSimpleRespVO> getQuantityUnitRelationSimplePage(QuantityUnitRelationSimplePageReqVO pageReqVO);

}