优化

2026-08-12 09:25:53 +08:00
parent b2af5739c8
commit 1cb4fba276
29 changed files with 1311 additions and 109 deletions
@@ -10,7 +10,9 @@ paths:
        - {name: containerNo, in: query, required: true, schema: {type: string}}
        - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
      responses:
-        '200': {description: Task with assignment, review and item-level versions}
+        '200':
+          description: Task with assignment, review, stable carton codes and item-level versions
+          content: {application/json: {schema: {$ref: '#/components/schemas/Task'}}}
  /api/platform/v1/first-leg/pda-loading/tasks/pending:
    get:
      summary: List active tasks available to the authenticated PDA operator
@@ -98,6 +100,41 @@ components:
    TaskId: {name: taskId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
    ItemId: {name: itemId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
  schemas:
+    Task:
+      type: object
+      required: [id, loadingPlanId, containerNo, taskStatus, workflowStatus, version, items]
+      properties:
+        id: {type: integer, format: int64}
+        loadingPlanId: {type: integer, format: int64}
+        containerNo: {type: string}
+        taskStatus: {type: string, enum: [LOADING, COMPLETED]}
+        workflowStatus: {type: string, enum: [UNASSIGNED, IN_PROGRESS, AWAITING_REVIEW, COMPLETED]}
+        version: {type: integer, minimum: 0}
+        assignment: {type: object, nullable: true}
+        review: {type: object, nullable: true}
+        items:
+          type: array
+          items: {$ref: '#/components/schemas/PickItem'}
+    PickItem:
+      type: object
+      required: [id, loadingPlanItemId, tenantId, inboundId, inboundDetailId, boxCodes, plannedPackageCount, pickedPackageCount, itemStatus, version]
+      properties:
+        id: {type: integer, format: int64}
+        loadingPlanItemId: {type: integer, format: int64}
+        tenantId: {type: integer, format: int64, description: Hidden isolation key for subsequent PDA evidence calls}
+        inboundId: {type: integer, format: int64}
+        inboundDetailId: {type: integer, format: int64}
+        orderNo: {type: string, nullable: true}
+        inboundCode: {type: string, nullable: true}
+        cargoName: {type: string, nullable: true}
+        boxCodes:
+          type: array
+          description: Stable carton label codes; one successful scan represents one carton
+          items: {type: string}
+        plannedPackageCount: {type: integer, minimum: 1}
+        pickedPackageCount: {type: integer, minimum: 0}
+        itemStatus: {type: string, enum: [PENDING, PICKING, PICKED, PARTIAL, SKIPPED]}
+        version: {type: integer, minimum: 0}
    PendingTask:
      type: object
      required: [taskId, loadingPlanId, containerNo, warehouseId, taskStatus, workflowStatus, version, assignmentVersion, itemCount, pendingItemCount]