第三期装柜验收优化修改

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

@@ -82,13 +82,23 @@ paths:
         '200': {description: Completed task, identical replay result, or A0409 when any snapshot changed}
   /api/platform/v1/first-leg/pda-loading/tasks/{taskId}/review:
     post:
-      summary: Review all resolved items, settle partial and skipped quantities, then complete the plan
+      summary: 人工确认装柜完成的兼容入口
       parameters: [{$ref: '#/components/parameters/TaskId'}]
       requestBody:
         required: true
         content: {application/json: {schema: {$ref: '#/components/schemas/ReviewRequest'}}}
       responses:
-        '200': {description: Completed task or A0409 when items or task version changed}
+        '200': {description: 操作员明确确认后完成装柜}
+  /api/platform/v1/first-leg/pda-loading/tasks/{taskId}/complete:
+    post:
+      summary: PDA拣货全部处理后人工确认装柜完成
+      description: PDA拣货只锁定数量和仓储资源，本接口执行结算、释放资源并生成装柜清单。
+      parameters: [{$ref: '#/components/parameters/TaskId'}]
+      requestBody:
+        required: true
+        content: {application/json: {schema: {$ref: '#/components/schemas/CompleteLoadingRequest'}}}
+      responses:
+        '200': {description: 完成任务；存在未处理明细或版本冲突时返回A0409}
   /api/platform/v1/first-leg/pda-loading/tasks/{taskId}/operations:
     get:
       summary: Read immutable task-level claim, assignment and review audit records
@@ -198,6 +208,13 @@ components:
         expectedTaskVersion: {type: integer, minimum: 0}
         operationId: {type: string, maxLength: 128}
         remark: {type: string, maxLength: 500}
+    CompleteLoadingRequest:
+      type: object
+      required: [expectedTaskVersion, operationId]
+      properties:
+        expectedTaskVersion: {type: integer, minimum: 0}
+        operationId: {type: string, maxLength: 128}
+        remark: {type: string, maxLength: 500}
     InventorySnapshot:
       type: object
       required: [taskId, taskVersion, containerNo, warehouseId, capturedAt, snapshotToken, inbounds]