优化

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

@@ -0,0 +1,48 @@
+package com.baiyue.firstleg.controller;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.core.io.ClassPathResource;
+import org.yaml.snakeyaml.Yaml;
+
+import java.nio.charset.StandardCharsets;
+import java.util.Map;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class InboundMeasurementEvidenceOpenApiContractTest {
+
+    @Test
+    void measurementDetailSeparatesDimensionAndWeightEvidenceByStableRecord() throws Exception {
+        String source = new ClassPathResource("openapi/firstleg-v1.yaml")
+            .getContentAsString(StandardCharsets.UTF_8);
+        Map<String, Object> document = stringMap(new Yaml().load(source));
+        Map<String, Object> paths = stringMap(document.get("paths"));
+        Map<String, Object> detailPath = stringMap(paths.get(
+            "/api/platform/v1/first-leg/inbounds/{inboundId}/measurement"));
+        assertThat(detailPath).containsKey("get");
+
+        Map<String, Object> schemas = stringMap(stringMap(document.get("components")).get("schemas"));
+        Map<String, Object> detailProperties = properties(schemas, "InboundMeasurementDetail");
+        assertThat(detailProperties).containsKeys("actualGrossWeightKg", "items", "weightResults");
+        assertThat(stringMap(detailProperties.get("items")))
+            .containsEntry("description", "DIMENSION 尺寸测量明细及其图片证据");
+        assertThat(stringMap(detailProperties.get("weightResults")))
+            .containsEntry("description", "WEIGHT 称重结果及其图片、确认状态和服务端重量事实");
+        assertThat(detailProperties).doesNotContainKey("images");
+
+        Map<String, Object> itemProperties = properties(schemas, "InboundMeasurementItem");
+        assertThat(itemProperties).containsKeys("id", "intelligentImageFileId");
+        Map<String, Object> weightProperties = properties(schemas, "InboundWeightResult");
+        assertThat(weightProperties).containsKeys(
+            "id", "fileId", "recognitionStatus", "grossWeightKg", "netWeightKg", "confirmedAt");
+    }
+
+    private static Map<String, Object> properties(Map<String, Object> schemas, String schemaName) {
+        return stringMap(stringMap(schemas.get(schemaName)).get("properties"));
+    }
+
+    @SuppressWarnings("unchecked")
+    private static Map<String, Object> stringMap(Object value) {
+        return (Map<String, Object>) value;
+    }
+}

firstleg/src/test/java/com/baiyue/firstleg/service/InboundMeasurementServiceTest.java

@@ -26,6 +26,7 @@ import org.springframework.test.context.junit.jupiter.SpringJUnitConfig;
 import org.springframework.test.context.TestPropertySource;
 
 import java.math.BigDecimal;
+import java.time.LocalDateTime;
 import java.util.List;
 
 import static org.assertj.core.api.Assertions.assertThat;
@@ -136,6 +137,45 @@ class InboundMeasurementServiceTest {
         verify(repository, never()).updateInbound(any());
     }
 
+    @Test
+    void detailKeepsDimensionAndWeightEvidenceOnTheirStableBusinessRecords() {
+        InboundOrderEntity inbound = inbound("MEASURE_PENDING");
+        inbound.setActualGrossWeightKg(new BigDecimal("11.500"));
+        InboundMeasurementEntity measurement = new InboundMeasurementEntity();
+        measurement.setId(30L);
+        measurement.setVersion(4);
+        InboundMeasurementItemEntity item = new InboundMeasurementItemEntity();
+        item.setId(40L);
+        item.setTenantId(1L);
+        item.setMeasurementId(30L);
+        item.setSourceImageFileId(140L);
+        InboundWeightResultEntity weight = weight(50L, "30.000", "KG", "CONFIRMED", 2);
+        weight.setGrossWeightKg(new BigDecimal("30.000"));
+        weight.setPalletTareWeightKg(new BigDecimal("18.500"));
+        weight.setNetWeightKg(new BigDecimal("11.500"));
+        weight.setConfirmedAt(LocalDateTime.of(2026, 8, 17, 10, 30));
+        when(repository.findInbound(1L, 10L)).thenReturn(inbound);
+        when(repository.findLatestMeasurement(1L, 10L)).thenReturn(measurement);
+        when(repository.listItems(1L, 30L)).thenReturn(List.of(item));
+        when(repository.listWeights(1L, 10L)).thenReturn(List.of(weight));
+
+        InboundMeasurementResponses.Detail result = service.detail(1L, 10L);
+
+        assertThat(result.actualGrossWeightKg()).isEqualByComparingTo("11.500");
+        assertThat(result.items()).singleElement().satisfies(dimension -> {
+            assertThat(dimension.id()).isEqualTo(40L);
+            assertThat(dimension.intelligentImageFileId()).isEqualTo(140L);
+        });
+        assertThat(result.weightResults()).singleElement().satisfies(confirmedWeight -> {
+            assertThat(confirmedWeight.id()).isEqualTo(50L);
+            assertThat(confirmedWeight.fileId()).isEqualTo(150L);
+            assertThat(confirmedWeight.recognitionStatus()).isEqualTo("CONFIRMED");
+            assertThat(confirmedWeight.grossWeightKg()).isEqualByComparingTo("30.000");
+            assertThat(confirmedWeight.netWeightKg()).isEqualByComparingTo("11.500");
+            assertThat(confirmedWeight.confirmedAt()).isNotNull();
+        });
+    }
+
     @Test
     void creatingWeightResultNormalizesProviderConfidenceAtBusinessBoundary() {
         InboundOrderEntity inbound = inbound("WAIT_MEASURE");