package cn.iocoder.yudao.module.erp.api.purchase;

import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.erp.api.purchase.dto.ErpPurchaseOrderItemRespDTO;
import cn.iocoder.yudao.module.erp.api.purchase.dto.ErpPurchaseOrderRespDTO;

import java.math.BigDecimal;
import java.util.List;

/**
 * ERP 采购订单 API 接口
 *
 * @author 芋道源码
 */
public interface ErpPurchaseOrderApi {

    String PREFIX = "/rpc-api/erp/purchase-order";

    /**
     * 获取采购订单
     *
     * @param id 订单编号
     * @return 采购订单
     */
    CommonResult<ErpPurchaseOrderRespDTO> getPurchaseOrder(Long id);

    /**
     * 根据供应商编号获取采购订单列表（已审核状态）
     *
     * @param supplierId 供应商编号
     * @return 采购订单列表
     */
    CommonResult<List<ErpPurchaseOrderRespDTO>> getPurchaseOrderListBySupplierId(Long supplierId);

    /**
     * 根据编号列表获取采购订单列表
     *
     * @param ids 编号列表
     * @return 采购订单列表
     */
    CommonResult<List<ErpPurchaseOrderRespDTO>> getPurchaseOrderList(List<Long> ids);

    /**
     * 获取采购订单明细列表
     *
     * @param orderId 订单编号
     * @return 明细列表
     */
    CommonResult<List<ErpPurchaseOrderItemRespDTO>> getPurchaseOrderItemList(Long orderId);

    /**
     * 获取采购订单明细
     *
     * @param id 明细编号
     * @return 明细
     */
    CommonResult<ErpPurchaseOrderItemRespDTO> getPurchaseOrderItem(Long id);

    /**
     * 更新采购订单明细的入库数量
     *
     * @param orderItemId 明细编号
     * @param inCount     入库数量增量
     */
    CommonResult<Boolean> updateOrderItemInCount(Long orderItemId, BigDecimal inCount);

    /**
     * 更新采购订单的入库状态
     *
     * 根据明细入库数量自动计算订单状态：
     * - 所有明细都完成入库 → 完成状态
     * - 部分明细完成入库 → 部分入库状态
     *
     * @param orderId 订单编号
     */
    CommonResult<Boolean> updateOrderInStatus(Long orderId);

}