package cn.iocoder.yudao.module.finance.service.asset;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.finance.controller.admin.asset.vo.FinFixedAssetDepreciateRespVO;
import cn.iocoder.yudao.module.finance.controller.admin.asset.vo.FinFixedAssetPageReqVO;
import cn.iocoder.yudao.module.finance.controller.admin.asset.vo.FinFixedAssetSaveReqVO;
import cn.iocoder.yudao.module.finance.dal.dataobject.asset.FinFixedAssetDO;
import jakarta.validation.Valid;

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

/**
 * 固定资产 Service 接口
 *
 * @author 超级管理员
 */
public interface FinFixedAssetService {

    /**
     * 创建固定资产
     *
     * @param createReqVO 创建信息
     * @return 资产编号
     */
    Long createFixedAsset(@Valid FinFixedAssetSaveReqVO createReqVO);

    /**
     * 更新固定资产
     *
     * 修改原值、使用年限、残值率时会按新参数重算累计折旧与净值
     *
     * @param updateReqVO 更新信息
     */
    void updateFixedAsset(@Valid FinFixedAssetSaveReqVO updateReqVO);

    /**
     * 删除固定资产
     *
     * @param id 资产编号
     */
    void deleteFixedAsset(Long id);

    /**
     * 批量删除固定资产
     *
     * @param ids 资产编号数组
     */
    void deleteFixedAssetList(List<Long> ids);

    /**
     * 计提折旧
     *
     * 每个资产计提一个月的折旧：月折旧额 = 原值 × (1 - 残值率 / 100) / (使用年限 × 12)。
     * 累计折旧以应计提总额封顶，最后一期按剩余可折旧额计提，净值不会被提成负数
     *
     * @param ids 资产编号数组；为空时对所有未报废的固定资产计提
     * @return 计提结果
     */
    FinFixedAssetDepreciateRespVO depreciateFixedAssetList(List<Long> ids);

    /**
     * 获得固定资产
     *
     * @param id 资产编号
     * @return 固定资产
     */
    FinFixedAssetDO getFixedAsset(Long id);

    /**
     * 获得固定资产分页
     *
     * @param pageReqVO 分页查询
     * @return 固定资产分页
     */
    PageResult<FinFixedAssetDO> getFixedAssetPage(FinFixedAssetPageReqVO pageReqVO);

    /**
     * 获得指定编号的固定资产列表
     *
     * @param ids 资产编号数组
     * @return 固定资产列表
     */
    List<FinFixedAssetDO> getFixedAssetList(Collection<Long> ids);

    /**
     * 获得全部固定资产列表
     *
     * @return 固定资产列表
     */
    List<FinFixedAssetDO> getFixedAssetList();

}