fix(firstleg): scope loading evidence to cabinet tasks

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

@@ -119,6 +119,57 @@ paths:
       parameters: [{$ref: '#/components/parameters/TaskId'}]
       responses:
         '200': {description: Ordered operation history}
+  /api/platform/v1/first-leg/pda-loading/tasks/{taskId}/evidence:
+    get:
+      summary: 查询当前领取人的柜次装柜证据
+      parameters:
+        - {$ref: '#/components/parameters/TaskId'}
+        - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
+      responses: {'200': {description: 仅platform:firstleg:pda:work且任务必须由当前用户领取}}
+    post:
+      summary: 通过Firstleg代理上传并登记当前柜次装柜证据
+      parameters:
+        - {$ref: '#/components/parameters/TaskId'}
+        - {name: Idempotency-Key, in: header, required: true, schema: {type: string, maxLength: 128}}
+        - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
+        - {name: expectedVersion, in: query, required: true, schema: {type: integer, minimum: 0}}
+        - {name: evidenceType, in: query, required: true, schema: {type: string, enum: [PHOTO_STEP_1, PHOTO_STEP_2, PHOTO_STEP_3, PHOTO_STEP_4, SEAL]}}
+        - {name: sealNo, in: query, required: false, schema: {type: string, maxLength: 64}}
+      requestBody:
+        required: true
+        content:
+          multipart/form-data:
+            schema:
+              type: object
+              required: [file]
+              properties: {file: {type: string, format: binary}}
+      responses: {'200': {description: 柜级证据列表}}
+  /api/platform/v1/first-leg/pda-loading/tasks/{taskId}/evidence/{evidenceId}/content:
+    get:
+      summary: 下载当前柜次有效装柜证据
+      parameters:
+        - {$ref: '#/components/parameters/TaskId'}
+        - {name: evidenceId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
+        - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
+      responses: {'200': {description: 图片字节}}
+  /api/platform/v1/first-leg/pda-loading/tasks/{taskId}/evidence/{evidenceId}/void:
+    post:
+      summary: 作废当前柜次错误证据
+      parameters:
+        - {$ref: '#/components/parameters/TaskId'}
+        - {name: evidenceId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [warehouseId, expectedVersion, reason]
+              properties:
+                warehouseId: {type: integer, format: int64, minimum: 1}
+                expectedVersion: {type: integer, minimum: 0}
+                reason: {type: string, minLength: 1, maxLength: 500}
+      responses: {'200': {description: 作废后柜级证据列表}}
 components:
   parameters:
     TaskId: {name: taskId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}