klp-oa/klp-wms/src/main/java/com/klp/service/IWmsMaterialCoilService.java

package com.klp.service;

import com.klp.domain.vo.WmsMaterialCoilVo;
import com.klp.domain.bo.WmsMaterialCoilBo;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.PageQuery;

import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.NotNull;
import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 钢卷物料表Service接口
 *
 * @author Joshi
 * @date 2025-07-18
 */
public interface IWmsMaterialCoilService {

    /**
     * 查询钢卷物料表
     */
    WmsMaterialCoilVo queryById(Long coilId);

    /**
     * 查询钢卷物料表列表
     */
    TableDataInfo<WmsMaterialCoilVo> queryPageList(WmsMaterialCoilBo bo, PageQuery pageQuery);

    /**
     * 查询钢卷物料表列表
     */
    List<WmsMaterialCoilVo> queryList(WmsMaterialCoilBo bo);

    /**
     * 新增钢卷物料表
     */
    WmsMaterialCoilVo insertByBo(WmsMaterialCoilBo bo);

    /**
     * 修改钢卷物料表
     * 如果newCoils不为空，则进行批量更新（分卷/合卷）
     * 如果newCoils为空，则进行单个更新
     */
    Boolean updateByBo(WmsMaterialCoilBo bo);

    /**
     * 简单更新钢卷物料表
     * 直接更新属性内容，不进行历史记录处理
     */
    Boolean updateSimple(WmsMaterialCoilBo bo);

    /**
     * 校验并批量删除钢卷物料表信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 钢卷溯源查询
     * 根据入场钢卷号查询二维码，解析content中的steps，然后根据steps中的钢卷号反向查询数据库
     *
     * @param enterCoilNo 入场钢卷号
     * @param currentCoilNo 当前钢卷号（可选，用于查询特定子钢卷）
     * @return 溯源结果（包含二维码信息和数据库记录）
     */
    Map<String, Object> queryTrace(String enterCoilNo, String currentCoilNo);

    /**
     * 查询各个库区中不同类型的钢卷分布情况
     * 按库区分组，统计每种物品类型和物品ID的钢卷数量和重量
     *
     * @param itemType 物品类型（可选）
     * @param itemId 物品ID（可选）
     * @return 分布情况列表，包含库区信息、物品类型、物品ID、数量、重量等
     */
    List<WmsMaterialCoilVo> getDistributionByWarehouse(String itemType, Long itemId);

    /**
     * 查询不同类型的钢卷在不同库区的分布情况
     * 按物品类型和物品ID分组，统计每个库区的钢卷数量和重量
     *
     * @param itemType 物品类型（可选）
     * @param itemId 物品ID（可选）
     * @return 分布情况列表，包含物品类型、物品ID、库区信息、数量、重量等
     */
    List<WmsMaterialCoilVo> getDistributionByItemType(String itemType, Long itemId);

    List<WmsMaterialCoilVo> getDistributionByActualWarehouse(String itemType, Long itemId);

    List<WmsMaterialCoilVo> getDistributionByActualItemType(String itemType, Long itemId);

    /**
     * 查询钢卷导出数据列表
     *
     * @param bo 查询条件
     * @return 导出数据列表
     */
    List<com.klp.domain.vo.WmsMaterialCoilExportVo> queryExportList(WmsMaterialCoilBo bo);

    int exportCoil(@NotEmpty(message = "主键不能为空") Long coilId);


    Boolean batchUpdateDeliveryStatus(List<Long> coilIdList, Integer status);

    /**
     * 根据更新前的钢卷ID列表获取更新后的钢卷ID列表
     *
     * @param oldCoilIds 更新前的钢卷ID列表
     * @return 更新后的钢卷ID列表
     */
    Map<Long, String> getUpdatedCoilIdsByOldCoilIds(List<Long> oldCoilIds);

    int withdrawExportCoil(@NotNull(message = "主键不能为空") Long coilId);

    /**
     * 检查钢卷号是否重复
     * 根据入场钢卷号和当前钢卷号查询数据库，判断哪个钢卷号重复
     *
     * @param enterCoilNo 入场钢卷号
     * @param currentCoilNo 当前钢卷号
     * @return 返回结果Map，包含：
     *         - duplicateType: "enter" (入场钢卷号重复), "current" (当前钢卷号重复), "both" (都重复), "none" (都不重复)
     *         - enterCoilNoDuplicate: 入场钢卷号是否重复 (true/false)
     *         - currentCoilNoDuplicate: 当前钢卷号是否重复 (true/false)
     */
    Map<String, Object> checkCoilNoDuplicate(Long coilId, String enterCoilNo, String currentCoilNo);

    /**
     * 根据入场钢卷号前缀查询最大的入场钢卷号
     * 前端传入入场钢卷号的前四位，查询所有符合的入场钢卷号，返回最大值
     *
     * @param enterCoilNoPrefix 入场钢卷号前缀（前四位）
     * @return 返回结果Map，包含：
     *         - maxEnterCoilNo: 最大的入场钢卷号
     *         - prefix: 前缀值
     */
    Map<String, Object> getMaxEnterCoilNoByPrefix(String enterCoilNoPrefix);

    /**
     * 查询data_type=1时的重复钢卷分组
     * 将入场钢卷号重复的分为一组，将当前钢卷号重复的分为一组
     * 返回结构：
     *  {
     *    enterGroups: [ { enterCoilNo: "xxx", coils: [WmsMaterialCoilVo...] }, ...],
     *    currentGroups: [ { currentCoilNo: "yyy", coils: [WmsMaterialCoilVo...] }, ...]
     *  }
     */
    Map<String, Object> getDuplicateCoilGroups();

    /**
     * 复活历史钢卷
     * 将dataType=0的历史钢卷恢复为dataType=1的当前钢卷
     * 同时清空实际库位绑定，并检查当前钢卷号是否重复
     *
     * @param coilId 钢卷ID
     * @return 复活结果，包含success状态和错误信息
     */
    Map<String, Object> reviveCoil(@NotNull(message = "钢卷ID不能为空") Long coilId);
}