feat(wms): 添加钢卷长度厚度偏差自动告警功能

- 在IWmsMaterialWarningService接口中新增checkAndInsertWarnings方法定义
- 在WmsMaterialCoilServiceImpl中注入materialWarningService依赖
- 在钢卷新增、更新、拆分等操作后自动触发偏差检查和告警插入
- 实现doCheckAndInsertWarnings方法进行长度和厚度偏差计算
- 添加checkLength方法验证长度偏差是否超过10%
- 添加checkThickness方法验证厚度偏差包括偏薄ERROR和偏厚WARNING
- 实现批量插入告警记录并添加异常处理和日志记录

klp-wms/src/main/java/com/klp/service/impl/WmsMaterialWarningServiceImpl.java

@@ -8,13 +8,18 @@ import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.toolkit.Wrappers;
 import com.klp.common.utils.StringUtils;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
 import com.klp.domain.bo.WmsMaterialWarningBo;
 import com.klp.domain.vo.WmsMaterialWarningVo;
+import com.klp.domain.WmsMaterialCoil;
 import com.klp.domain.WmsMaterialWarning;
 import com.klp.mapper.WmsMaterialWarningMapper;
 import com.klp.service.IWmsMaterialWarningService;
 
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
 import java.util.Collection;
@@ -25,6 +30,7 @@ import java.util.Collection;
  * @author klp
  * @date 2026-06-06
  */
+@Slf4j
 @RequiredArgsConstructor
 @Service
 public class WmsMaterialWarningServiceImpl implements IWmsMaterialWarningService {
@@ -118,4 +124,143 @@ public class WmsMaterialWarningServiceImpl implements IWmsMaterialWarningService
         }
         return baseMapper.deleteBatchIds(ids) > 0;
     }
+
+    /**
+     * 检查钢卷长度/厚度偏差并批量插入告警记录
+     *
+     * 长度规则：ABS((实测长度 - 理论长度) / 理论长度) > 0.1 → 告警
+     * 厚度规则：
+     *   1. 实测厚度 < 理论厚度 → 偏薄告警(ERROR)
+     *   2. (实测厚度 - 理论厚度) / 理论厚度 > 0.1 → 偏厚告警(WARNING)
+     */
+    @Override
+    public void checkAndInsertWarnings(WmsMaterialCoil coil) {
+        try {
+            doCheckAndInsertWarnings(coil);
+        } catch (Exception e) {
+            log.error("钢卷告警检查异常, coilId={}, 不影响原流程", coil != null ? coil.getCoilId() : null, e);
+        }
+    }
+
+    private void doCheckAndInsertWarnings(WmsMaterialCoil coil) {
+        if (coil == null || coil.getCoilId() == null) {
+            return;
+        }
+
+        List<WmsMaterialWarning> warnings = new ArrayList<>();
+
+        // ========== 长度检查 ==========
+        checkLength(coil, warnings);
+
+        // ========== 厚度检查 ==========
+        checkThickness(coil, warnings);
+
+        // 批量插入
+        if (!warnings.isEmpty()) {
+            try {
+                baseMapper.insertBatch(warnings);
+                log.info("批量插入钢卷告警记录成功, coilId={}, 告警数={}", coil.getCoilId(), warnings.size());
+            } catch (Exception e) {
+                log.error("批量插入钢卷告警记录失败, coilId={}", coil.getCoilId(), e);
+            }
+        }
+    }
+
+    /**
+     * 长度偏差检查
+     * ABS((actualLength - theoreticalLength) / theoreticalLength) > 0.1 → WARNING
+     */
+    private void checkLength(WmsMaterialCoil coil, List<WmsMaterialWarning> warnings) {
+        Long actualLength = coil.getActualLength();
+        BigDecimal theoreticalLength = coil.getTheoreticalLength();
+
+        if (actualLength == null || theoreticalLength == null
+                || theoreticalLength.compareTo(BigDecimal.ZERO) == 0) {
+            return;
+        }
+
+        BigDecimal actual = new BigDecimal(actualLength);
+        BigDecimal diff = actual.subtract(theoreticalLength).abs();
+        BigDecimal rate = diff.divide(theoreticalLength, 10, RoundingMode.HALF_UP);
+
+        // 偏差率 > 0.1（即超过10%）
+        BigDecimal threshold = new BigDecimal("0.1");
+        if (rate.compareTo(threshold) > 0) {
+            WmsMaterialWarning warning = new WmsMaterialWarning();
+            warning.setCoilId(coil.getCoilId());
+            warning.setWarningType("LENGTH");
+            warning.setTheoreticalVal(theoreticalLength);
+            warning.setActualVal(actual);
+            warning.setAllowDeviation(threshold);
+            warning.setDeviationValue(actual.subtract(theoreticalLength));
+            warning.setDeviationRate(rate.multiply(new BigDecimal("100")).setScale(4, RoundingMode.HALF_UP));
+            warning.setWarningLevel("WARNING");
+            warning.setWarningMsg("钢卷长度偏差超过10%，理论长度=" + theoreticalLength + "m，实测长度=" + actualLength + "mm");
+            warning.setWarningStatus(0);
+            warnings.add(warning);
+        }
+    }
+
+    /**
+     * 厚度偏差检查
+     * 1. 实测厚度 < 理论厚度 → ERROR（不能比原来薄）
+     * 2. (实测厚度 - 理论厚度) / 理论厚度 > 0.1 → WARNING（不能厚太多）
+     */
+    private void checkThickness(WmsMaterialCoil coil, List<WmsMaterialWarning> warnings) {
+        String actualThicknessStr = coil.getActualThickness();
+        BigDecimal theoreticalThickness = coil.getTheoreticalThickness();
+
+        if (actualThicknessStr == null || theoreticalThickness == null
+                || theoreticalThickness.compareTo(BigDecimal.ZERO) == 0) {
+            return;
+        }
+
+        BigDecimal actualThickness;
+        try {
+            actualThickness = new BigDecimal(actualThicknessStr.trim());
+        } catch (NumberFormatException e) {
+            log.warn("实测厚度无法解析为数值, coilId={}, actualThickness={}", coil.getCoilId(), actualThicknessStr);
+            return;
+        }
+
+        BigDecimal threshold = new BigDecimal("0.1");
+
+        // 规则1：实测厚度 < 理论厚度 → 偏薄 ERROR
+        if (actualThickness.compareTo(theoreticalThickness) < 0) {
+            WmsMaterialWarning warning = new WmsMaterialWarning();
+            warning.setCoilId(coil.getCoilId());
+            warning.setWarningType("THICKNESS");
+            warning.setTheoreticalVal(theoreticalThickness);
+            warning.setActualVal(actualThickness);
+            warning.setAllowDeviation(BigDecimal.ZERO);
+            warning.setDeviationValue(actualThickness.subtract(theoreticalThickness));
+            BigDecimal rate = theoreticalThickness.subtract(actualThickness)
+                    .divide(theoreticalThickness, 10, RoundingMode.HALF_UP)
+                    .multiply(new BigDecimal("100")).setScale(4, RoundingMode.HALF_UP);
+            warning.setDeviationRate(rate);
+            warning.setWarningLevel("ERROR");
+            warning.setWarningMsg("钢卷实测厚度偏薄，理论厚度=" + theoreticalThickness + "mm，实测厚度=" + actualThickness + "mm");
+            warning.setWarningStatus(0);
+            warnings.add(warning);
+            return; // 偏薄已经足够严重，不再重复判断偏厚
+        }
+
+        // 规则2：(实测厚度 - 理论厚度) / 理论厚度 > 0.1 → 偏厚超10%
+        BigDecimal diff = actualThickness.subtract(theoreticalThickness);
+        BigDecimal rate = diff.divide(theoreticalThickness, 10, RoundingMode.HALF_UP);
+        if (rate.compareTo(threshold) > 0) {
+            WmsMaterialWarning warning = new WmsMaterialWarning();
+            warning.setCoilId(coil.getCoilId());
+            warning.setWarningType("THICKNESS");
+            warning.setTheoreticalVal(theoreticalThickness);
+            warning.setActualVal(actualThickness);
+            warning.setAllowDeviation(threshold);
+            warning.setDeviationValue(diff);
+            warning.setDeviationRate(rate.multiply(new BigDecimal("100")).setScale(4, RoundingMode.HALF_UP));
+            warning.setWarningLevel("WARNING");
+            warning.setWarningMsg("钢卷实测厚度偏厚超过10%，理论厚度=" + theoreticalThickness + "mm，实测厚度=" + actualThickness + "mm");
+            warning.setWarningStatus(0);
+            warnings.add(warning);
+        }
+    }
 }