fix: block dropship work until pallets are ready

2026-09-11 13:54:06 +08:00
parent 137f8173ab
commit 3b97eedc3d
6 changed files with 49 additions and 10 deletions
@@ -91,6 +91,22 @@ components:
    TaskId: {name: taskId, in: path, required: true, schema: {type: integer, format: int64}}
    WarehouseId: {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64}}
  schemas:
+    Task:
+      type: object
+      description: 一件代发清点组托任务；palletSetupReady=false 时禁止领取、解析箱码和提交清点。
+      required: [taskId, totalCartons, countedCartons, boundCartons, unboundCartons, expectedPalletCount, generatedPalletCount, palletSetupReady, taskStatus, pallets]
+      properties:
+        taskId: {type: integer, format: int64}
+        totalCartons: {type: integer, minimum: 1}
+        countedCartons: {type: integer, minimum: 0}
+        boundCartons: {type: integer, minimum: 0}
+        unboundCartons: {type: integer, minimum: 0}
+        expectedPalletCount: {type: integer, minimum: 1}
+        generatedPalletCount: {type: integer, minimum: 0}
+        palletSetupReady: {type: boolean}
+        palletSetupMessage: {type: string, nullable: true}
+        taskStatus: {type: string, enum: [PENDING, CLAIMED, COMPLETED]}
+        pallets: {type: array, items: {$ref: '#/components/schemas/Pallet'}}
    Carton:
      type: object
      properties: