package com.ruoyi.stock.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.sales.dto.SalesLedgerDto;
import com.ruoyi.sales.pojo.SalesLedger;
import com.ruoyi.stock.dto.OilOutAvailableDto;
import com.ruoyi.stock.dto.StockOutRecordDto;
import com.ruoyi.stock.pojo.StockOutRecord;

import jakarta.servlet.http.HttpServletResponse;
import java.math.BigDecimal;
import java.util.List;

/**
 * <p>
 * 出库记录表 服务类
 * </p>
 *
 * @author 芯导软件（江苏）有限公司
 * @since 2026-01-21 05:27:04
 */
public interface StockOutRecordService extends IService<StockOutRecord> {
    IPage<StockOutRecordDto> listPage(Page page, StockOutRecordDto stockOutRecordDto);

    int add(StockOutRecordDto stockOutRecordDto);

    int update(Long id, StockOutRecordDto stockOutRecordDto);

    int batchDelete(List<Long> ids);

    int batchDeletePending(List<Long> ids);

    void exportStockOutRecord(HttpServletResponse response, StockOutRecordDto stockOutRecordDto);

    int batchApprove(List<Long> ids, Integer approvalStatus);

    int batchReAudit(List<Long> ids);

    /**
     * 录入「本次送完货后剩余油量」。
     * 只更新 residual_oil，不动其他列；走 {@link #update} 会把未传的字段全部置空，故单独开一个接口
     *
     * @param id          出库记录id
     * @param residualOil 剩余油量(吨)，不能为空、不能小于0、不能大于出库数量
     */
    int updateResidualOil(Long id, BigDecimal residualOil);

    /**
     * 油品出库可用量：下次发货 = 上次剩余油量 + 当前库存量
     *
     * @param query 需带 vehicleId、productModelId，batchNo 可选
     * @return 上次剩余油量 / 当前库存 / 可用量
     */
    OilOutAvailableDto getOilOutAvailableQty(StockOutRecordDto query);

    /**
     * 按来源明细id批量查询出库记录，不受数据权限约束。
     * 供业务单据做「出库是否已审批」这类自身状态机校验，换账号执行也必须看到同一批记录
     *
     * @param recordIds  来源明细id，为空返回空集合
     * @param recordType 出库类型，见 StockInQualifiedRecordTypeEnum
     */
    List<StockOutRecord> listByRecordIds(List<Long> recordIds, String recordType);

    /**
     * 释放来源明细关联的出库记录：审批通过过的按批次归还库存量，然后删除记录。
     * 待审批/驳回的记录没扣过库存，删掉即释放占用
     *
     * @return 删除的记录数
     */
    int releaseByRecordIds(List<Long> recordIds, String recordType);

    /**
     * 油品出库可绑定的销售台账下拉，支持按合同号/客户名/项目名模糊筛选，不分 ledgerType（代储台账也能绑）。
     * 不受数据权限约束，理由见 {@code StockOutRecordMapper#bindableSalesLedgerPage}
     */
    IPage<SalesLedger> listBindableSalesLedger(Page page, SalesLedgerDto salesLedgerDto);
}