package cn.iocoder.yudao.module.mes.service.wm.salesnotice;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.wm.salesnotice.vo.MesWmSalesNoticePageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.wm.salesnotice.vo.MesWmSalesNoticeSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.salesnotice.MesWmSalesNoticeDO;
import jakarta.validation.Valid;

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

import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;

/**
 * MES 发货通知单 Service 接口
 */
public interface MesWmSalesNoticeService {

    /**
     * 创建发货通知单
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createSalesNotice(@Valid MesWmSalesNoticeSaveReqVO createReqVO);

    /**
     * 修改发货通知单
     *
     * @param updateReqVO 修改信息
     */
    void updateSalesNotice(@Valid MesWmSalesNoticeSaveReqVO updateReqVO);

    /**
     * 删除发货通知单
     *
     * @param id 编号
     */
    void deleteSalesNotice(Long id);

    /**
     * 校验发货通知单存在
     *
     * @param id 编号
     * @return 发货通知单
     */
    MesWmSalesNoticeDO validateSalesNoticeExists(Long id);

    /**
     * 获得发货通知单
     *
     * @param id 编号
     * @return 发货通知单
     */
    MesWmSalesNoticeDO getSalesNotice(Long id);

    /**
     * 获得发货通知单分页
     *
     * @param pageReqVO 分页参数
     * @return 发货通知单分页
     */
    PageResult<MesWmSalesNoticeDO> getSalesNoticePage(MesWmSalesNoticePageReqVO pageReqVO);

    /**
     * 提交发货通知单
     *
     * @param id 编号
     */
    void submitSalesNotice(Long id);

    /**
     * 获得发货通知单列表
     *
     * @param ids 编号列表
     * @return 发货通知单列表
     */
    List<MesWmSalesNoticeDO> getSalesNoticeList(Collection<Long> ids);

    /**
     * 获得发货通知单 Map
     *
     * @param ids 编号列表
     * @return 发货通知单 Map
     */
    default Map<Long, MesWmSalesNoticeDO> getSalesNoticeMap(Collection<Long> ids) {
        return convertMap(getSalesNoticeList(ids), MesWmSalesNoticeDO::getId);
    }

    /**
     * 从销售订单生成发货通知单
     *
     * @param saleOrderId 销售订单ID
     * @return 发货通知单ID
     */
    Long generateSalesNoticeFromSaleOrder(Long saleOrderId);

    /**
     * 完成发货通知单（出库完成后调用）
     * 累加出库数量并计算出库状态
     *
     * @param id 编号
     * @deprecated 请使用 {@link #updateSalesNoticeOutCount(Long, java.math.BigDecimal)}
     */
    @Deprecated
    void finishSalesNotice(Long id);

    /**
     * 更新发货通知单行的出库数量
     *
     * @param noticeLineId 发货通知单行ID
     * @param outCount     出库数量
     */
    void updateSalesNoticeLineOutCount(Long noticeLineId, java.math.BigDecimal outCount);

    /**
     * 更新发货通知单的出库状态
     *
     * @param noticeId 发货通知单ID
     */
    void updateSalesNoticeOutStatus(Long noticeId);

    /**
     * 从发货通知单生成销售出库单
     *
     * @param noticeId 发货通知单ID
     * @return 销售出库单ID
     */
    Long generateProductSalesFromNotice(Long noticeId);

}