feat(selfop): add bounded inventory flow diagnostic through account egress

2026-10-15 11:37:49 +08:00
parent e19d303a76
commit d81d9cbda4
16 changed files with 365 additions and 5 deletions
@@ -21,6 +21,34 @@ info:
    重试沿既有POST sync-tasks，action=RETRY/requestKey/warehouseCode/taskNo/reason，使用独立sync权限并最终复核资格。
 security: [{bearerAuth: []}]
 paths:
+  /api/platform/v1/last-leg/self-operated-analytics/inventory-flow-probe:
+    post:
+      summary: TEST单SKU库存流水有界诊断
+      description: >-
+        仅TEST、BUSINESS、执行开启及配置仓库；PLATFORM、tenantId=0、非代登录、独立platform:self-operated-analytics:sync权限。
+        每个requestKey最多一次供应商请求、第一页最多1000条、时间范围最多31天且不得未来。
+        复用现有账号lease/fence、1200ms间隔、permit和消费记录。占用时拒绝，由操作者另行发起，不自动重试。
+        同键成功重放读取保存结果；同键异参拒绝；失败或结果未知不得重发。任务类型INVENTORY_FLOW_PROBE，成功SAMPLE_DONE，失败DEAD。
+        complete仅证明本次分页记录已全部返回，不证明历史流水无缺失或库存可还原。只保存诊断结果，不发布销量、库存或日样本。
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [requestKey, warehouseCode, customerCode, sku, startTime, endTime]
+              properties:
+                requestKey: {type: string, minLength: 1, maxLength: 80}
+                warehouseCode: {type: string, minLength: 1, maxLength: 64}
+                customerCode: {type: string, minLength: 1, maxLength: 64}
+                sku: {type: string, minLength: 1, maxLength: 128}
+                startTime: {type: string, description: 北京时间本地日期时间}
+                endTime: {type: string, description: 北京时间本地日期时间}
+      responses:
+        '200':
+          description: ApiResponse；成功data包含taskNo、complete与page（records、total、current、size、pages、observedAt、egress）。流水字段定义见Integration库存流水合同。业务失败保留错误码，不返回伪成功。
+        '403':
+          description: 非平台或缺少采集权限
  /api/platform/v1/last-leg/self-operated-analytics/owner-directory:
    get:
      summary: 完整资料批次中的客户名称与编码