feat(order): expose unified order channel code

order/src/main/java/com/baiyue/order/client/FirstlegUnifiedOrderClient.java

@@ -45,7 +45,7 @@ public interface FirstlegUnifiedOrderClient {
                    String processStatus, String orderStatusSnapshot, String measureReviewStatus,
                    Integer version,
                    Long customerId, String customerName, Long warehouseId, String warehouseName,
-                   Long deliveryWarehouseId, String deliveryWarehouseName, String channelName,
+                   Long deliveryWarehouseId, String deliveryWarehouseName, String channelCode, String channelName,
                    Integer totalPackageCount, String locationCodes,
                    LocalDateTime expectedArrivalAt, LocalDateTime requestedPickupAt, String feeReviewStatus,
                    String companyName, String businessType, String taxMode, String containerMode,

order/src/main/java/com/baiyue/order/dto/UnifiedOrderResponse.java

@@ -15,7 +15,7 @@ public final class UnifiedOrderResponse {
         Long orderId, Long tenantId, String orderNo, String mainStatus, String nextAction,
         OrderRelationSummary relation,
         OrderStatus internalOrderStatus,
-        Long customerId, String customerName, String channelName,
+        Long customerId, String customerName, String channelCode, String channelName,
         Long receivingWarehouseId, String receivingWarehouseName,
         Long destinationWarehouseId, String destinationWarehouseName,
         Long inboundId, Integer inboundVersion, String inboundCode, LocalDate expectedShipDate,

order/src/main/java/com/baiyue/order/service/UnifiedOrderQueryService.java

@@ -267,7 +267,7 @@ public class UnifiedOrderQueryService {
                 order.getStatus() == OrderStatus.SUBMITTED ? "APPROVE_ORDER" : null,
                 relation(order, childCounts),
                 order.getStatus(), order.getCustomerId(), order.getCustomerName(),
-                order.getChannelName(), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
+                order.getChannelCode(), order.getChannelName(), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
                 order.getDestinationWarehouseId(), order.getDestinationWarehouseName(), null, null,
                 order.getInboundCode(),
                 order.getExpectedShipDate(), totalPackageCount(cargo), null, null, grossWeightKg(cargo), volumeCbm(cargo),
@@ -283,7 +283,7 @@ public class UnifiedOrderQueryService {
         return new UnifiedOrderResponse.Row(order.getId(), order.getTenantId(), order.getOrderNo(),
             summary.mainStatus(), summary.nextAction(), relation(order, childCounts), order.getStatus(),
             order.getCustomerId(), order.getCustomerName(),
-            order.getChannelName(), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
+            order.getChannelCode(), order.getChannelName(), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
             order.getDestinationWarehouseId(), order.getDestinationWarehouseName(), inbound.id(), inbound.version(), inbound.inboundCode(),
             order.getExpectedShipDate(), inbound.totalPackageCount() != null ? inbound.totalPackageCount() : totalPackageCount(cargo), null, inbound.locationCodes(),
             inbound.actualGrossWeightKg() != null ? inbound.actualGrossWeightKg() : grossWeightKg(cargo),
@@ -307,7 +307,7 @@ public class UnifiedOrderQueryService {
         return new UnifiedOrderResponse.Row(inbound.orderId(), inbound.tenantId(), inbound.orderNo(),
             summary.mainStatus(), summary.nextAction(), relation(order, childCounts),
             parseOrderStatus(inbound.orderStatusSnapshot()),
-            inbound.customerId(), inbound.customerName(), inbound.channelName(), inbound.warehouseId(),
+            inbound.customerId(), inbound.customerName(), inbound.channelCode(), inbound.channelName(), inbound.warehouseId(),
             inbound.warehouseName(), inbound.deliveryWarehouseId(), inbound.deliveryWarehouseName(),
             inbound.id(), inbound.version(), inbound.inboundCode(), null,
             inbound.totalPackageCount() != null ? inbound.totalPackageCount() : totalPackageCount(cargo),

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

@@ -477,6 +477,7 @@ components:
         internalOrderStatus: {type: string, enum: [DRAFT, SUBMITTED, APPROVED, ACCEPTED, REJECTED, CANCELLED, PROCESSING, COMPLETED], nullable: true}
         customerId: {type: integer, format: int64, nullable: true}
         customerName: {type: string, nullable: true}
+        channelCode: {type: string, nullable: true, description: 稳定物流渠道编码，仅供业务校验；直接来自当前 Order 或 Firstleg 权威快照，不由 channelName 推导}
         channelName: {type: string, nullable: true}
         receivingWarehouseId: {type: integer, format: int64, nullable: true}
         receivingWarehouseName: {type: string, nullable: true}