package cn.iocoder.yudao.module.iot.service.formula;

import cn.iocoder.yudao.framework.common.pojo.PageParam;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.iot.controller.admin.formula.vo.FormulaPageReqVO;
import cn.iocoder.yudao.module.iot.controller.admin.formula.vo.FormulaSaveReqVO;
import cn.iocoder.yudao.module.iot.dal.dataobject.formula.FormulaDO;
import cn.iocoder.yudao.module.iot.dal.dataobject.formula.FormulaDetailDO;

import javax.validation.Valid;


/**
 * 计算公式 Service 接口
 *
 * @author 内蒙必硕
 */
public interface FormulaService {

    /**
     * 创建计算公式
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createFormula(@Valid FormulaSaveReqVO createReqVO);

    /**
     * 更新计算公式
     *
     * @param updateReqVO 更新信息
     */
    void updateFormula(@Valid FormulaSaveReqVO updateReqVO);

    /**
     * 删除计算公式
     *
     * @param id 编号
     */
    void deleteFormula(Long id);

    /**
     * 获得计算公式
     *
     * @param id 编号
     * @return 计算公式
     */
    FormulaDO getFormula(Long id);

    /**
     * 获得计算公式分页
     *
     * @param pageReqVO 分页查询
     * @return 计算公式分页
     */
    PageResult<FormulaDO> getFormulaPage(FormulaPageReqVO pageReqVO);

    // ==================== 子表（计算公式明细） ====================

    /**
     * 获得计算公式明细分页
     *
     * @param pageReqVO 分页查询
     * @param formulaId 计算公式ID
     * @return 计算公式明细分页
     */
    PageResult<FormulaDetailDO> getFormulaDetailPage(PageParam pageReqVO, Long formulaId);

    /**
     * 创建计算公式明细
     *
     * @param formulaDetail 创建信息
     * @return 编号
     */
    Long createFormulaDetail(@Valid FormulaDetailDO formulaDetail);

    /**
     * 更新计算公式明细
     *
     * @param formulaDetail 更新信息
     */
    void updateFormulaDetail(@Valid FormulaDetailDO formulaDetail);

    /**
     * 删除计算公式明细
     *
     * @param id 编号
     */
    void deleteFormulaDetail(Long id);

    /**
     * 获得计算公式明细
     *
     * @param id 编号
     * @return 计算公式明细
     */
    FormulaDetailDO getFormulaDetail(Long id);

}