feat(wms,oms)：出库排名统计改造为聚合排名——商品按物料合并/线路按线路+物料合并，按出库数量降序

- 商品tab：一行=一个货品(跨出库单汇总)，返回 货号/货名/件数/毛重(吨)/体积(CBM)/退保总额(占位null)，忽略线路筛选参数

- 线路tab：一行=线路×货品(按线路+物料编码合并)，额外返回 线路编码/线路，仅统计带线路的单(排除line_code为空的历史单)；商品/线路筛选参数均生效

- 单据级字段(种类/仓单编号/入库单号/客户编号/收货人/出仓日期)合并后无单值可对应，不再返回

- 件数=SUM(CHECK_QUANTITY)复核确认的实际出库量(与入库排名实际上架量SHELVES_QUANTITY对称)，按件数降序，编码次之

- 合计行：件数/毛重吨/体积 全量合计；商品tab含totalOrderCount(去重出库单数)，线路tab含totalOrderCount+totalLineCount(去重线路数)

- 数据源不变：WMS查本库出库表，OMS跨库查NGWL_TEST_WMS同名表，两边数字一致；接口路径/传参不变

mhd_wms/src/main/java/com/mhd/wms/application/service/outboundRank/OutboundRankApplicationService.java

@@ -6,8 +6,9 @@ import com.mhd.common.security.utils.SecurityUtils;
 import com.mhd.system.api.domain.cache.AssociationWarehouseCacheDO;
 import com.mhd.system.api.domain.cache.SystemServiceCacheUtil;
 import com.mhd.system.api.model.LoginUser;
-import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankPO;
 import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankTotalPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundLineRankPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundMaterialRankPO;
 import com.mhd.wms.domain.outboundRank.repository.todo.OutboundRankDO;
 import com.mhd.wms.domain.outboundRank.service.OutboundRankDomainService;
 import lombok.extern.slf4j.Slf4j;
@@ -17,7 +18,7 @@ import org.springframework.stereotype.Service;
 import java.util.List;
 
 /**
- * 出库排名统计（明细）应用服务
+ * 出库排名统计应用服务
  *
  * <p>负责登录用户组织隔离注入、日期区间校验，查询逻辑在 OutboundRankDomainService → OutboundRankMapper.xml</p>
  *
@@ -32,26 +33,49 @@ public class OutboundRankApplicationService {
     private OutboundRankDomainService outboundRankDomainService;
 
     /**
-     * 分页查询出库明细列表
+     * 分页查询商品出库排名列表（货品聚合）
      */
-    public List<OutboundDetailRankPO> queryDetailList(OutboundRankDO outboundRankDO) {
+    public List<OutboundMaterialRankPO> queryMaterialRankList(OutboundRankDO outboundRankDO) {
         fillLoginContext(outboundRankDO);
-        return outboundRankDomainService.queryDetailList(outboundRankDO);
+        return outboundRankDomainService.queryMaterialRankList(outboundRankDO);
     }
 
     /**
-     * 出库明细合计（当前筛选条件全量，不分页）
+     * 商品出库排名合计（当前筛选条件全量，不分页）
      */
-    public OutboundDetailRankTotalPO queryDetailTotal(OutboundRankDO outboundRankDO) {
-        return outboundRankDomainService.queryDetailTotal(outboundRankDO);
+    public OutboundDetailRankTotalPO queryMaterialRankTotal(OutboundRankDO outboundRankDO) {
+        return outboundRankDomainService.queryMaterialRankTotal(outboundRankDO);
     }
 
     /**
-     * 导出出库明细（不分页全量）
+     * 导出商品出库排名（不分页全量）
      */
-    public List<OutboundDetailRankPO> exportDetailList(OutboundRankDO outboundRankDO) {
+    public List<OutboundMaterialRankPO> exportMaterialRankList(OutboundRankDO outboundRankDO) {
         fillLoginContext(outboundRankDO);
-        return outboundRankDomainService.queryDetailList(outboundRankDO);
+        return outboundRankDomainService.queryMaterialRankList(outboundRankDO);
+    }
+
+    /**
+     * 分页查询线路出库排名列表（线路×货品聚合）
+     */
+    public List<OutboundLineRankPO> queryLineRankList(OutboundRankDO outboundRankDO) {
+        fillLoginContext(outboundRankDO);
+        return outboundRankDomainService.queryLineRankList(outboundRankDO);
+    }
+
+    /**
+     * 线路出库排名合计（当前筛选条件全量，不分页）
+     */
+    public OutboundDetailRankTotalPO queryLineRankTotal(OutboundRankDO outboundRankDO) {
+        return outboundRankDomainService.queryLineRankTotal(outboundRankDO);
+    }
+
+    /**
+     * 导出线路出库排名（不分页全量）
+     */
+    public List<OutboundLineRankPO> exportLineRankList(OutboundRankDO outboundRankDO) {
+        fillLoginContext(outboundRankDO);
+        return outboundRankDomainService.queryLineRankList(outboundRankDO);
     }
 
     /**

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/facade/IOutboundRankService.java

@@ -1,13 +1,14 @@
 package com.mhd.wms.domain.outboundRank.repository.facade;
 
-import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankPO;
 import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankTotalPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundLineRankPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundMaterialRankPO;
 import com.mhd.wms.domain.outboundRank.repository.todo.OutboundRankDO;
 
 import java.util.List;
 
 /**
- * 出库排名统计（明细）Service接口
+ * 出库排名统计Service接口
  *
  * @author rcx
  * @date 2026-08-31
@@ -15,12 +16,22 @@ import java.util.List;
 public interface IOutboundRankService {
 
     /**
-     * 出库明细列表
+     * 商品出库排名列表（货品聚合）
      */
-    List<OutboundDetailRankPO> queryDetailList(OutboundRankDO outboundRankDO);
+    List<OutboundMaterialRankPO> queryMaterialRankList(OutboundRankDO outboundRankDO);
 
     /**
-     * 出库明细合计（不分页）
+     * 商品出库排名合计（不分页）
      */
-    OutboundDetailRankTotalPO queryDetailTotal(OutboundRankDO outboundRankDO);
+    OutboundDetailRankTotalPO queryMaterialRankTotal(OutboundRankDO outboundRankDO);
+
+    /**
+     * 线路出库排名列表（线路×货品聚合）
+     */
+    List<OutboundLineRankPO> queryLineRankList(OutboundRankDO outboundRankDO);
+
+    /**
+     * 线路出库排名合计（不分页）
+     */
+    OutboundDetailRankTotalPO queryLineRankTotal(OutboundRankDO outboundRankDO);
 }

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/mapper/OutboundRankMapper.java

@@ -1,13 +1,14 @@
 package com.mhd.wms.domain.outboundRank.repository.mapper;
 
-import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankPO;
 import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankTotalPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundLineRankPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundMaterialRankPO;
 import com.mhd.wms.domain.outboundRank.repository.todo.OutboundRankDO;
 
 import java.util.List;
 
 /**
- * 出库排名统计（明细）Mapper接口
+ * 出库排名统计Mapper接口
  *
  * @author rcx
  * @date 2026-08-31
@@ -15,12 +16,22 @@ import java.util.List;
 public interface OutboundRankMapper {
 
     /**
-     * 出库明细列表（一行=仓单×货品，按件数倒序）
+     * 商品出库排名列表（一行=一个货品，跨单汇总，按实际出库量降序）
      */
-    List<OutboundDetailRankPO> queryDetailList(OutboundRankDO outboundRankDO);
+    List<OutboundMaterialRankPO> queryMaterialRankList(OutboundRankDO outboundRankDO);
 
     /**
-     * 出库明细合计（不分页，当前筛选条件全量合计）
+     * 商品出库排名合计（不分页，当前筛选条件全量合计）
      */
-    OutboundDetailRankTotalPO queryDetailTotal(OutboundRankDO outboundRankDO);
+    OutboundDetailRankTotalPO queryMaterialRankTotal(OutboundRankDO outboundRankDO);
+
+    /**
+     * 线路出库排名列表（一行=线路×货品，按实际出库量降序，仅统计带线路的单）
+     */
+    List<OutboundLineRankPO> queryLineRankList(OutboundRankDO outboundRankDO);
+
+    /**
+     * 线路出库排名合计（不分页，当前筛选条件全量合计）
+     */
+    OutboundDetailRankTotalPO queryLineRankTotal(OutboundRankDO outboundRankDO);
 }

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/persistence/OutboundRankImpl.java

@@ -2,8 +2,9 @@ package com.mhd.wms.domain.outboundRank.repository.persistence;
 
 import com.mhd.wms.domain.outboundRank.repository.facade.IOutboundRankService;
 import com.mhd.wms.domain.outboundRank.repository.mapper.OutboundRankMapper;
-import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankPO;
 import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankTotalPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundLineRankPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundMaterialRankPO;
 import com.mhd.wms.domain.outboundRank.repository.todo.OutboundRankDO;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
@@ -11,7 +12,7 @@ import org.springframework.stereotype.Service;
 import java.util.List;
 
 /**
- * 出库排名统计（明细）Service业务层处理
+ * 出库排名统计Service业务层处理
  *
  * @author rcx
  * @date 2026-08-31
@@ -23,12 +24,22 @@ public class OutboundRankImpl implements IOutboundRankService {
     private OutboundRankMapper outboundRankMapper;
 
     @Override
-    public List<OutboundDetailRankPO> queryDetailList(OutboundRankDO outboundRankDO) {
-        return outboundRankMapper.queryDetailList(outboundRankDO);
+    public List<OutboundMaterialRankPO> queryMaterialRankList(OutboundRankDO outboundRankDO) {
+        return outboundRankMapper.queryMaterialRankList(outboundRankDO);
     }
 
     @Override
-    public OutboundDetailRankTotalPO queryDetailTotal(OutboundRankDO outboundRankDO) {
-        return outboundRankMapper.queryDetailTotal(outboundRankDO);
+    public OutboundDetailRankTotalPO queryMaterialRankTotal(OutboundRankDO outboundRankDO) {
+        return outboundRankMapper.queryMaterialRankTotal(outboundRankDO);
+    }
+
+    @Override
+    public List<OutboundLineRankPO> queryLineRankList(OutboundRankDO outboundRankDO) {
+        return outboundRankMapper.queryLineRankList(outboundRankDO);
+    }
+
+    @Override
+    public OutboundDetailRankTotalPO queryLineRankTotal(OutboundRankDO outboundRankDO) {
+        return outboundRankMapper.queryLineRankTotal(outboundRankDO);
     }
 }

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/po/OutboundDetailRankPO.java

@@ -1,85 +0,0 @@
-package com.mhd.wms.domain.outboundRank.repository.po;
-
-import com.fasterxml.jackson.annotation.JsonFormat;
-import com.mhd.common.core.annotation.Excel;
-import io.swagger.annotations.ApiModel;
-import io.swagger.annotations.ApiModelProperty;
-import lombok.Data;
-import org.springframework.format.annotation.DateTimeFormat;
-
-import java.io.Serializable;
-import java.math.BigDecimal;
-import java.util.Date;
-
-/**
- * 出库排名统计（明细）PO（一行 = 仓单×货品，件数/毛重/体积按行汇总）
- *
- * <p>字段口径：种类=出库单据类型；仓单编号=出库单号；收货人=出库单 TO 栏(为空取联系人)；
- * 毛重(吨)=明细总毛重KG/1000；出仓日期=出仓日期(为空依次兜底完成时间/创建时间)；
- * 退保总额为占位字段，后端暂无对应数据来源，恒为 null（候选：货品档案保额 insure_amount，确认后可补）</p>
- *
- * @author rcx
- * @date 2026-08-31
- */
-@Data
-@ApiModel(value = "出库排名统计明细对象", description = "出库排名统计明细响应对象")
-public class OutboundDetailRankPO implements Serializable {
-
-    private static final long serialVersionUID = 1L;
-
-    @ApiModelProperty("种类（出库单据类型）")
-    @Excel(name = "种类")
-    private String orderTypeName;
-
-    @ApiModelProperty("仓单编号（出库单号）")
-    @Excel(name = "仓单编号")
-    private String outOrderNumber;
-
-    @ApiModelProperty("入库单号")
-    @Excel(name = "入库单号")
-    private String inOrderNumber;
-
-    @ApiModelProperty("客户编号")
-    @Excel(name = "客户编号")
-    private String customerCode;
-
-    @ApiModelProperty("收货人（出库单 TO 栏，为空取联系人）")
-    @Excel(name = "收货人")
-    private String receiver;
-
-    @ApiModelProperty("商品货号（辅助字段，不导出）")
-    private String materialCode;
-
-    @ApiModelProperty("货名")
-    @Excel(name = "货名")
-    private String materialName;
-
-    @ApiModelProperty("线路编码（辅助字段，不导出）")
-    private String lineCode;
-
-    @ApiModelProperty("线路")
-    @Excel(name = "线路")
-    private String lineName;
-
-    @ApiModelProperty("件数（复核确认的实际出库量合计，与入库排名的实际上架量对称）")
-    @Excel(name = "件数")
-    private BigDecimal pieceCount;
-
-    @ApiModelProperty("毛重(吨)")
-    @Excel(name = "毛重(吨)")
-    private BigDecimal grossWeightTon;
-
-    @ApiModelProperty("体积(CBM)")
-    @Excel(name = "体积(CBM)")
-    private BigDecimal totalVolume;
-
-    @ApiModelProperty("退保总额（占位字段，后端暂无数据来源，恒为 null）")
-    @Excel(name = "退保总额")
-    private BigDecimal depositRefundAmount;
-
-    @ApiModelProperty("出仓日期（出仓日期为空时依次兜底完成时间/创建时间）")
-    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
-    @DateTimeFormat(pattern = "yyyy-MM-dd")
-    @Excel(name = "出仓日期", width = 30, dateFormat = "yyyy-MM-dd")
-    private Date outboundDate;
-}

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/po/OutboundDetailRankTotalPO.java

@@ -33,4 +33,7 @@ public class OutboundDetailRankTotalPO implements Serializable {
 
     @ApiModelProperty("仓单数合计（去重出库单数）")
     private Long totalOrderCount;
+
+    @ApiModelProperty("线路数合计（去重线路数，线路排名使用）")
+    private Long totalLineCount;
 }

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/po/OutboundLineRankPO.java

@@ -0,0 +1,59 @@
+package com.mhd.wms.domain.outboundRank.repository.po;
+
+import com.mhd.common.core.annotation.Excel;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+
+/**
+ * 线路出库排名PO（一行 = 线路×货品，日期区间内汇总）
+ *
+ * <p>按线路+物料编码合并：多张出库单合并为一行，单据级字段（种类/仓单编号/入库单号/客户编号/收货人/出仓日期）不提供；
+ * 仅统计带线路的出库单（line_code 为 2026-08-20 新增冗余字段，历史单为空，不参与线路排名）；
+ * 件数 = SUM(CHECK_QUANTITY) 复核确认的实际出库量（与入库排名的实际上架量对称）；
+ * 退保总额为占位字段，后端暂无对应数据来源，恒为 null</p>
+ *
+ * @author rcx
+ * @date 2026-08-31
+ */
+@Data
+@ApiModel(value = "线路出库排名对象", description = "线路出库排名响应对象")
+public class OutboundLineRankPO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("线路编码")
+    @Excel(name = "线路编码")
+    private String lineCode;
+
+    @ApiModelProperty("线路")
+    @Excel(name = "线路")
+    private String lineName;
+
+    @ApiModelProperty("商品货号")
+    @Excel(name = "商品货号")
+    private String materialCode;
+
+    @ApiModelProperty("货名")
+    @Excel(name = "货名")
+    private String materialName;
+
+    @ApiModelProperty("件数（复核确认的实际出库量合计，与入库排名的实际上架量对称）")
+    @Excel(name = "件数")
+    private BigDecimal pieceCount;
+
+    @ApiModelProperty("毛重(吨)")
+    @Excel(name = "毛重(吨)")
+    private BigDecimal grossWeightTon;
+
+    @ApiModelProperty("体积(CBM)")
+    @Excel(name = "体积(CBM)")
+    private BigDecimal totalVolume;
+
+    @ApiModelProperty("退保总额（占位字段，后端暂无数据来源，恒为 null）")
+    @Excel(name = "退保总额")
+    private BigDecimal depositRefundAmount;
+}

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/repository/po/OutboundMaterialRankPO.java

@@ -0,0 +1,50 @@
+package com.mhd.wms.domain.outboundRank.repository.po;
+
+import com.mhd.common.core.annotation.Excel;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+
+/**
+ * 商品出库排名PO（一行 = 一个货品，日期区间内跨出库单汇总）
+ *
+ * <p>按物料编码合并：一个货品会走多条线路/多张单，单据级字段（种类/仓单编号/入库单号/客户编号/收货人/出仓日期）与
+ * 线路字段均无单值可返，不提供；件数 = SUM(CHECK_QUANTITY) 复核确认的实际出库量（与入库排名的实际上架量对称）；
+ * 退保总额为占位字段，后端暂无对应数据来源，恒为 null</p>
+ *
+ * @author rcx
+ * @date 2026-08-31
+ */
+@Data
+@ApiModel(value = "商品出库排名对象", description = "商品出库排名响应对象")
+public class OutboundMaterialRankPO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("商品货号")
+    @Excel(name = "商品货号")
+    private String materialCode;
+
+    @ApiModelProperty("货名")
+    @Excel(name = "货名")
+    private String materialName;
+
+    @ApiModelProperty("件数（复核确认的实际出库量合计，与入库排名的实际上架量对称）")
+    @Excel(name = "件数")
+    private BigDecimal pieceCount;
+
+    @ApiModelProperty("毛重(吨)")
+    @Excel(name = "毛重(吨)")
+    private BigDecimal grossWeightTon;
+
+    @ApiModelProperty("体积(CBM)")
+    @Excel(name = "体积(CBM)")
+    private BigDecimal totalVolume;
+
+    @ApiModelProperty("退保总额（占位字段，后端暂无数据来源，恒为 null）")
+    @Excel(name = "退保总额")
+    private BigDecimal depositRefundAmount;
+}

mhd_wms/src/main/java/com/mhd/wms/domain/outboundRank/service/OutboundRankDomainService.java

@@ -1,8 +1,9 @@
 package com.mhd.wms.domain.outboundRank.service;
 
 import com.mhd.wms.domain.outboundRank.repository.facade.IOutboundRankService;
-import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankPO;
 import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankTotalPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundLineRankPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundMaterialRankPO;
 import com.mhd.wms.domain.outboundRank.repository.todo.OutboundRankDO;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -11,7 +12,7 @@ import org.springframework.stereotype.Service;
 import java.util.List;
 
 /**
- * 出库排名统计（明细）领域服务
+ * 出库排名统计领域服务
  *
  * @author rcx
  * @date 2026-08-31
@@ -24,16 +25,30 @@ public class OutboundRankDomainService {
     private IOutboundRankService outboundRankService;
 
     /**
-     * 出库明细列表
+     * 商品出库排名列表（货品聚合）
      */
-    public List<OutboundDetailRankPO> queryDetailList(OutboundRankDO outboundRankDO) {
-        return outboundRankService.queryDetailList(outboundRankDO);
+    public List<OutboundMaterialRankPO> queryMaterialRankList(OutboundRankDO outboundRankDO) {
+        return outboundRankService.queryMaterialRankList(outboundRankDO);
     }
 
     /**
-     * 出库明细合计（不分页）
+     * 商品出库排名合计（不分页）
      */
-    public OutboundDetailRankTotalPO queryDetailTotal(OutboundRankDO outboundRankDO) {
-        return outboundRankService.queryDetailTotal(outboundRankDO);
+    public OutboundDetailRankTotalPO queryMaterialRankTotal(OutboundRankDO outboundRankDO) {
+        return outboundRankService.queryMaterialRankTotal(outboundRankDO);
+    }
+
+    /**
+     * 线路出库排名列表（线路×货品聚合）
+     */
+    public List<OutboundLineRankPO> queryLineRankList(OutboundRankDO outboundRankDO) {
+        return outboundRankService.queryLineRankList(outboundRankDO);
+    }
+
+    /**
+     * 线路出库排名合计（不分页）
+     */
+    public OutboundDetailRankTotalPO queryLineRankTotal(OutboundRankDO outboundRankDO) {
+        return outboundRankService.queryLineRankTotal(outboundRankDO);
     }
 }

mhd_wms/src/main/java/com/mhd/wms/interfaces/facadeApi/outboundRank/OutboundRankApi.java

@@ -5,8 +5,9 @@ import com.mhd.common.core.constant.HttpStatus;
 import com.mhd.common.core.utils.PageUtils;
 import com.mhd.common.core.utils.poi.ExcelUtil;
 import com.mhd.wms.application.service.outboundRank.OutboundRankApplicationService;
-import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankPO;
 import com.mhd.wms.domain.outboundRank.repository.po.OutboundDetailRankTotalPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundLineRankPO;
+import com.mhd.wms.domain.outboundRank.repository.po.OutboundMaterialRankPO;
 import com.mhd.wms.domain.outboundRank.repository.todo.OutboundRankDO;
 import com.mhd.wms.interfaces.assember.outboundRank.OutboundRankAssembler;
 import com.mhd.wms.interfaces.dto.outboundRank.OutboundRankDTO;
@@ -25,10 +26,13 @@ import java.util.List;
 /**
  * 出库排名统计Api
  *
- * <p>按日期区间筛选出库明细列表（一行 = 仓单×货品，件数/毛重/体积按行汇总，按件数(实际复核出库量)降序，出仓日期/单号次之）。
- * 统计口径：出库单创建时间 + 已出库及之后状态(9,12,13)，明细仅取 level=1 主行。
- * 商品/线路两个 tab 各自独立接口，内部为同一份明细查询：商品接口忽略线路筛选参数，线路接口忽略商品筛选参数。
- * 字段：种类/仓单编号/入库单号/客户编号/收货人/货名/线路/件数/毛重(吨)/体积(CBM)/退保总额(占位null)/出仓日期</p>
+ * <p>按日期区间筛选出库量统计排名，按出库数量(实际复核出库量)降序。
+ * 商品tab：一行 = 一个货品（货号/货名/件数/毛重(吨)/体积(CBM)/退保总额占位），跨出库单汇总，忽略线路筛选参数；
+ * 线路tab：一行 = 线路×货品（线路编码/线路/货号/货名/件数/毛重(吨)/体积(CBM)/退保总额占位），按线路+物料编码合并，
+ * 仅统计带线路的单，商品/线路筛选参数均生效；
+ * 统计口径：出库单创建时间 + 已出库及之后状态(9,12,13)，明细仅取 level=1 主行；
+ * 件数 = SUM(CHECK_QUANTITY) 复核确认的实际出库量（与入库排名的实际上架量对称）；
+ * 退保总额后端暂无对应数据来源，恒为 null</p>
  *
  * @author rcx
  * @date 2026-08-31
@@ -55,25 +59,22 @@ public class OutboundRankApi {
         outboundRankDO.setLineCode(null);
         outboundRankDO.setLineName(null);
         startPage();
-        List<OutboundDetailRankPO> list = outboundRankApplicationService.queryDetailList(outboundRankDO);
-        OutboundDetailRankTotalPO total = outboundRankApplicationService.queryDetailTotal(outboundRankDO);
+        List<OutboundMaterialRankPO> list = outboundRankApplicationService.queryMaterialRankList(outboundRankDO);
+        OutboundDetailRankTotalPO total = outboundRankApplicationService.queryMaterialRankTotal(outboundRankDO);
         return getDataTableWithTotal(list, total);
     }
 
     /**
-     * 分页查询线路出库排名列表（含合计行，线路tab；忽略商品筛选参数）
+     * 分页查询线路出库排名列表（含合计行，线路tab；一行=线路×货品，仅统计带线路的单）
      */
     @ApiOperation("分页查询线路出库排名列表")
     @GetMapping("/queryLineRankList")
     public HashMap<String, Object> queryLineRankList(OutboundRankDTO outboundRankDTO) {
-        //转换实体
+        //转换实体（线路tab：商品/线路筛选参数均生效，按线路+物料编码合并）
         OutboundRankDO outboundRankDO = outboundRankAssembler.toDO(outboundRankDTO);
-        //线路tab：忽略商品筛选参数
-        outboundRankDO.setMaterialCode(null);
-        outboundRankDO.setMaterialName(null);
         startPage();
-        List<OutboundDetailRankPO> list = outboundRankApplicationService.queryDetailList(outboundRankDO);
-        OutboundDetailRankTotalPO total = outboundRankApplicationService.queryDetailTotal(outboundRankDO);
+        List<OutboundLineRankPO> list = outboundRankApplicationService.queryLineRankList(outboundRankDO);
+        OutboundDetailRankTotalPO total = outboundRankApplicationService.queryLineRankTotal(outboundRankDO);
         return getDataTableWithTotal(list, total);
     }
 
@@ -88,41 +89,38 @@ public class OutboundRankApi {
         //商品tab：忽略线路筛选参数
         outboundRankDO.setLineCode(null);
         outboundRankDO.setLineName(null);
-        List<OutboundDetailRankPO> list = outboundRankApplicationService.exportDetailList(outboundRankDO);
+        List<OutboundMaterialRankPO> list = outboundRankApplicationService.exportMaterialRankList(outboundRankDO);
 
         String fileName = URLEncoder.encode("商品出库排名", "UTF-8").replaceAll("\\+", "%20");
         response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
         response.setCharacterEncoding("utf-8");
         response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
 
-        ExcelUtil<OutboundDetailRankPO> util = new ExcelUtil<>(OutboundDetailRankPO.class);
+        ExcelUtil<OutboundMaterialRankPO> util = new ExcelUtil<>(OutboundMaterialRankPO.class);
         util.exportExcel(response, list, "商品出库排名");
     }
 
     /**
-     * 导出线路出库排名Excel（线路tab；忽略商品筛选参数）
+     * 导出线路出库排名Excel（线路tab；一行=线路×货品，仅统计带线路的单）
      */
     @ApiOperation("导出线路出库排名Excel")
     @GetMapping("/exportLineRank")
     public void exportLineRank(HttpServletResponse response, OutboundRankDTO outboundRankDTO) throws Exception {
-        //转换实体（不分页，导出全量）
+        //转换实体（不分页，导出全量；线路tab：商品/线路筛选参数均生效，按线路+物料编码合并）
         OutboundRankDO outboundRankDO = outboundRankAssembler.toDO(outboundRankDTO);
-        //线路tab：忽略商品筛选参数
-        outboundRankDO.setMaterialCode(null);
-        outboundRankDO.setMaterialName(null);
-        List<OutboundDetailRankPO> list = outboundRankApplicationService.exportDetailList(outboundRankDO);
+        List<OutboundLineRankPO> list = outboundRankApplicationService.exportLineRankList(outboundRankDO);
 
         String fileName = URLEncoder.encode("线路出库排名", "UTF-8").replaceAll("\\+", "%20");
         response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
         response.setCharacterEncoding("utf-8");
         response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
 
-        ExcelUtil<OutboundDetailRankPO> util = new ExcelUtil<>(OutboundDetailRankPO.class);
+        ExcelUtil<OutboundLineRankPO> util = new ExcelUtil<>(OutboundLineRankPO.class);
         util.exportExcel(response, list, "线路出库排名");
     }
 
     /**
-     * 分页结果 + 合计行：data/total/code/msg 之外追加 totalPieceCount/totalGrossWeightTon/totalVolume/totalOrderCount
+     * 分页结果 + 合计行：data/total/code/msg 之外追加合计字段（商品tab含 totalOrderCount，线路tab含 totalOrderCount/totalLineCount）
      */
     private HashMap<String, Object> getDataTableWithTotal(List<?> list, OutboundDetailRankTotalPO total) {
         HashMap<String, Object> result = new HashMap<>();
@@ -134,7 +132,12 @@ public class OutboundRankApi {
             result.put("totalPieceCount", total.getTotalPieceCount());
             result.put("totalGrossWeightTon", total.getTotalGrossWeightTon());
             result.put("totalVolume", total.getTotalVolume());
-            result.put("totalOrderCount", total.getTotalOrderCount());
+            if (total.getTotalOrderCount() != null) {
+                result.put("totalOrderCount", total.getTotalOrderCount());
+            }
+            if (total.getTotalLineCount() != null) {
+                result.put("totalLineCount", total.getTotalLineCount());
+            }
         }
         return result;
     }