fix(self-operated): rank hot SKUs for selected dates

lastleg-service/src/main/resources/openapi/self-operated-analytics-v1.yaml

@@ -13,7 +13,7 @@ info:
     默认maxQueryDays366，粒度DAY。正式outboundQuantity与observedQuantity独立，全部未知仍为空。
     每日COMPLETE仅证明全天覆盖及有效日行或可靠SKU存在；今日/部分日正式量空，观察量可用，未知日期保持空。
     SKU区间正式量仅全部日完整才输出；observedQuantity为可靠点合计，完整/部分/未知日数独立。
-    切换图表不改变完整7/30日榜单及30日日均分母；不触发领星请求。
+    热销榜跟随图表所选日期，以已采集有效出库量排序；覆盖不足标记PARTIAL，不改变30日日均分母；不触发领星请求。
     运行接口不受经营context限制。动态库存时效、重建和修订待核对独立返回。
     阶段进度区分ACCOUNT_SHARED/WAREHOUSE及TASK_CUMULATIVE/ATTEMPT_ONLY，不伪造总百分比。
     total未知为空、计数不能跨PAGE/ORDER/INVENTORY_ROW/BUSINESS_KEY/SKU/BATCH单位求和，NONE为非计数阶段且completed/total为空、totalKnown=false；阶段检查点与心跳分开。
@@ -26,7 +26,7 @@ paths:
       summary: 单仓固定版本经营总览
       description: >-
         平台独立只读权限platform:self-operated-analytics:list。一次一致快照固定销量和库存版本。
-        默认LAST_15_DAYS仅改变趋势及区间出库，日均、互斥分桶和三个Top10固定至昨日30完整日。
+        默认LAST_15_DAYS同时用于趋势、区间出库和热销Top10；热销按已采集有效量排序并标记覆盖状态。日均、互斥分桶及两个库存Top10固定至昨日30完整日。
         不接受货主、SKU、分页、windowDays、topN或其他额外筛选。仓级趋势不套单SKU观察期。
         库存严格下钻须携带原版本和drilldownFrom=DASHBOARD；截止时间由服务端根据库存真实观测重算。
       parameters:
@@ -120,8 +120,8 @@ paths:
         '403': {description: 非平台身份或缺少独立只读权限}
   /api/platform/v1/last-leg/self-operated-analytics/hot-skus:
     get:
-      summary: 完整7/30日热销Top100
-      description: '独立截至queryAsOf昨日的完整窗口，数量大于零，数量降序、SKU单数降序、SKU及货主升序，先Top100再分页；当前缺货仍可入榜。 权限platform:self-operated-analytics:list。'
+      summary: 所选时段已采集热销Top100
+      description: '支持CUSTOM起止日期（含截止日），与总览所选时段一致；未传日期时仍使用windowDays的7/30日窗口。按已采集有效数量排序，覆盖不足由context及coverageStatus提示，不把未知当零。数量大于零，数量降序、SKU单数降序、SKU及货主升序，先Top100再分页；当前缺货仍可入榜。 权限platform:self-operated-analytics:list。'
       parameters:
         - {$ref: '#/components/parameters/sourceAccount'}
         - {$ref: '#/components/parameters/warehouseCode'}
@@ -133,6 +133,9 @@ paths:
         - {$ref: '#/components/parameters/inventoryScopeHash'}
         - {$ref: '#/components/parameters/queryAsOf'}
         - {$ref: '#/components/parameters/windowDays'}
+        - {$ref: '#/components/parameters/rangePreset'}
+        - {$ref: '#/components/parameters/startDate'}
+        - {$ref: '#/components/parameters/endDate'}
         - {$ref: '#/components/parameters/current'}
         - {$ref: '#/components/parameters/size'}
       responses:
@@ -476,7 +479,7 @@ components:
         productName: {type: string, nullable: true}
         value: {type: number}
         unit: {type: string, enum: [PCS, DAY]}
-        outboundQuantity30d: {type: number, nullable: true}
+        windowOutboundQuantity: {type: number, nullable: true, description: 榜单实际窗口出库量；热销在部分覆盖时为已采集量}
         skuOutboundOrderCount: {type: string, nullable: true}
         physicalQuantity: {type: number, nullable: true}
         availableQuantity: {type: number, nullable: true}
@@ -490,7 +493,7 @@ components:
       properties:
         windowStartDate: {type: string, format: date}
         windowEndDateExclusive: {type: string, format: date}
-        calculationWindowDays: {type: integer, enum: [30]}
+        calculationWindowDays: {type: integer, minimum: 1, description: 热销为所选日期天数；库存榜固定30}
         eligibleCount: {type: string, nullable: true}
         unassessableCount: {type: string, nullable: true}
         items: {type: array, maxItems: 10, items: {$ref: '#/components/schemas/DashboardRankingItem'}}