优化

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

@@ -6,11 +6,13 @@ paths:
   /api/platform/v1/inbounds/{inboundId}/loading/evidence/pda:
     get:
       summary: List loading evidence for the active PDA worker
+      description: Requires the associated inbound to have entered the loading stage. PDA workflowStatus AWAITING_REVIEW does not bypass this gate; canonical claim or picking advances WAIT_SPLIT to LOADING.
       parameters: [{$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/TenantId'}]
       responses:
         '200': {description: Business envelope; requires platform:firstleg:pda:work}
     post:
       summary: Append one PDA-captured loading evidence photo
+      description: Requires the associated inbound process status to be LOADING. PDA workflowStatus AWAITING_REVIEW is a review projection and does not replace the inbound loading-stage gate.
       parameters: [{$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/TenantId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody:
         required: true