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

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

/**
 * 单位转换 Service 接口
 *
 * @author 后台管理-1
 */
public interface UnitConversionService {

    /**
     * 创建单位转换
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    UnitConversionRespVO createUnitConversion(@Valid UnitConversionSaveReqVO createReqVO);

    /**
     * 更新单位转换
     *
     * @param updateReqVO 更新信息
     */
    void updateUnitConversion(@Valid UnitConversionSaveReqVO updateReqVO);

    /**
     * 删除单位转换
     *
     * @param id 编号
     */
    void deleteUnitConversion(Long id);

    /**
    * 批量删除单位转换
    *
    * @param ids 编号
    */
    void deleteUnitConversionListByIds(List<Long> ids);

    /**
     * 获得单位转换
     *
     * @param id 编号
     * @return 单位转换
     */
    UnitConversionDO getUnitConversion(Long id);

    /**
     * 获得单位转换分页
     *
     * @param pageReqVO 分页查询
     * @return 单位转换分页
     */
    PageResult<UnitConversionDO> getUnitConversionPage(UnitConversionPageReqVO pageReqVO);

    /**
     * 单位转换
     *
     * @param convertReqVO 转换请求
     * @return 转换结果
     */
    UnitConvertRespVO convert(@Valid UnitConvertReqVO convertReqVO);

    /**
     * 批量单位转换
     *
     * @param batchReqVO 批量转换请求
     * @return 批量转换结果
     */
    BatchUnitConvertRespVO batchConvert(@Valid BatchUnitConvertReqVO batchReqVO);

    /**
     * 按单位符号转换
     *
     * @param reqVO 转换请求
     * @return 转换结果
     */
    UnitConvertRespVO convertBySymbol(@Valid UnitConvertBySymbolReqVO reqVO);

    /**
     * 按单位名称转换
     *
     * @param reqVO 转换请求
     * @return 转换结果
     */
    UnitConvertRespVO convertByName(@Valid UnitConvertByNameReqVO reqVO);

    /**
     * 批量按单位符号转换
     *
     * @param reqVO 批量转换请求
     * @return 批量转换结果
     */
    BatchUnitConvertRespVO batchConvertBySymbol(@Valid BatchUnitConvertBySymbolReqVO reqVO);

    /**
     * 批量按单位名称转换
     *
     * @param reqVO 批量转换请求
     * @return 批量转换结果
     */
    BatchUnitConvertRespVO batchConvertByName(@Valid BatchUnitConvertByNameReqVO reqVO);

    /**
     * 校验量纲内所有单位的转换路径
     *
     * @param quantityId 量纲ID
     * @return 校验结果
     */
    UnitConversionValidationRespVO validateConversionPaths(Long quantityId);

}