优化

2026-10-09 17:36:24 +08:00
parent 74bf0e73c5
commit 261cdc87cb
27 changed files with 636 additions and 45 deletions
@@ -0,0 +1,54 @@
+openapi: 3.0.3
+info:
+  title: 客户来源头程订单尾程进度内部查询
+  version: 1.0.0
+paths:
+  /internal/lastleg/v1/customer-order-progress:
+    post:
+      summary: Order按认证客户读取排车和实际派送进度
+      description: >-
+        只读内部接口，无公网路由。customerId由Order认证上下文提供，所有业务表在Lastleg自身Schema内按客户读取。
+        正式排车单PENDING_DEPARTURE/PICKING/READY_TO_DEPART按计划或库存来源计算，预排草稿和取消单不计入。
+        派送必须已实际DEPARTED、出库OUTBOUNDED且对应目的地派送单仍WAIT_DELIVERY/DELIVERING。
+        混托使用所有库存及不可变拣货来源，不使用代表orderId；数量覆盖不完整或异常时标记partial，不签发派送完成事实。
+      security: [{internalServiceToken: []}]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [customerId]
+              properties:
+                customerId: {type: integer, format: int64, minimum: 1}
+      responses:
+        '200':
+          description: ApiResponse，只有code为200表示成功；progress为空表示客户当前无有效排车或派送
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  data:
+                    type: object
+                    required: [progress]
+                    properties:
+                      progress:
+                        type: array
+                        items:
+                          type: object
+                          required: [orderId, stage, partial]
+                          properties:
+                            orderId: {type: string, pattern: '^[1-9][0-9]*$'}
+                            stage: {type: string, enum: [scheduled, delivering]}
+                            partial: {type: boolean}
+        '400': {description: 客户参数无效}
+        '401': {description: 内部服务令牌缺失或无效}
+        '503': {description: 内部令牌未配置}
+components:
+  securitySchemes:
+    internalServiceToken:
+      type: apiKey
+      in: header
+      name: X-Internal-Service-Token