feat(wms,oms)：入库排名统计改为按物料编码合并(一行=一个物料在区间内全部已入库仓单的合计)：返回列裁剪为物料编码/货名/规格型号/单位/件数(实际上架量)/毛重(吨)/投保总额(货品档案保额取MAX不跨仓单累加)/体积；仓单编号/客户编号/存货人/入仓日期为单据级字段单值失真，移出返回列仅保留为查询条件；HAVING过滤0件行；合计行投保总额=各物料保额之和(每物料计一次)，totalOrderCount=涉及仓单数；OMS/WMS两端口径数字一致；查询参数与返回结构外层不变

2026-09-03 15:57:44 +08:00
parent 4ad31a870a
commit c9c3062789
11 changed files with 65 additions and 97 deletions
@@ -9,7 +9,8 @@ import java.io.Serializable;
 * 入库排名统计入参DTO
 *
 * <p>按入仓日期区间筛选商品入库量统计排名，统计口径：入仓日期 + 仅已入库状态(5) + 明细仅取 level=1 主行；
- * 一行 = 某仓单内某货品的合计，按件数降序排名</p>
+ * 一行 = 一个物料的合计（按物料编码合并），按件数降序排名；
+ * 仓单编号/客户编号/存货人/入仓日期为单据级字段仅作查询条件，返回列不含这些字段</p>
 *
 * @author rcx
 * @date 2026-08-31
@@ -26,8 +26,10 @@ import java.util.List;
 * 入库排名统计Api
 *
 * <p>按入仓日期区间筛选商品入库量统计排名。统计口径：入仓日期(为空的历史单按建档时间兜底) + 仅已入库状态(5)，
- * 明细仅取 level=1 主行；一行 = 某仓单内某货品的合计，按件数(实际上架量 SHELVES_QUANTITY)降序排名。
- * 字段：入仓日期/仓单编号/客户编号/存货人/货名/件数/毛重(吨)/投保总额/体积(CBM)。
+ * 明细仅取 level=1 主行；一行 = 一个物料的合计（按物料编码合并区间内全部已入库仓单），
+ * 按件数(实际上架量 SHELVES_QUANTITY)降序排名，件数为0的物料不返回。
+ * 返回字段：物料编码/货名/规格型号/单位/件数/毛重(吨)/投保总额/体积(CBM)；
+ * 仓单编号/客户编号/存货人/入仓日期为单据级字段仅作查询条件，不返回。
 * 与出库排名(/outboundRankApi)配对，前端用 tab 页区分</p>
 *
 * @author rcx