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

package com.klp.service;

import com.klp.domain.WmsMaterialCoil;
import com.klp.domain.WmsMaterialWarning;
import com.klp.domain.vo.WmsMaterialWarningVo;
import com.klp.domain.bo.WmsMaterialWarningBo;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.PageQuery;

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

/**
 * 钢卷通用维度告警（长度/厚度/宽度）Service接口
 *
 * @author klp
 * @date 2026-06-06
 */
public interface IWmsMaterialWarningService {

    /**
     * 查询钢卷通用维度告警（长度/厚度/宽度）
     */
    WmsMaterialWarningVo queryById(Long warningId);

    /**
     * 查询钢卷通用维度告警（长度/厚度/宽度）列表
     */
    TableDataInfo<WmsMaterialWarningVo> queryPageList(WmsMaterialWarningBo bo, PageQuery pageQuery);

    /**
     * 查询钢卷通用维度告警（长度/厚度/宽度）列表
     */
    List<WmsMaterialWarningVo> queryList(WmsMaterialWarningBo bo);

    /**
     * 新增钢卷通用维度告警（长度/厚度/宽度）
     */
    Boolean insertByBo(WmsMaterialWarningBo bo);

    /**
     * 修改钢卷通用维度告警（长度/厚度/宽度）
     */
    Boolean updateByBo(WmsMaterialWarningBo bo);

    /**
     * 校验并批量删除钢卷通用维度告警（长度/厚度/宽度）信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 检查钢卷长度/厚度偏差并批量插入告警记录
     * 在 calculateTheoretical 计算出理论长度和理论厚度后调用
     *
     * @param coil 钢卷实体（需已填充 theoreticalLength/theoreticalThickness/actualLength/actualThickness/coilId）
     */
    void checkAndInsertWarnings(WmsMaterialCoil coil);
}