package cn.iocoder.yudao.module.mes.service.pro.bagcode;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.pro.bagcode.vo.MesProBagCodeBindReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.bagcode.vo.MesProBagCodeGenerateReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.bagcode.vo.MesProBagCodePageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.bagcode.vo.MesProBagCodeReplaceReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.bagcode.vo.MesProBagCodeReplaceRespVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.bagcode.MesProBagCodeDO;
import jakarta.validation.Valid;

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

/**
 * MES 袋码赋码（一袋一码）Service 接口
 * <p>
 * 根据批次信息自动生成唯一二维码数据包，支持批量导出交付印刷，满足唯一性、可识别性、可追溯性要求。
 *
 * @author 超级管理员
 */
public interface MesProBagCodeService {

    /**
     * 生成袋码数据包（码值 = 批次号-袋序号），并回写批次袋码数量
     *
     * @param generateReqVO 生成信息
     * @return 生成组 UUID（标记同一次生成的数据包）
     */
    String generateBagCodes(@Valid MesProBagCodeGenerateReqVO generateReqVO);

    /**
     * 作废破损袋码并在原批次生成等量替换袋码
     */
    MesProBagCodeReplaceRespVO replaceBagCodes(@Valid MesProBagCodeReplaceReqVO replaceReqVO);

    /**
     * 删除生成组（仅"已生成"状态且未绑定托盘的袋码允许删除）
     *
     * @param uuid 生成组 UUID
     */
    void deleteBagCodesByUuid(String uuid);

    /**
     * 袋码绑定托盘（需同一批次、未绑定过，且不超过托盘可装袋数）
     *
     * @param bindReqVO 绑定信息
     */
    void bindPallet(@Valid MesProBagCodeBindReqVO bindReqVO);

    /**
     * 袋码解绑托盘
     *
     * @param bindReqVO 解绑信息
     */
    void unbindPallet(@Valid MesProBagCodeBindReqVO bindReqVO);

    /**
     * 批量标记袋码为已导出印刷（交付印刷）
     *
     * @param ids 袋码编号列表
     */
    void markBagCodesPrinted(Collection<Long> ids);

    /**
     * 获得袋码
     *
     * @param id 编号
     * @return 袋码
     */
    MesProBagCodeDO getBagCode(Long id);

    /**
     * 校验袋码存在
     *
     * @param id 编号
     * @return 袋码
     */
    MesProBagCodeDO validateBagCodeExists(Long id);

    /**
     * 根据袋码（二维码内容）查询袋码，用于扫码追溯
     *
     * @param code 袋码
     * @return 袋码，不存在返回 null
     */
    MesProBagCodeDO getBagCodeByCode(String code);

    /**
     * 查询袋码替换记录
     */
    cn.iocoder.yudao.module.mes.dal.dataobject.pro.bagcode.MesProBagCodeReplaceDO getReplacementByOldBagCodeId(Long oldBagCodeId);

    cn.iocoder.yudao.module.mes.dal.dataobject.pro.bagcode.MesProBagCodeReplaceDO getReplacementByNewBagCodeId(Long newBagCodeId);

    /**
     * 获得袋码分页
     *
     * @param pageReqVO 分页查询
     * @return 袋码分页
     */
    PageResult<MesProBagCodeDO> getBagCodePage(MesProBagCodePageReqVO pageReqVO);

    /**
     * 获得生成组的袋码列表
     *
     * @param uuid 生成组 UUID
     * @return 袋码列表
     */
    List<MesProBagCodeDO> getBagCodeListByUuid(String uuid);

    /**
     * 获得绑定在某托盘上的袋码列表（按袋序号升序），用于托盘扫码追溯
     *
     * @param palletId 托盘编号
     * @return 袋码列表
     */
    List<MesProBagCodeDO> getBagCodeListByPalletId(Long palletId);

    /**
     * 获得某批次下的全部袋码列表（按袋序号升序），用于批量导出二维码
     *
     * @param batchId 批次编号
     * @return 袋码列表
     */
    List<MesProBagCodeDO> getBagCodeListByBatchId(Long batchId);

}