package com.zg.project.wisdom.mapper;

import java.util.List;

import com.zg.project.Inventory.domain.vo.PcdeCntVO;
import com.zg.project.Inventory.domain.vo.RkInfoMatchVO;
import com.zg.project.wisdom.domain.RkInfo;
import com.zg.project.wisdom.domain.dto.RkInfoQueryDTO;
import com.zg.project.wisdom.domain.vo.PcodeQtyVO;
import org.apache.ibatis.annotations.Param;

/**
 * 库存单据主Mapper接口
 * 
 * @author zg
 * @date 2025-05-28
 */
public interface RkInfoMapper 
{
    /**
     * 查询库存单据主
     * 
     * @param id 库存单据主主键
     * @return 库存单据主
     */
    public RkInfo selectRkInfoById(Long id);

    /**
     * 查询库存单据主列表
     * 
     * @param rkInfo 库存单据主
     * @return 库存单据主集合
     */
    public List<RkInfo> selectRkInfoList(RkInfo rkInfo);

    /**
     * 使用 selectRkInfoVo 作为子查询，外层按 bill_no 分组聚合
     * 不新增 resultMap / VO，直接用 RkInfoResult 映射需要的字段
     */
    List<RkInfo> selectGroupedByBill(@Param("q") RkInfoQueryDTO query,
                                     @Param("needAudit") Integer needAudit);


    /**
     * 修改库存单据主
     * 
     * @param rkInfo 库存单据主
     * @return 结果
     */
    public int updateRkInfo(RkInfo rkInfo);

    /**
     * 删除库存单据主
     * 
     * @param id 库存单据主主键
     * @return 结果
     */
    public int deleteRkInfoById(Long id);

    /**
     * 批量删除库存单据主
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteRkInfoByIds(Long[] ids);

    /**
     * 新增入库单据
     * @param saveList
     * @return
     */
    int batchInsertRkInfo(List<RkInfo> saveList);

    /**
     * 根据库位编码查询入库单据
     * @param locationCode
     * @return
     */
    int countRkInfoByLocationCode(@Param("locationCode") String locationCode);

    /**
     * 查询已使用库位
     * @return
     */
    List<String> selectUsedPcodes();

    /**
     * 根据单据编号查询SAP单号
     * @param billNo
     * @return
     */
    List<String> selectSapNoByBillNo(String billNo);



    /**
     * 统计超期库存
     * @return
     */
    int countOverdueStock();

    /**
     * 获取最新20条逾期库存列表
     * @param
     * @return
     */
    List<RkInfo> selectTopOverdueStock(@Param("limit") int limit);

    /**
     * 出库操作
     * @param update
     */
    void updateById(RkInfo update);

    /**
     * 根据出库单据号查询订单编号
     * @param billNo
     * @return
     */
    List<String> selectSapNoByCkBillNo(String billNo);

    /**
     * 撤销出库
     * @param billNoCk
     */
    int cancelStockOut(String billNoCk);

    /**
     * 查看盘点扫描正常数据（限定场景）
     */
    List<RkInfo> getByPcodeIdList(@Param("list") List<String> pcdeIds,
                                  @Param("sceneId") String sceneId);

    /**
     * 查看盘点扫描未正常数据（限定场景）
     */
    List<RkInfo> getMissedPcodeIds(@Param("list") List<String> pcdeIds,
                                   @Param("sceneId") String sceneId);

    /**
     * 判断盘点扫描的id在场景内是否存在
     */
    int existsByPcodeId(@Param("pcodeId") String pcodeId,
                        @Param("sceneId") String sceneId);

    /**
     * 获取指定仓库的盘点数据
     * @param warehouse
     * @return
     */
    int countGetByWh(@Param("warehouse") String warehouse);

    /**
     * 根据所属仓库查询所有的库位号和库位对应的货物数量
     * @param
     * @return
     */
    List<RkInfoMatchVO> getUnscannedPcodeByScene(@Param("sceneId") String sceneId,
                                                 @Param("taskId") String taskId);

    /**
     * 图表统计：每个库位有多少个货物
     * @param ids
     * @return
     */
    List<PcdeCntVO> selectPcdeCntFromRkInfo(List<String> ids);

    /**
     * 还料入库
     * @param newEntry
     * @return
     */
    int insertRkInfo(RkInfo newEntry);

    /**
     * 修改入库单据状态
     */
    int updateStatusByBillNo(RkInfo rkInfo);

    /**
     * 查询每个 billNo 对应的一条入库记录（用于获取公共字段）
     */
    List<RkInfo> selectOneForEachBillNo(@Param("billNos") List<String> billNos);

    /**
     * 根据入库单据编号查询入库单据
     */
    List<RkInfo> selectRkInfoListByBillNo(String billNo);

    /**
     * 根据出库单据编号查询入库单据
     */
    List<RkInfo> selectRkInfoListByBillNoCk(String billNo);

    /**
     * 删除入库单据
     */
    void markDeleteByBillNo(RkInfo rk);

    /**
     * 删除出库单据
     */
    void markDeleteByBillNoCk(RkInfo rk);

    /**
     * 删除入库单据
     */
    void deleteByBillNo(String billNo);

    /**
     * 出库驳回时恢复单据表数据状态
     */
    void revertRkInfoStatusByBillNoCk(RkInfo revert);

    /**
     * 根据id查询入库单据
     * @param ids
     * @return
     */
    List<RkInfo> selectRkInfoByIds(@Param("ids") Long[] ids);

    List<RkInfo> listRkInfoByPcode(String pcode);

    /**
     * 获取需要配送的出库单
     * @param query
     * @return
     */
    List<RkInfo> selectDeliveryAll(RkInfo query);
}
