优化

lastleg-service/src/test/java/com/baiyue/lastleg/service/LastlegOrderServiceTest.java

@@ -1,6 +1,7 @@
 package com.baiyue.lastleg.service;
 
 import com.baiyue.lastleg.dto.LastlegOrderRequests;
+import com.baiyue.lastleg.dto.PendingContainerSummary;
 import com.baiyue.lastleg.entity.LastlegOrder;
 import com.baiyue.lastleg.entity.LastlegOrderDetail;
 import com.baiyue.lastleg.entity.LastlegOrderStatusHistory;
@@ -19,6 +20,8 @@ import org.springframework.web.server.ResponseStatusException;
 import org.springframework.test.util.ReflectionTestUtils;
 
 import java.util.List;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
@@ -133,6 +136,33 @@ class LastlegOrderServiceTest {
         assertEquals(25, page.getValue().getSize());
     }
 
+    @Test
+    void pendingContainerPageUsesServerSideAggregatePagination() {
+        var query = new LastlegOrderRequests.PendingContainerQuery(2, 10, "CONT-", null, null);
+        var row = new PendingContainerSummary("BOOKING-1", "CONT-1", 15, 15, 3,
+            150, 0, new BigDecimal("12.5000"), true, null);
+        when(orders.countPendingContainers(query)).thenReturn(11L);
+        when(orders.pagePendingContainers(query, 10, 10)).thenReturn(List.of(row));
+
+        var result = service.pendingContainerPage(query);
+
+        assertEquals(2, result.page());
+        assertEquals(10, result.size());
+        assertEquals(11, result.total());
+        assertEquals(2, result.pages());
+        assertEquals(List.of(row), result.records());
+    }
+
+    @Test
+    void pendingContainerPageRejectsReversedDateRangeBeforeQuerying() {
+        var query = new LastlegOrderRequests.PendingContainerQuery(1, 20, null,
+            LocalDateTime.of(2026, 8, 20, 0, 0), LocalDateTime.of(2026, 8, 19, 0, 0));
+
+        assertThrows(ResponseStatusException.class, () -> service.pendingContainerPage(query));
+
+        verify(orders, never()).countPendingContainers(any());
+    }
+
     private static LastlegOrder order(long id, String customerId, String status, String inboundOrderNo) {
         LastlegOrder order = new LastlegOrder();
         order.setId(id);

lastleg-service/src/test/java/com/baiyue/lastleg/service/PendingContainerSummaryContractTest.java

@@ -0,0 +1,46 @@
+package com.baiyue.lastleg.service;
+
+import com.baiyue.lastleg.dto.PendingContainerSummary;
+import com.baiyue.lastleg.mapper.LastlegOrderMapper;
+import org.apache.ibatis.annotations.Select;
+import org.junit.jupiter.api.Test;
+
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+class PendingContainerSummaryContractTest {
+    @Test
+    void responseFieldsAndServerAggregateSqlStayFrozen() throws Exception {
+        assertEquals(List.of("sourceContainerBookingId", "containerNo", "orderCount", "inboundCodeCount",
+                "customerCount", "totalPackageCount", "totalPalletCount", "totalVolumeCbm", "eligible",
+                "ineligibleReason"),
+            Arrays.stream(PendingContainerSummary.class.getRecordComponents()).map(value -> value.getName()).toList());
+
+        Select rows = LastlegOrderMapper.class.getMethod("pagePendingContainers",
+            com.baiyue.lastleg.dto.LastlegOrderRequests.PendingContainerQuery.class, long.class, long.class)
+            .getAnnotation(Select.class);
+        String sql = String.join("", rows.value()).toLowerCase();
+        assertTrue(sql.contains("group by o.source_container_booking_id"));
+        assertTrue(sql.contains("pending_assignment"));
+        assertTrue(sql.contains("destination_assigned"));
+        assertTrue(sql.contains("limit #{limit} offset #{offset}"));
+    }
+
+    @Test
+    void openApiAndSchemaExposeStableContainerIdentity() throws Exception {
+        String openApi = Files.readString(Path.of("src/main/resources/openapi/overseas-business-v1.yaml"),
+            StandardCharsets.UTF_8);
+        String schema = Files.readString(Path.of("src/main/resources/db/lastleg.sql"), StandardCharsets.UTF_8);
+
+        assertTrue(openApi.contains("/api/platform/v1/last-leg/orders/container-summaries:"));
+        assertTrue(openApi.contains("PendingContainerSummary:"));
+        assertTrue(openApi.contains("sourceContainerBookingId:"));
+        assertTrue(schema.contains("idx_ll_order_pending_container(source_container_booking_id,current_status,created_at)"));
+    }
+}