优化

firstleg/src/main/resources/openapi/firstleg-v1.yaml

@@ -1034,7 +1034,7 @@ components:
         currentHoldReason: {type: string, nullable: true}
         totalPackageCount: {type: integer, nullable: true}
         locationCodes: {type: string, nullable: true}
-        actualGrossWeightKg: {type: number, nullable: true}
+        actualGrossWeightKg: {type: number, nullable: true, multipleOf: 0.001, description: 服务端权威货物总重量 KG；存在已确认称重图片时为全部 CONFIRMED netWeightKg 之和，消费者不得从图片重算}
         actualNetWeightKg: {type: number, nullable: true}
         actualVolumeCbm: {type: number, nullable: true}
         volumeWeightKg: {type: number, nullable: true}

firstleg/src/test/java/com/baiyue/firstleg/controller/InboundMeasurementEvidenceOpenApiContractTest.java

@@ -35,6 +35,9 @@ class InboundMeasurementEvidenceOpenApiContractTest {
         Map<String, Object> weightProperties = properties(schemas, "InboundWeightResult");
         assertThat(weightProperties).containsKeys(
             "id", "fileId", "recognitionStatus", "grossWeightKg", "netWeightKg", "confirmedAt");
+        assertThat(stringMap(properties(schemas, "UnifiedInboundOrderSummary")
+            .get("actualGrossWeightKg")).get("description").toString())
+            .contains("服务端权威货物总重量", "CONFIRMED netWeightKg", "不得从图片重算");
     }
 
     private static Map<String, Object> properties(Map<String, Object> schemas, String schemaName) {