feat(phase3): 收口父子单与全链路验收

firstleg/src/main/java/com/baiyue/firstleg/controller/PlatformInboundMeasurementController.java

@@ -115,7 +115,7 @@ public class PlatformInboundMeasurementController {
         requirePlatformTenant(user, tenantId);
         CartonMeasurementCommand command = new CartonMeasurementCommand(
             request.boxCode(), request.length(), request.width(), request.height(), request.weight(),
-            request.machineNo(), request.measuredAt(), image);
+            request.machineNo(), request.measuredAt(), image, request.scannedShipmentId());
         return ApiResponse.success(cartonMeasurements.upsertForInbound(
             tenantId, user.userId(), inboundId, command));
     }

firstleg/src/main/java/com/baiyue/firstleg/dto/CartonMeasurementCommand.java

@@ -14,6 +14,7 @@ public record CartonMeasurementCommand(
     BigDecimal unitWeightKg,
     String machineNo,
     LocalDateTime measuredAt,
-    MultipartFile image
+    MultipartFile image,
+    String scannedShipmentId
 ) {
 }

firstleg/src/main/java/com/baiyue/firstleg/dto/CartonMeasurementResult.java

@@ -9,6 +9,7 @@ public record CartonMeasurementResult(
     Integer measurementVersion,
     Long itemId,
     String boxCode,
+    String scannedShipmentId,
     Integer confirmedPackageCount,
     BigDecimal lengthCm,
     BigDecimal widthCm,

firstleg/src/main/java/com/baiyue/firstleg/dto/InboundMeasurementRequests.java

@@ -71,6 +71,7 @@ public final class InboundMeasurementRequests {
         @NotNull @DecimalMin("0.001") @Digits(integer = 9, fraction = 3) BigDecimal width,
         @NotNull @DecimalMin("0.001") @Digits(integer = 9, fraction = 3) BigDecimal height,
         @DecimalMin("0.001") @Digits(integer = 15, fraction = 3) BigDecimal weight,
+        @Size(max = 64) String scannedShipmentId,
         @NotBlank @Size(max = 64) String machineNo,
         @NotNull LocalDateTime measuredAt
     ) {

firstleg/src/main/java/com/baiyue/firstleg/dto/InboundMeasurementResponses.java

@@ -67,6 +67,7 @@ public final class InboundMeasurementResponses {
         BigDecimal outerHeightCm,
         String remark,
         String boxCode,
+        String scannedShipmentId,
         Integer confirmedPackageCount,
         String machineNo,
         LocalDateTime deviceMeasuredAt,

firstleg/src/main/java/com/baiyue/firstleg/dto/MojiaMeasurementDtos.java

@@ -1,5 +1,7 @@
 package com.baiyue.firstleg.dto;
 
+import com.fasterxml.jackson.annotation.JsonAlias;
+import com.fasterxml.jackson.annotation.JsonProperty;
 import jakarta.validation.constraints.DecimalMax;
 import jakarta.validation.constraints.DecimalMin;
 import jakarta.validation.constraints.NotBlank;
@@ -16,6 +18,8 @@ public final class MojiaMeasurementDtos {
 
     public record UploadRequest(
         @NotBlank @Size(max = 128) String boxCode,
+        @JsonProperty("shipment_id") @JsonAlias("shipmentId")
+        @NotBlank @Size(max = 64) String shipmentId,
         @NotNull @DecimalMin("0.001") @DecimalMax("999999999.999") BigDecimal length,
         @NotNull @DecimalMin("0.001") @DecimalMax("999999999.999") BigDecimal width,
         @NotNull @DecimalMin("0.001") @DecimalMax("999999999.999") BigDecimal height,

firstleg/src/main/java/com/baiyue/firstleg/entity/InboundMeasurementItemEntity.java

@@ -21,6 +21,7 @@ public class InboundMeasurementItemEntity {
     private Long inboundDetailId;
     private String externalDetailNo;
     private String boxCode;
+    private String scannedShipmentId;
     private String itemNo;
     private String boxSpecification;
     private Integer packageCount;

firstleg/src/main/java/com/baiyue/firstleg/entity/MojiaMeasurementReceiptEntity.java

@@ -19,6 +19,7 @@ public class MojiaMeasurementReceiptEntity {
     private Long tenantId;
     private Long subjectId;
     private String boxCode;
+    private String scannedShipmentId;
     private BigDecimal lengthCm;
     private BigDecimal widthCm;
     private BigDecimal heightCm;

firstleg/src/main/java/com/baiyue/firstleg/service/CartonMeasurementService.java

@@ -177,6 +177,8 @@ public class CartonMeasurementService {
         item.setInboundDetailId(binding.inboundDetailId());
         item.setExternalDetailNo(boxCode);
         item.setBoxCode(boxCode);
+        item.setScannedShipmentId(StringUtils.hasText(command.scannedShipmentId())
+            ? command.scannedShipmentId().trim() : null);
         item.setItemNo("B" + binding.cartonIndex());
         item.setBoxSpecification(StringUtils.hasText(binding.boxSpecification())
             ? binding.boxSpecification().trim() : boxCode);
@@ -380,6 +382,10 @@ public class CartonMeasurementService {
         if (!StringUtils.hasText(command.machineNo()) || command.machineNo().trim().length() > 64) {
             throw new BizException(ResultCode.VALIDATION_FAILED, "设备编号不能为空且不能超过64个字符");
         }
+        if (StringUtils.hasText(command.scannedShipmentId())
+            && command.scannedShipmentId().trim().length() > 64) {
+            throw new BizException(ResultCode.VALIDATION_FAILED, "实扫Shipment ID不能超过64个字符");
+        }
         if (command.measuredAt() == null) {
             throw new BizException(ResultCode.VALIDATION_FAILED, "设备测量时间不能为空");
         }
@@ -404,7 +410,8 @@ public class CartonMeasurementService {
     private CartonMeasurementResult result(InboundMeasurementEntity measurement,
                                            InboundMeasurementItemEntity item, boolean created) {
         return new CartonMeasurementResult(measurement.getId(), measurement.getVersion(), item.getId(),
-            item.getBoxCode(), item.getPackageCount(), item.getLengthCm(), item.getWidthCm(),
+            item.getBoxCode(), item.getScannedShipmentId(), item.getPackageCount(),
+            item.getLengthCm(), item.getWidthCm(),
             item.getHeightCm(), item.getUnitWeightKg(), item.getSourceImageFileId(), item.getMachineNo(),
             item.getDeviceMeasuredAt(), created);
     }

firstleg/src/main/java/com/baiyue/firstleg/service/InboundMeasurementService.java

@@ -367,7 +367,8 @@ public class InboundMeasurementService {
             item.getUnitWeightKg(), item.getUnitVolumeCbm(), item.getTotalWeightKg(),
             item.getTotalVolumeCbm(), item.getVolumeWeightKg(), item.getSourceImageFileId(),
             item.getOverLimitWarning(), item.getOuterLengthCm(), item.getOuterWidthCm(),
-            item.getOuterHeightCm(), item.getRemark(), item.getBoxCode(), item.getPackageCount(),
+            item.getOuterHeightCm(), item.getRemark(), item.getBoxCode(), item.getScannedShipmentId(),
+            item.getPackageCount(),
             item.getMachineNo(), item.getDeviceMeasuredAt(), item.getUpdatedAt());
     }
 

firstleg/src/main/java/com/baiyue/firstleg/service/MojiaMeasurementOpenApiService.java

@@ -79,7 +79,7 @@ public class MojiaMeasurementOpenApiService {
                     app.tenantId(), app.subjectId(), new CartonMeasurementCommand(
                         request.boxCode(), request.length(), request.width(), request.height(), request.weight(),
                         request.machineNo(), request.measuredAt() == null ? LocalDateTime.now() : request.measuredAt(),
-                        image));
+                        image, request.shipmentId().trim()));
             } catch (BizException exception) {
                 if (exception.getResultCode() == ResultCode.NOT_FOUND) {
                     return saveUnmatched(app, request, image, exception);
@@ -117,6 +117,7 @@ public class MojiaMeasurementOpenApiService {
             receipt.setTenantId(app.tenantId());
             receipt.setSubjectId(app.subjectId());
             receipt.setBoxCode(request.boxCode().trim());
+            receipt.setScannedShipmentId(request.shipmentId().trim());
             receipt.setLengthCm(request.length());
             receipt.setWidthCm(request.width());
             receipt.setHeightCm(request.height());