baiyue-firstleg/common-event-contract/src/main/java/com/baiyue/common/event/FirstLegLoadingPlanCompletedV2.java

package com.baiyue.common.event;

import com.fasterxml.jackson.annotation.JsonProperty;
import java.math.BigDecimal;
import java.util.List;

/** 装柜完成交接快照，包含三类逐货物备注、推荐托数和可复用的头程托盘编号快照。 */
public record FirstLegLoadingPlanCompletedV2(
        String loadingPlanId, String planNo,
        @JsonProperty("sourceContainerBookingId") String containerBookingId,
        String containerNo, String cabinetNo, String warehouseId, String warehouseName,
        String estimatedPortArrivalAt, String actualPortArrivalAt, String estimatedWarehouseArrivalAt,
        List<Order> orders) {
    public FirstLegLoadingPlanCompletedV2 {
        if (loadingPlanId == null || loadingPlanId.isBlank()
            || containerBookingId == null || containerBookingId.isBlank()) {
            throw new IllegalArgumentException("loadingPlanId and sourceContainerBookingId are required");
        }
        containerNo = ContainerNumbers.requireCanonical(containerNo);
        orders = orders == null ? List.of() : List.copyOf(orders);
        if (orders.isEmpty()) throw new IllegalArgumentException("orders are required");
        Order owner = orders.get(0);
        if (orders.stream().anyMatch(order -> !owner.customerId().equals(order.customerId())
            || !owner.customerName().equals(order.customerName()))) {
            throw new IllegalArgumentException("orders must share one immutable customerId/customerName snapshot");
        }
    }

    public FirstLegLoadingPlanCompletedV2(String loadingPlanId, String planNo, String containerBookingId,
                                          String containerNo, String cabinetNo, String warehouseId,
                                          String warehouseName, List<Order> orders) {
        this(loadingPlanId, planNo, containerBookingId, containerNo, cabinetNo, warehouseId,
            warehouseName, null, null, null, orders);
    }

    public record Order(
            String sourceInboundId, String rootInboundId,
            String sourceOrderId, String sourceOrderNo, String rootOrderId,
            String inboundCode, String destinationWarehouseId,
            String destinationWarehouseCode, String destinationWarehouseName,
            int packageCount, Integer productQuantity, Integer palletCount,
            BigDecimal grossWeightKg, BigDecimal netWeightKg, BigDecimal volumeCbm,
            BigDecimal volumeWeightKg,
            List<Item> items, String customerId, String customerName, String orderType, List<PalletSnapshot> pallets,
            /** 目的类型：FBA 可按箱数收货，OVERSEAS 必须逐箱扫码。 */
            String destinationType, String lxCode) {
        public Order {
            items = items == null ? List.of() : items;
            if (customerId == null || customerId.isBlank()) {
                throw new IllegalArgumentException("customerId is required");
            }
            if (customerName == null || customerName.isBlank()) {
                throw new IllegalArgumentException("customerName is required");
            }
            customerId = customerId.trim();
            customerName = customerName.trim();
            if (customerId.length() > 128 || customerName.length() > 128) {
                throw new IllegalArgumentException("customerId/customerName snapshot is too long");
            }
            orderType = orderType == null || orderType.isBlank() ? "FIRST_LEG" : orderType;
            pallets = pallets == null ? List.of() : pallets;
        }

        public Order(String sourceInboundId, String rootInboundId,
                     String sourceOrderId, String sourceOrderNo, String rootOrderId,
                     String inboundCode, String destinationWarehouseId,
                     String destinationWarehouseCode, String destinationWarehouseName,
                     int packageCount, Integer productQuantity, Integer palletCount,
                     BigDecimal grossWeightKg, BigDecimal netWeightKg, BigDecimal volumeCbm,
                     List<Item> items, String customerId, String customerName,
                     String orderType, List<PalletSnapshot> pallets) {
            this(sourceInboundId, rootInboundId, sourceOrderId, sourceOrderNo, rootOrderId,
                inboundCode, destinationWarehouseId, destinationWarehouseCode,
                destinationWarehouseName, packageCount, productQuantity, palletCount,
                grossWeightKg, netWeightKg, volumeCbm, null, items, customerId, customerName,
                orderType, pallets, null, null);
        }

        public Order(String sourceInboundId, String rootInboundId,
                     String sourceOrderId, String sourceOrderNo, String rootOrderId,
                     String inboundCode, String destinationWarehouseId,
                     String destinationWarehouseCode, String destinationWarehouseName,
                     int packageCount, Integer productQuantity, Integer palletCount,
                     BigDecimal grossWeightKg, BigDecimal netWeightKg, BigDecimal volumeCbm,
                     List<Item> items, String customerId, String customerName,
                     String orderType, List<PalletSnapshot> pallets, String destinationType) {
            this(sourceInboundId, rootInboundId, sourceOrderId, sourceOrderNo, rootOrderId,
                inboundCode, destinationWarehouseId, destinationWarehouseCode,
                destinationWarehouseName, packageCount, productQuantity, palletCount,
                grossWeightKg, netWeightKg, volumeCbm, null, items, customerId, customerName,
                orderType, pallets, destinationType, null);
        }

        public Order(String sourceInboundId, String rootInboundId,
                     String sourceOrderId, String sourceOrderNo, String rootOrderId,
                     String inboundCode, String destinationWarehouseId,
                     String destinationWarehouseCode, String destinationWarehouseName,
                     int packageCount, Integer productQuantity, Integer palletCount,
                     BigDecimal grossWeightKg, BigDecimal netWeightKg, BigDecimal volumeCbm,
                     BigDecimal volumeWeightKg, List<Item> items, String customerId, String customerName,
                     String orderType, List<PalletSnapshot> pallets, String destinationType) {
            this(sourceInboundId, rootInboundId, sourceOrderId, sourceOrderNo, rootOrderId,
                inboundCode, destinationWarehouseId, destinationWarehouseCode, destinationWarehouseName,
                packageCount, productQuantity, palletCount, grossWeightKg, netWeightKg, volumeCbm,
                volumeWeightKg, items, customerId, customerName, orderType, pallets, destinationType, null);
        }
    }

    public record Item(
            String sourceInboundDetailId, String skuCode,
            String productNameZh, String productNameEn,
            int packageCount, Integer productQuantity, Integer palletCount,
            BigDecimal grossWeightKg, BigDecimal netWeightKg,
            BigDecimal dimensionalWeightKg, BigDecimal volumeCbm,
            String destinationWarehouseId, String destinationWarehouseCode,
            String destinationWarehouseName, String fbaTrackingNo,
            String shipmentNo, String shippingMark,
            String customerRemark, String internalRemark, String warehouseRemark,
            String palletNo,
            /** 按实装箱数稳定随机冻结的头程箱号；数量与 packageCount 相等且均对应本明细 SKU。 */
            List<String> cartonMarks) {
        public Item {
            cartonMarks = cartonMarks == null ? List.of() : cartonMarks;
        }

        public Item(String sourceInboundDetailId, String skuCode,
                    String productNameZh, String productNameEn,
                    int packageCount, Integer productQuantity, Integer palletCount,
                    BigDecimal grossWeightKg, BigDecimal netWeightKg,
                    BigDecimal dimensionalWeightKg, BigDecimal volumeCbm,
                    String destinationWarehouseId, String destinationWarehouseCode,
                    String destinationWarehouseName, String fbaTrackingNo,
                    String shipmentNo, String shippingMark,
                    String customerRemark, String internalRemark, String warehouseRemark) {
            this(sourceInboundDetailId, skuCode, productNameZh, productNameEn, packageCount,
                productQuantity, palletCount, grossWeightKg, netWeightKg,
                dimensionalWeightKg, volumeCbm, destinationWarehouseId,
                destinationWarehouseCode, destinationWarehouseName, fbaTrackingNo,
                shipmentNo, shippingMark, customerRemark, internalRemark, warehouseRemark,
                null, List.of());
        }
    }

    /** 头程托盘冻结快照；普通入仓用于复用打印编号，一键代发还冻结 SKU/箱唛库存。 */
    public record PalletSnapshot(String palletNo, List<SkuPackageSnapshot> skuPackages) {}

    /** 托盘下 SKU、箱数、数量及箱号冻结快照；cartonMarks 中每个箱号都对应 skuCode。 */
    public record SkuPackageSnapshot(String skuCode, String productName,
                                     int packageCount, int productQuantity,
                                     List<String> cartonMarks) {}
}