优化

firstleg/src/main/resources/openapi/phase3-pda-convergence-v1.yaml

@@ -3,6 +3,17 @@ info:
   title: Phase 3 Container PDA Picking API
   version: 1.0.0
 paths:
+  /api/platform/v1/first-leg/pda-loading/warehouses:
+    get:
+      summary: List active domestic warehouses available to the PDA operator
+      responses:
+        '200':
+          description: Warehouse master-data options used to scope PDA pending-task lists
+          content:
+            application/json:
+              schema:
+                type: array
+                items: {$ref: '#/components/schemas/WarehouseOption'}
   /api/platform/v1/first-leg/pda-loading/tasks:
     get:
       summary: Find the active container picking task in one platform warehouse
@@ -18,6 +29,7 @@ paths:
     get:
       summary: List active tasks available to the authenticated PDA operator
       parameters:
+        - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
         - {name: keyword, in: query, required: false, schema: {type: string, maxLength: 64}}
       responses:
         '200':
@@ -175,6 +187,13 @@ 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:
+    WarehouseOption:
+      type: object
+      required: [id, warehouseCode, warehouseName]
+      properties:
+        id: {type: integer, format: int64}
+        warehouseCode: {type: string}
+        warehouseName: {type: string}
     Task:
       type: object
       required: [id, loadingPlanId, containerBookingId, inboundId, inboundVersion, loadingVersion, cabinetNo, sourceType, recordStatus, taskStatus, workflowStatus, version, items]