feat(selfop): reconstruct historical inventory and publish qualified turnover

integration-service/src/main/resources/openapi/lingxing-wms-v1.yaml

@@ -51,6 +51,34 @@ x-lastleg-egress-coordination:
 security:
   - InternalServiceToken: []
 paths:
+  /internal/integrations/lingxing/wms/inventory-flow-page/query:
+    post:
+      summary: One frozen warehouse inventory-flow page
+      description: >-
+        Shared INVENTORY_FLOW permit, one upstream request, no automatic retry. Fixed warehouse and
+        inclusive Beijing start/end bounds at most one day, current>=1, size 1..1000, sorted by createTime asc.
+        Customer/SKU filters are absent. Lastleg validates persisted task/page binding, page counts,
+        duplicate IDs and ordering before admitting coverage. Only quantity/identity whitelist fields return.
+        Empty first-page current=1,size=10,total=0,pages=0,records=[] is normalized to the requested size.
+      parameters:
+        - {$ref: '#/components/parameters/LingxingEgressContext'}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: false
+              required: [warehouseCode, startTime, endTime, current, size]
+              properties:
+                warehouseCode: {type: string, minLength: 1, maxLength: 64}
+                startTime: {type: string, format: date-time, description: Beijing local datetime without offset}
+                endTime: {type: string, format: date-time, description: Inclusive bound, at most one day after start}
+                current: {type: integer, minimum: 1}
+                size: {type: integer, minimum: 1, maximum: 1000}
+      responses:
+        '200':
+          description: Envelope of QueryPage with current/size/total/pages/records and source pagination evidence, or sanitized ProviderFailure. Rows retain string id, customerCode, whCode, productSku, cellNo, innerBatchNo, billNo, sourceNo, billType, productQuality, numeric bookQty/closeQty and string bookChangQty/createTime.
   /internal/integrations/lingxing/wms/inventory-flow/query:
     post:
       summary: One SKU inventory-flow diagnostic page
@@ -59,6 +87,9 @@ paths:
         at most 31 days, current=1 and size=1000 fixed. No automatic next page or retry. Source quality and signed
         quantities are preserved, not translated to inventory-snapshot quality. Source 11008 only rejects this optional
         operation; authentication, rate-limit and uncertain-result account protection remain effective.
+        Source movement IDs must be strings. An empty first response with current=1, size=10, total=0,
+        pages=0 and records=[] is normalized to requested size=1000 while retaining sourceSize=10.
+        Other pagination mismatches remain errors.
       parameters:
         - {$ref: '#/components/parameters/LingxingEgressContext'}
       requestBody:
@@ -76,7 +107,7 @@ paths:
                 endTime: {type: string, format: date-time, description: Beijing local datetime without offset}
       responses:
         '200':
-          description: Standard envelope with QueryPage or sanitized ProviderFailure. Flow rows retain id as string, customerCode, whCode, productSku, cellNo, innerBatchNo, billNo, billType, productQuality, numeric bookQty/closeQty, string bookChangQty/createTime. Unknown source fields remain null; no calculated inventory is published.
+          description: Standard envelope with QueryPage or sanitized ProviderFailure. Flow rows retain id as string, customerCode, whCode, productSku, cellNo, innerBatchNo, billNo, sourceNo, billType, productQuality, numeric bookQty/closeQty, string bookChangQty/createTime. Unknown source fields remain null; no calculated inventory is published.
   /internal/integrations/lingxing/wms/customers/query:
     post:
       summary: Query one page of customers using the existing account egress permit