feat(firstleg): converge phase3 loading models and pda

firstleg/src/main/resources/openapi/phase3-loading-delivery-v1.yaml

@@ -20,7 +20,9 @@ paths:
         '200': {description: Business envelope; ownership, type and version failures use business error codes}
   /api/platform/v1/inbounds/{inboundId}/loading/picking/start:
     post:
-      summary: Start the inbound-level PDA picking review task
+      summary: Refresh the compatibility projection from canonical container PDA tasks
+      deprecated: true
+      description: expectedCount and pickedCount must exactly match the server-derived container-task aggregate.
       parameters: [{$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/TenantId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody:
         required: true
@@ -30,7 +32,9 @@ paths:
         '200': {description: Business envelope containing IN_PROGRESS task}
   /api/platform/v1/inbounds/{inboundId}/loading/picking/complete:
     post:
-      summary: Complete a started PDA picking task when planned and picked counts match
+      summary: Mark the compatibility projection complete after all container PDA tasks are reviewed
+      deprecated: true
+      description: This endpoint cannot complete canonical picking; counts must match the server aggregate and every related container task must already be completed.
       parameters: [{$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/TenantId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody:
         required: true