优化

lastleg-service/src/main/resources/openapi/fleet-owned-business-v1.yaml

@@ -2,7 +2,7 @@ openapi: "3.0.3"
 info:
   title: "原排车自有车辆运营视图"
   version: "1.0.0"
-  description: "装车完成时冻结车辆OWNED/DISPATCHED；所有主单事实来自原dispatch。新增数据仅附加运营记录、命令、历史及归属证据。油耗L/100km手工登记，金额CNY/USD不默认、不换汇；零与未登记不同。"
+  description: "装车完成时冻结车辆OWNED/DISPATCHED；所有主单事实来自原dispatch。新增数据仅附加运营记录、命令、历史及归属证据。油耗L/100km手工登记，金额CNY/USD不默认、不换汇；零与未登记不同。响应遵循NON_NULL：可空属性可省略，省略与null均表示空值，0仍是明确登记值；请求必填项仍以required及DTO校验为准。"
 security:
   -
     bearerAuth: []
@@ -237,15 +237,6 @@ paths:
                       -
                         "$ref": "#/components/schemas/Photo"
                     nullable: true
-      parameters:
-        -
-          name: "idempotencyKey"
-          in: "query"
-          required: true
-          schema:
-            type: "string"
-            minLength: 8
-            maxLength: 128
       requestBody:
         required: true
         content:
@@ -254,7 +245,13 @@ paths:
               type: "object"
               required:
                 - "file"
+                - "idempotencyKey"
               properties:
+                idempotencyKey:
+                  type: "string"
+                  minLength: 8
+                  maxLength: 128
+                  description: "原上传请求键，以multipart表单字段提交，绑定使用独立请求键。"
                 file:
                   type: "string"
                   format: "binary"
@@ -432,7 +429,6 @@ components:
       x-java-record: "OwnedBusinessModels.Arrival"
       required:
         - "destinationKey"
-        - "actualArrivedAt"
       properties:
         destinationKey:
           type: "string"
@@ -446,9 +442,6 @@ components:
       type: "object"
       x-java-record: "OwnedBusinessModels.Operations"
       required:
-        - "money"
-        - "actualDistanceMiles"
-        - "fuelConsumptionLitresPer100Km"
         - "arrivals"
       properties:
         money:
@@ -512,7 +505,6 @@ components:
       x-java-record: "OwnedBusinessModels.Gate"
       required:
         - "allowed"
-        - "blockReason"
       properties:
         allowed:
           type: "boolean"
@@ -563,9 +555,6 @@ components:
     Driver:
       type: "object"
       x-java-record: "OwnedBusinessModels.Driver"
-      required:
-        - "name"
-        - "phone"
       properties:
         name:
           type: "string"
@@ -578,8 +567,6 @@ components:
       x-java-record: "OwnedBusinessModels.Appointment"
       required:
         - "appointmentNo"
-        - "confirmationNo"
-        - "scheduledAt"
         - "allocatedPackages"
       properties:
         appointmentNo:
@@ -599,11 +586,7 @@ components:
       x-java-record: "OwnedBusinessModels.Destination"
       required:
         - "destinationKey"
-        - "warehouseCode"
-        - "warehouseName"
-        - "address"
         - "appointments"
-        - "actualArrivedAt"
       properties:
         destinationKey:
           type: "string"
@@ -635,7 +618,6 @@ components:
         - "contentType"
         - "sizeBytes"
         - "uploadedAt"
-        - "savedAt"
       properties:
         slot:
           "$ref": "#/components/schemas/PhotoSlot"
@@ -684,15 +666,11 @@ components:
         - "stage"
         - "plannedDepartureAt"
         - "loadingCompletedAt"
-        - "departedAt"
-        - "deliveryCompletedAt"
         - "origin"
         - "vehicle"
         - "driver"
         - "destinations"
-        - "actualPalletCount"
         - "operations"
-        - "unitPrice"
         - "recordVersion"
         - "dispatchRecordVersion"
         - "photoSummary"
@@ -804,9 +782,6 @@ components:
       required:
         - "sourceKey"
         - "customerId"
-        - "customerName"
-        - "orderNo"
-        - "inboundCode"
         - "palletNo"
         - "destinationKey"
         - "packages"
@@ -856,13 +831,8 @@ components:
       x-java-record: "OwnedBusinessModels.History"
       required:
         - "eventSource"
-        - "recordVersion"
-        - "dispatchRecordVersion"
         - "action"
-        - "operatorName"
         - "occurredAt"
-        - "reason"
-        - "operations"
         - "photos"
       properties:
         eventSource:
@@ -925,15 +895,13 @@ components:
     Command:
       type: "object"
       x-java-record: "OwnedBusinessModels.Command"
+      description: "SAVE_OPERATIONS/BIND_PHOTO成功时recordVersion和result必须有值；UPLOAD_PHOTO成功时result必须含fileId，recordVersion可空。仅可空的未确定或拒绝结果字段允许省略，不放宽成功回执的关联要求。"
       required:
         - "dispatchNo"
         - "action"
         - "idempotencyKey"
         - "state"
-        - "recordVersion"
         - "replayed"
-        - "result"
-        - "errorCode"
         - "retryAllowed"
       properties:
         dispatchNo: