fix: complete phase5 overseas deployment contract

2026-09-01 20:20:25 +08:00
parent d88e5cffce 8e17401f37
commit 974d7b1e43
45 changed files with 810 additions and 638 deletions
@@ -0,0 +1,74 @@
+package com.baiyue.lastleg.dropship.controller;
+
+import com.baiyue.lastleg.dropship.dto.DropshipRequests;
+import com.baiyue.lastleg.dropship.service.DropshipOrderService;
+import com.baiyue.lastleg.security.InternalServiceTokenGuard;
+import org.junit.jupiter.api.Test;
+import org.mockito.InOrder;
+import org.springframework.test.util.ReflectionTestUtils;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestHeader;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+import java.lang.reflect.Method;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.mockito.Mockito.inOrder;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+class DropshipOrderControllerContractTest {
+    @Test
+    void routeRequiresTheFrozenInternalTokenHeaderBeforeCallingTheService() throws Exception {
+        RequestMapping base = DropshipOrderController.class.getAnnotation(RequestMapping.class);
+        Method receive = DropshipOrderController.class.getMethod("receive", String.class,
+            DropshipRequests.Receive.class);
+        RequestHeader token = receive.getParameters()[0].getAnnotation(RequestHeader.class);
+
+        assertThat(base.value()).containsExactly("/internal/v1/lastleg/dropship");
+        assertThat(receive.getAnnotation(PostMapping.class).value()).containsExactly("/receive");
+        assertThat(token.value()).isEqualTo("X-Internal-Service-Token");
+
+        InternalServiceTokenGuard guard = mock(InternalServiceTokenGuard.class);
+        DropshipOrderService service = mock(DropshipOrderService.class);
+        DropshipOrderController controller = new DropshipOrderController();
+        ReflectionTestUtils.setField(controller, "tokenGuard", guard);
+        ReflectionTestUtils.setField(controller, "service", service);
+        DropshipRequests.Receive request = request();
+        when(service.receive(request)).thenReturn(1);
+
+        assertThat(controller.receive("internal-token", request).data()).isEqualTo(1);
+        InOrder order = inOrder(guard, service);
+        order.verify(guard).verify("internal-token");
+        order.verify(service).receive(request);
+    }
+
+    @Test
+    void versionedOpenApiMatchesTheControllerAndDtoContract() throws Exception {
+        String yaml = Files.readString(
+            Path.of("src/main/resources/openapi/lastleg-internal-dropship-v1.yaml"),
+            StandardCharsets.UTF_8);
+
+        assertThat(yaml).contains(
+            "version: 1.0.0",
+            "/internal/v1/lastleg/dropship/receive:",
+            "name: X-Internal-Service-Token",
+            "required: [customerId, orderId, warehouseId, idempotencyKey, pallets]",
+            "required: [palletNo, skuPackages]",
+            "required: [skuCode, packageCount, productQuantity, cartonMarks]",
+            "data: { type: integer, format: int32, minimum: 0 }");
+        assertThat(yaml.indexOf("name: X-Internal-Service-Token"))
+            .isLessThan(yaml.indexOf("requestBody:"));
+    }
+
+    private static DropshipRequests.Receive request() {
+        return new DropshipRequests.Receive("100", 10L, 20L, "event-1",
+            List.of(new DropshipRequests.Pallet("PALLET-1",
+                List.of(new DropshipRequests.SkuPackages("SKU-1", "Product", 1, 2,
+                    List.of("CARTON-1"))))));
+    }
+}