feat（wms）：增加 inventory

YunaiV
1 parent dc8883d3
Showing 17 changed files with 738 additions and 5 deletions
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/controller/admin/inventory/WmsInventoryController.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/controller/admin/inventory/vo/WmsInventoryPageReqVO.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/controller/admin/inventory/vo/WmsInventoryRespVO.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/dal/dataobject/inventory/WmsInventoryDO.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/dal/dataobject/inventory/WmsInventoryDetailDO.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/dal/dataobject/inventory/WmsInventoryHistoryDO.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/dal/mysql/inventory/WmsInventoryMapper.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/dal/mysql/md/item/WmsItemSkuMapper.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/enums/ErrorCodeConstants.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/enums/inventory/WmsInventoryOrderTypeEnum.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/framework/config/WmsProperties.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/service/md/item/WmsItemService.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/service/md/item/WmsItemServiceImpl.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/service/md/item/WmsItemSkuService.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/service/md/item/WmsItemSkuServiceImpl.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/service/md/warehouse/WmsWarehouseAreaService.java
yudao-module-wms/src/main/java/cn/iocoder/yudao/module/wms/service/md/warehouse/WmsWarehouseAreaServiceImpl.java
+package cn.iocoder.yudao.module.wms.controller.admin.inventory;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.wms.controller.admin.inventory.vo.WmsInventoryPageReqVO;
+import cn.iocoder.yudao.module.wms.controller.admin.inventory.vo.WmsInventoryRespVO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.inventory.WmsInventoryDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemSkuDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseAreaDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseDO;
+import cn.iocoder.yudao.module.wms.framework.config.WmsProperties;
+import cn.iocoder.yudao.module.wms.service.inventory.WmsInventoryService;
+import cn.iocoder.yudao.module.wms.service.md.item.WmsItemService;
+import cn.iocoder.yudao.module.wms.service.md.item.WmsItemSkuService;
+import cn.iocoder.yudao.module.wms.service.md.warehouse.WmsWarehouseAreaService;
+import cn.iocoder.yudao.module.wms.service.md.warehouse.WmsWarehouseService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - WMS 库存统计")
+@RestController
+@RequestMapping("/wms/inventory")
+@Validated
+public class WmsInventoryController {
+
+    @Resource
+    private WmsInventoryService inventoryService;
+    @Resource
+    private WmsItemService itemService;
+    @Resource
+    private WmsItemSkuService itemSkuService;
+    @Resource
+    private WmsWarehouseService warehouseService;
+    @Resource
+    private WmsWarehouseAreaService warehouseAreaService;
+    @Resource
+    private WmsProperties wmsProperties;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得库存统计分页")
+    @PreAuthorize("@ss.hasPermission('wms:inventory:query')")
+    public CommonResult<PageResult<WmsInventoryRespVO>> getInventoryPage(@Valid WmsInventoryPageReqVO pageReqVO) {
+        PageResult<WmsInventoryDO> pageResult = inventoryService.getInventoryPage(pageReqVO);
+        return success(new PageResult<>(buildInventoryRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<WmsInventoryRespVO> buildInventoryRespVOList(List<WmsInventoryDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        Map<Long, WmsItemSkuDO> skuMap = itemSkuService.getItemSkuMap(convertSet(list, WmsInventoryDO::getSkuId));
+        Map<Long, WmsItemDO> itemMap = itemService.getItemMap(convertSet(skuMap.values(), WmsItemSkuDO::getItemId));
+        Map<Long, WmsWarehouseDO> warehouseMap = warehouseService.getWarehouseMap(
+                convertSet(list, WmsInventoryDO::getWarehouseId));
+        Map<Long, WmsWarehouseAreaDO> areaMap = wmsProperties.isAreaEnabled()
+                ? warehouseAreaService.getWarehouseAreaMap(convertSet(list, WmsInventoryDO::getAreaId))
+                : Collections.emptyMap();
+        return BeanUtils.toBean(list, WmsInventoryRespVO.class, vo -> {
+            MapUtils.findAndThen(skuMap, vo.getSkuId(), sku -> {
+                vo.setSkuCode(sku.getCode()).setSkuName(sku.getName()).setItemId(sku.getItemId());
+                MapUtils.findAndThen(itemMap, sku.getItemId(), item -> vo.setItemCode(item.getCode())
+                        .setItemName(item.getName()).setUnit(item.getUnit()));
+            });
+            MapUtils.findAndThen(warehouseMap, vo.getWarehouseId(), warehouse -> vo.setWarehouseName(warehouse.getName()));
+            MapUtils.findAndThen(areaMap, vo.getAreaId(), area -> vo.setAreaName(area.getName()));
+        });
+    }
+
+}
+package cn.iocoder.yudao.module.wms.controller.admin.inventory.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - WMS 库存统计分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class WmsInventoryPageReqVO extends PageParam {
+
+    /**
+     * 按仓库维度统计
+     */
+    public static final String TYPE_WAREHOUSE = "warehouse";
+
+    /**
+     * 按库区维度统计
+     */
+    public static final String TYPE_AREA = "area";
+
+    /**
+     * 按商品维度统计
+     */
+    public static final String TYPE_ITEM = "item";
+
+    @Schema(description = "统计维度", example = "warehouse")
+    private String type;
+
+    @Schema(description = "商品编号", example = "ITEM001")
+    private String itemCode;
+
+    @Schema(description = "商品名称", example = "红富士苹果")
+    private String itemName;
+
+    @Schema(description = "商品 SKU 编号", example = "1024")
+    private Long skuId;
+
+    @Schema(description = "规格编号", example = "SKU001")
+    private String skuCode;
+
+    @Schema(description = "规格名称", example = "10kg 箱装")
+    private String skuName;
+
+    @Schema(description = "仓库编号", example = "2048")
+    private Long warehouseId;
+
+    @Schema(description = "库区编号", example = "4096")
+    private Long areaId;
+
+    @Schema(description = "最小库存数量", example = "0.01")
+    private BigDecimal minQuantity;
+
+}
+package cn.iocoder.yudao.module.wms.controller.admin.inventory.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - WMS 库存统计 Response VO")
+@Data
+public class WmsInventoryRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "商品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
+    private Long itemId;
+    @Schema(description = "商品编码", example = "ITEM001")
+    private String itemCode;
+    @Schema(description = "商品名称", example = "红富士苹果")
+    private String itemName;
+    @Schema(description = "商品单位", example = "箱")
+    private String unit;
+
+    @Schema(description = "商品 SKU 编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "4096")
+    private Long skuId;
+    @Schema(description = "规格编号", example = "SKU001")
+    private String skuCode;
+    @Schema(description = "规格名称", example = "10kg 箱装")
+    private String skuName;
+
+    @Schema(description = "仓库编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "8192")
+    private Long warehouseId;
+    @Schema(description = "仓库名称", example = "成品仓")
+    private String warehouseName;
+    @Schema(description = "库区编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    private Long areaId;
+    @Schema(description = "库区名称", example = "A 区")
+    private String areaName;
+
+    @Schema(description = "库存数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    private BigDecimal quantity;
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
+package cn.iocoder.yudao.module.wms.dal.dataobject.inventory;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemSkuDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseAreaDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+/**
+ * WMS 库存 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("wms_inventory")
+@KeySequence("wms_inventory_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class WmsInventoryDO extends BaseDO {
+
+    /**
+     * 主键编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 商品 SKU 编号
+     *
+     * 关联 {@link WmsItemSkuDO#getId()}
+     */
+    private Long skuId;
+    /**
+     * 仓库编号
+     *
+     * 关联 {@link WmsWarehouseDO#getId()}
+     */
+    private Long warehouseId;
+    /**
+     * 库区编号
+     *
+     * 关联 {@link WmsWarehouseAreaDO#getId()}
+     */
+    private Long areaId;
+    /**
+     * 库存数量
+     */
+    private BigDecimal quantity;
+    /**
+     * 备注
+     */
+    private String remark;
+
+}
+package cn.iocoder.yudao.module.wms.dal.dataobject.inventory;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemSkuDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseAreaDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseDO;
+import cn.iocoder.yudao.module.wms.enums.inventory.WmsInventoryOrderTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * WMS 库存明细 DO
+ * <p>
+ * 记录可用库存明细余额，用于按库区、批次、效期扣减库存。
+ * 库存操作流水见 {@link WmsInventoryHistoryDO}。
+ *
+ * @author 芋道源码
+ */
+@TableName("wms_inventory_detail")
+@KeySequence("wms_inventory_detail_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class WmsInventoryDetailDO extends BaseDO {
+
+    /**
+     * 主键编号
+     */
+    @TableId
+    private Long id;
+
+    // ========= 库存维度相关字段 =========
+
+    /**
+     * 商品 SKU 编号
+     *
+     * 关联 {@link WmsItemSkuDO#getId()}
+     */
+    private Long skuId;
+    /**
+     * 仓库编号
+     *
+     * 关联 {@link WmsWarehouseDO#getId()}
+     */
+    private Long warehouseId;
+    /**
+     * 库区编号
+     *
+     * 关联 {@link WmsWarehouseAreaDO#getId()}
+     */
+    private Long areaId;
+    /**
+     * 数量
+     */
+    private BigDecimal quantity;
+    /**
+     * 剩余数量
+     */
+    private BigDecimal remainQuantity;
+
+    // ========= 批次效期相关字段 =========
+
+    /**
+     * 批号
+     */
+    private String batchNo;
+    /**
+     * 生产日期
+     */
+    private LocalDateTime productionDate;
+    /**
+     * 过期日期
+     */
+    private LocalDateTime expirationDate;
+
+    // ========= 金额备注相关字段 =========
+
+    /**
+     * 金额（小计、非单价）
+     */
+    private BigDecimal amount;
+    /**
+     * 备注
+     */
+    private String remark;
+
+    // ========= 来源单据相关字段 =========
+
+    /**
+     * 操作单编号
+     *
+     * 关联来源单据的主键编号，单据类型见 {@link #orderType}
+     */
+    private Long orderId;
+    /**
+     * 操作单号
+     *
+     * 关联来源单据的单号，单据类型见 {@link #orderType}
+     */
+    private String orderNo;
+    /**
+     * 操作类型
+     *
+     * 枚举 {@link WmsInventoryOrderTypeEnum#getType()}
+     */
+    private Integer orderType;
+
+}
+package cn.iocoder.yudao.module.wms.dal.dataobject.inventory;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemSkuDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseAreaDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseDO;
+import cn.iocoder.yudao.module.wms.enums.inventory.WmsInventoryOrderTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * WMS 库存流水 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("wms_inventory_history")
+@KeySequence("wms_inventory_history_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class WmsInventoryHistoryDO extends BaseDO {
+
+    /**
+     * 主键编号
+     */
+    @TableId
+    private Long id;
+
+    // ========= 库存维度相关字段 =========
+
+    /**
+     * 仓库编号
+     *
+     * 关联 {@link WmsWarehouseDO#getId()}
+     */
+    private Long warehouseId;
+    /**
+     * 库区编号
+     *
+     * 关联 {@link WmsWarehouseAreaDO#getId()}
+     */
+    private Long areaId;
+    /**
+     * 商品 SKU 编号
+     *
+     * 关联 {@link WmsItemSkuDO#getId()}
+     */
+    private Long skuId;
+    /**
+     * 库存变化数量
+     */
+    private BigDecimal quantity;
+    /**
+     * 变化前库存数量
+     */
+    private BigDecimal beforeQuantity;
+    /**
+     * 变化后库存数量
+     */
+    private BigDecimal afterQuantity;
+
+    // ========= 批次效期相关字段 =========
+
+    /**
+     * 批号
+     */
+    private String batchNo;
+    /**
+     * 生产日期
+     */
+    private LocalDateTime productionDate;
+    /**
+     * 过期日期
+     */
+    private LocalDateTime expirationDate;
+
+    // ========= 金额备注相关字段 =========
+
+    /**
+     * 金额
+     */
+    private BigDecimal amount;
+    /**
+     * 备注
+     */
+    private String remark;
+
+    // ========= 来源单据相关字段 =========
+
+    /**
+     * 操作单编号
+     */
+    private Long orderId;
+    /**
+     * 操作单号
+     */
+    private String orderNo;
+    /**
+     * 操作类型
+     *
+     * 枚举 {@link WmsInventoryOrderTypeEnum#getType()}
+     */
+    private Integer orderType;
+
+}
+package cn.iocoder.yudao.module.wms.dal.mysql.inventory;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.wms.controller.admin.inventory.vo.WmsInventoryPageReqVO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.inventory.WmsInventoryDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemDO;
+import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemSkuDO;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * WMS 库存 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface WmsInventoryMapper extends BaseMapperX<WmsInventoryDO> {
+
+    default PageResult<WmsInventoryDO> selectPage(WmsInventoryPageReqVO reqVO) {
+        MPJLambdaWrapperX<WmsInventoryDO> query = new MPJLambdaWrapperX<WmsInventoryDO>()
+                .selectAll(WmsInventoryDO.class)
+                .innerJoin(WmsItemSkuDO.class, WmsItemSkuDO::getId, WmsInventoryDO::getSkuId)
+                .innerJoin(WmsItemDO.class, WmsItemDO::getId, WmsItemSkuDO::getItemId)
+                .likeIfPresent(WmsItemDO::getCode, reqVO.getItemCode())
+                .likeIfPresent(WmsItemDO::getName, reqVO.getItemName())
+                .eqIfPresent(WmsInventoryDO::getSkuId, reqVO.getSkuId())
+                .likeIfPresent(WmsItemSkuDO::getCode, reqVO.getSkuCode())
+                .likeIfPresent(WmsItemSkuDO::getName, reqVO.getSkuName())
+                .eqIfPresent(WmsInventoryDO::getWarehouseId, reqVO.getWarehouseId())
+                .eqIfPresent(WmsInventoryDO::getAreaId, reqVO.getAreaId())
+                .geIfPresent(WmsInventoryDO::getQuantity, reqVO.getMinQuantity());
+        appendDimensionOrder(query, reqVO.getType());
+        return selectJoinPage(reqVO, WmsInventoryDO.class, query);
+    }
+
+    default Long selectCountBySkuId(Long skuId) {
+        return selectCount(WmsInventoryDO::getSkuId, skuId);
+    }
+
+    private static void appendDimensionOrder(MPJLambdaWrapperX<WmsInventoryDO> query, String type) {
+        if (StrUtil.equals(WmsInventoryPageReqVO.TYPE_WAREHOUSE, type)) {
+            query.orderByAsc(WmsInventoryDO::getWarehouseId)
+                    .orderByAsc(WmsItemSkuDO::getItemId)
+                    .orderByAsc(WmsInventoryDO::getSkuId)
+                    .orderByAsc(WmsInventoryDO::getId);
+            return;
+        }
+        if (StrUtil.equals(WmsInventoryPageReqVO.TYPE_ITEM, type)) {
+            query.orderByAsc(WmsItemSkuDO::getItemId)
+                    .orderByAsc(WmsInventoryDO::getSkuId)
+                    .orderByAsc(WmsInventoryDO::getWarehouseId)
+                    .orderByAsc(WmsInventoryDO::getAreaId)
+                    .orderByAsc(WmsInventoryDO::getId);
+            return;
+        }
+        if (StrUtil.equals(WmsInventoryPageReqVO.TYPE_AREA, type)) {
+            query.orderByAsc(WmsInventoryDO::getWarehouseId)
+                    .orderByAsc(WmsInventoryDO::getAreaId)
+                    .orderByAsc(WmsItemSkuDO::getItemId)
+                    .orderByAsc(WmsInventoryDO::getSkuId)
+                    .orderByAsc(WmsInventoryDO::getId);
+            return;
+        }
+        throw new IllegalArgumentException("未知库存统计维度：" + type);
+    }
+
+}
@@ -33,6 +33,17 @@ public interface WmsItemSkuMapper extends BaseMapperX&lt;WmsItemSkuDO&gt; {
                 .orderByAsc(WmsItemSkuDO::getId));
     }
+    default List<WmsItemSkuDO> selectList(Collection<Long> itemIds, String code, String name) {
+        if (itemIds != null && CollUtil.isEmpty(itemIds)) {
+            return Collections.emptyList();
+        }
+        return selectList(new LambdaQueryWrapperX<WmsItemSkuDO>()
+                .inIfPresent(WmsItemSkuDO::getItemId, itemIds)
+                .likeIfPresent(WmsItemSkuDO::getCode, code)
+                .likeIfPresent(WmsItemSkuDO::getName, name)
+                .orderByAsc(WmsItemSkuDO::getId));
+    }
+
     default void deleteByItemId(Long itemId) {
         delete(WmsItemSkuDO::getItemId, itemId);
     }
@@ -42,6 +42,7 @@ public interface ErrorCodeConstants {
     ErrorCode ITEM_SKU_REQUIRED = new ErrorCode(1_060_104_002, "至少包含一个商品规格");
     ErrorCode ITEM_SKU_NAME_DUPLICATE = new ErrorCode(1_060_104_003, "商品规格名称【{}】重复");
     ErrorCode ITEM_SKU_NOT_EXISTS = new ErrorCode(1_060_104_004, "商品规格不存在");
+    ErrorCode ITEM_SKU_HAS_INVENTORY = new ErrorCode(1_060_104_005, "删除失败！商品规格【{}】已被库存业务使用！");
     // ========== WMS 基础数据-往来企业 1-060-105-000 ==========
     ErrorCode MERCHANT_NOT_EXISTS = new ErrorCode(1_060_105_000, "往来企业不存在");
+package cn.iocoder.yudao.module.wms.enums.inventory;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * WMS 库存操作类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum WmsInventoryOrderTypeEnum implements ArrayValuable<Integer> {
+
+    RECEIPT(1, "入库"),
+    SHIPMENT(2, "出库"),
+    MOVEMENT(3, "移库"),
+    CHECK(4, "盘库");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values()).map(WmsInventoryOrderTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+}
@@ -21,7 +21,7 @@ public class WmsProperties {
      * 是否启用库区模式
      */
     @NotNull(message = "是否启用库区模式不能为空")
-    private Boolean areaEnable = false;
+    private Boolean areaEnable = true;
     /**
      * 是否启用批次/效期/库存明细模式
@@ -29,7 +29,7 @@ public class WmsProperties {
      * 依赖 {@link #areaEnable} 为 true
      */
     @NotNull(message = "是否启用批次/效期/库存明细模式不能为空")
-    private Boolean batchEnable = false;
+    private Boolean batchEnable = true;
     public boolean isAreaEnabled() {
         return Boolean.TRUE.equals(areaEnable);
@@ -6,7 +6,11 @@ import cn.iocoder.yudao.module.wms.controller.admin.md.item.vo.item.WmsItemSaveR
 import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemDO;
 import jakarta.validation.Valid;
+import java.util.Collection;
 import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
 /**
  * WMS 商品 Service 接口
@@ -70,6 +74,24 @@ public interface WmsItemService {
     List<WmsItemDO> getItemList(WmsItemPageReqVO pageReqVO);
     /**
+     * 按编号集合获得商品列表
+     *
+     * @param ids 编号集合
+     * @return 商品列表
+     */
+    List<WmsItemDO> getItemList(Collection<Long> ids);
+
+    /**
+     * 按编号集合获得商品 Map
+     *
+     * @param ids 编号集合
+     * @return 商品 Map
+     */
+    default Map<Long, WmsItemDO> getItemMap(Collection<Long> ids) {
+        return convertMap(getItemList(ids), WmsItemDO::getId);
+    }
+
+    /**
      * 获得指定商品分类下的商品数量
      *
      * @param categoryId 商品分类编号
 package cn.iocoder.yudao.module.wms.service.md.item;
+import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.ObjectUtil;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
 import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
@@ -13,6 +14,8 @@ import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.validation.annotation.Validated;
+import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
 import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
@@ -135,6 +138,14 @@ public class WmsItemServiceImpl implements WmsItemService {
     }
     @Override
+    public List<WmsItemDO> getItemList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return itemMapper.selectByIds(ids);
+    }
+
+    @Override
     public long getItemCountByCategoryId(Long categoryId) {
         return itemMapper.selectCountByCategoryId(categoryId);
     }
@@ -8,6 +8,7 @@ import java.util.Collection;
 import java.util.List;
 import java.util.Map;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
 import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
 /**
@@ -57,6 +58,34 @@ public interface WmsItemSkuService {
     List<WmsItemSkuDO> getItemSkuList(Collection<Long> itemIds);
     /**
+     * 获得 SKU 列表
+     *
+     * @param itemIds 商品编号集合
+     * @param code SKU 编号
+     * @param name SKU 名称
+     * @return SKU 列表
+     */
+    List<WmsItemSkuDO> getItemSkuList(Collection<Long> itemIds, String code, String name);
+
+    /**
+     * 按编号集合获得 SKU 列表
+     *
+     * @param ids 编号集合
+     * @return SKU 列表
+     */
+    List<WmsItemSkuDO> getItemSkuListByIds(Collection<Long> ids);
+
+    /**
+     * 按编号集合获得 SKU Map
+     *
+     * @param ids 编号集合
+     * @return SKU Map
+     */
+    default Map<Long, WmsItemSkuDO> getItemSkuMap(Collection<Long> ids) {
+        return convertMap(getItemSkuListByIds(ids), WmsItemSkuDO::getId);
+    }
+
+    /**
      * 按商品编号集合获得 SKU MultiMap
      *
      * @param itemIds 商品编号集合
@@ -6,8 +6,10 @@ import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
 import cn.iocoder.yudao.module.wms.controller.admin.md.item.vo.sku.WmsItemSkuSaveReqVO;
 import cn.iocoder.yudao.module.wms.dal.dataobject.md.item.WmsItemSkuDO;
 import cn.iocoder.yudao.module.wms.dal.mysql.md.item.WmsItemSkuMapper;
+import cn.iocoder.yudao.module.wms.service.inventory.WmsInventoryService;
 import cn.iocoder.yudao.module.wms.util.WmsUtils;
 import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.validation.annotation.Validated;
@@ -32,6 +34,9 @@ public class WmsItemSkuServiceImpl implements WmsItemSkuService {
     @Resource
     private WmsItemSkuMapper itemSkuMapper;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private WmsInventoryService inventoryService;
     @Override
     @Transactional(rollbackFor = Exception.class)
@@ -58,8 +63,9 @@ public class WmsItemSkuServiceImpl implements WmsItemSkuService {
         // 第二步，批量添加、修改、删除
         if (CollUtil.isNotEmpty(diffList.get(2))) {
-            // TODO 库存模块实现后，校验商品规格下不存在库存业务数据后再删除
-            itemSkuMapper.deleteByIds(convertList(diffList.get(2), WmsItemSkuDO::getId));
+            List<Long> deleteSkuIds = convertList(diffList.get(2), WmsItemSkuDO::getId);
+            validateItemSkuUnused(diffList.get(2));
+            itemSkuMapper.deleteByIds(deleteSkuIds);
         }
         if (CollUtil.isNotEmpty(diffList.get(0))) {
             if (CollUtil.isNotEmpty(convertList(diffList.get(0), WmsItemSkuDO::getId))) {
@@ -79,7 +85,8 @@ public class WmsItemSkuServiceImpl implements WmsItemSkuService {
     @Override
     @Transactional(rollbackFor = Exception.class)
     public void deleteItemSkuListByItemId(Long itemId) {
-        // TODO 库存模块实现后，校验商品规格下不存在库存业务数据后再删除
+        List<WmsItemSkuDO> skus = itemSkuMapper.selectListByItemId(itemId);
+        validateItemSkuUnused(skus);
         itemSkuMapper.deleteByItemId(itemId);
     }
@@ -93,6 +100,19 @@ public class WmsItemSkuServiceImpl implements WmsItemSkuService {
         return itemSkuMapper.selectListByItemIds(itemIds);
     }
+    @Override
+    public List<WmsItemSkuDO> getItemSkuList(Collection<Long> itemIds, String code, String name) {
+        return itemSkuMapper.selectList(itemIds, code, name);
+    }
+
+    @Override
+    public List<WmsItemSkuDO> getItemSkuListByIds(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return List.of();
+        }
+        return itemSkuMapper.selectByIds(ids);
+    }
+
     private void validateItemSkuList(List<WmsItemSkuSaveReqVO> skus) {
         // 校验至少存在一个商品 SKU
         if (CollUtil.isEmpty(skus)) {
@@ -107,6 +127,17 @@ public class WmsItemSkuServiceImpl implements WmsItemSkuService {
         }
     }
+    private void validateItemSkuUnused(List<WmsItemSkuDO> skus) {
+        if (CollUtil.isEmpty(skus)) {
+            return;
+        }
+        for (WmsItemSkuDO sku : skus) {
+            if (inventoryService.getInventoryCountBySkuId(sku.getId()) > 0) {
+                throw exception(ITEM_SKU_HAS_INVENTORY, sku.getName());
+            }
+        }
+    }
+
     /**
      * 填充空的条形码
      *
@@ -6,7 +6,11 @@ import cn.iocoder.yudao.module.wms.controller.admin.md.warehouse.vo.area.WmsWare
 import cn.iocoder.yudao.module.wms.dal.dataobject.md.warehouse.WmsWarehouseAreaDO;
 import jakarta.validation.Valid;
+import java.util.Collection;
 import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
 /**
  * WMS 库区 Service 接口
@@ -69,4 +73,22 @@ public interface WmsWarehouseAreaService {
      */
     List<WmsWarehouseAreaDO> getWarehouseAreaList(Long warehouseId);
+    /**
+     * 按编号集合获得库区列表
+     *
+     * @param ids 编号集合
+     * @return 库区列表
+     */
+    List<WmsWarehouseAreaDO> getWarehouseAreaList(Collection<Long> ids);
+
+    /**
+     * 按编号集合获得库区 Map
+     *
+     * @param ids 编号集合
+     * @return 库区 Map
+     */
+    default Map<Long, WmsWarehouseAreaDO> getWarehouseAreaMap(Collection<Long> ids) {
+        return convertMap(getWarehouseAreaList(ids), WmsWarehouseAreaDO::getId);
+    }
+
 }
 package cn.iocoder.yudao.module.wms.service.md.warehouse;
+import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.ObjUtil;
 import cn.hutool.core.util.StrUtil;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
@@ -13,6 +14,8 @@ import jakarta.annotation.Resource;
 import org.springframework.stereotype.Service;
 import org.springframework.validation.annotation.Validated;
+import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
 import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
@@ -127,6 +130,15 @@ public class WmsWarehouseAreaServiceImpl implements WmsWarehouseAreaService {
         return warehouseAreaMapper.selectListByWarehouseId(warehouseId);
     }
+    @Override
+    public List<WmsWarehouseAreaDO> getWarehouseAreaList(Collection<Long> ids) {
+        validateAreaEnabled();
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return warehouseAreaMapper.selectByIds(ids);
+    }
+
     private void validateAreaEnabled() {
         if (!wmsProperties.isAreaEnabled()) {
             throw exception(WMS_AREA_DISABLED);