package cn.iocoder.yudao.module.hrm.service.supply;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyAlertRespVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyIssuePageReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyIssueRespVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyIssueSaveReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyPageReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyPurchasePageReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyPurchaseRespVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyPurchaseSaveReqVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplyRespVO;
import cn.iocoder.yudao.module.hrm.controller.admin.supply.vo.HrmSupplySaveReqVO;
import cn.iocoder.yudao.module.hrm.dal.dataobject.supply.HrmSupplyDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 办公用品管理 Service 接口
 *
 * @author 超级管理员
 */
public interface HrmSupplyService {

    /**
     * 新增办公用品
     *
     * @param createReqVO 新增信息
     * @return 用品编号
     */
    Long createSupply(@Valid HrmSupplySaveReqVO createReqVO);

    /**
     * 更新办公用品
     *
     * @param updateReqVO 更新信息
     */
    void updateSupply(@Valid HrmSupplySaveReqVO updateReqVO);

    /**
     * 删除办公用品
     *
     * @param id 用品编号
     */
    void deleteSupply(Long id);

    /**
     * 获得办公用品
     *
     * @param id 用品编号
     * @return 办公用品
     */
    HrmSupplyDO getSupply(Long id);

    /**
     * 获得办公用品分页
     *
     * @param pageReqVO 分页查询参数
     * @return 办公用品分页
     */
    PageResult<HrmSupplyRespVO> getSupplyPage(HrmSupplyPageReqVO pageReqVO);

    /**
     * 获得启用的办公用品精简列表
     *
     * @return 办公用品列表
     */
    List<HrmSupplyDO> getSupplyList();

    /**
     * 获得库存预警列表：当前库存低于库存下限或高于库存上限的启用用品
     *
     * @return 预警列表
     */
    List<HrmSupplyAlertRespVO> getSupplyAlertList();

    /**
     * 新增采购记录（同时累加办公用品当前库存）
     *
     * @param createReqVO 新增信息
     * @return 采购记录编号
     */
    Long createSupplyPurchase(@Valid HrmSupplyPurchaseSaveReqVO createReqVO);

    /**
     * 获得采购记录分页
     *
     * @param pageReqVO 分页查询参数
     * @return 采购记录分页
     */
    PageResult<HrmSupplyPurchaseRespVO> getSupplyPurchasePage(HrmSupplyPurchasePageReqVO pageReqVO);

    /**
     * 新增领用申请（初始状态为待审批）
     *
     * @param createReqVO 新增信息
     * @return 领用申请编号
     */
    Long createSupplyIssue(@Valid HrmSupplyIssueSaveReqVO createReqVO);

    /**
     * 审批领用申请
     *
     * @param id      领用申请编号
     * @param approve true 通过，false 驳回
     * @param remark  审批意见
     */
    void approveSupplyIssue(Long id, Boolean approve, String remark);

    /**
     * 发放领用申请（扣减办公用品库存）
     *
     * @param id 领用申请编号
     */
    void issueSupply(Long id);

    /**
     * 获得领用申请分页
     *
     * @param pageReqVO 分页查询参数
     * @return 领用申请分页
     */
    PageResult<HrmSupplyIssueRespVO> getSupplyIssuePage(HrmSupplyIssuePageReqVO pageReqVO);

}