feat(selfop): hide known zero inventory before turnover pagination

2026-10-15 10:29:42 +08:00
parent b7fb3a5054
commit 72d7ed6962
7 changed files with 52 additions and 24 deletions
@@ -19,7 +19,7 @@ paths:
      operationId: inventoryTurnover
      summary: 单仓SKU或货主三窗口库存周转
      description: >-
-        精确customerCode限定列表与概览；sku、focus及turnoverStatus只筛列表。
+        精确customerCode限定列表与概览；sku、focus、turnoverStatus及hideZeroInventory只筛列表。
        按完整候选计算依赖后排序分页，未知末尾，同值按SKU及货主或货主编码稳定排序。
        OWNER不计算整体可售天数；销售事实完整即可展示货主实际出库，不受单SKU观察期影响。
        SKU出库及无出库判断同样不受首次观察时间限制：可信完整覆盖的缺销量行可计零；实际异常单位或未覆盖日期保持未知。
@@ -34,6 +34,7 @@ paths:
        - {name: groupBy, in: query, schema: {type: string, enum: [SKU, OWNER], default: SKU}}
        - {name: customerCode, in: query, schema: {type: string, minLength: 1, maxLength: 64}}
        - {name: sku, in: query, description: SKU分组的精确查询，OWNER禁止传入, schema: {type: string, minLength: 1, maxLength: 128}}
+        - {name: hideZeroInventory, in: query, description: 默认隐藏当前全品质实物件数明确为0的SKU或货主汇总行，保留未知；全量筛选后分页，不改变概览及图表, schema: {type: boolean, default: true}}
        - name: focus
          in: query
          schema: {type: string, enum: [ALL, NO_OUTBOUND_IN_WINDOW, COVERAGE_GT, COVERAGE_LE, FROZEN, DEFECTIVE, UNASSESSABLE], default: ALL}