优化

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

@@ -35,6 +35,13 @@ paths:
           application/json: {schema: {$ref: '#/components/schemas/UpsertEvidenceRequest'}}
       responses:
         '200': {description: Business envelope; ownership, type and version failures use business error codes}
+  /api/platform/v1/inbounds/{inboundId}/loading/evidence/{evidenceId}/content/pda:
+    get:
+      summary: Download one loading evidence photo for the active PDA worker
+      description: Uses the existing platform:firstleg:pda:work authority and validates customer, inbound and evidence ownership before proxying File service content.
+      parameters: [{$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/EvidenceId'}, {$ref: '#/components/parameters/TenantId'}]
+      responses:
+        '200': {description: Authenticated image bytes}
   /api/platform/v1/inbounds/{inboundId}/loading/evidence/{evidenceId}/void/pda:
     post:
       summary: Void an incorrect PDA loading evidence photo
@@ -102,6 +109,19 @@ components:
     EvidenceId: {name: evidenceId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
     IdempotencyKey: {name: Idempotency-Key, in: header, required: true, schema: {type: string, maxLength: 128}}
   schemas:
+    EvidenceResponse:
+      type: object
+      required: [id, inboundId, tenantId, evidenceType, fileId, previewUrl, version, status]
+      properties:
+        id: {type: integer, format: int64}
+        inboundId: {type: integer, format: int64}
+        tenantId: {type: integer, format: int64}
+        evidenceType: {type: string, enum: [PHOTO_STEP_1, PHOTO_STEP_2, PHOTO_STEP_3, PHOTO_STEP_4, SEAL]}
+        fileId: {type: integer, format: int64}
+        fileName: {type: string}
+        previewUrl: {type: string, description: Authenticated PDA image-content path; request with the current bearer token}
+        version: {type: integer}
+        status: {type: string}
     UpsertEvidenceRequest:
       type: object
       required: [expectedVersion, evidenceType, fileId]