fix: return A0404 for missing PDA pallets

lastleg-service/src/main/java/com/baiyue/lastleg/inboundplan/pda/gateway/HttpWarehouseResourceGateway.java

@@ -111,14 +111,26 @@ public class HttpWarehouseResourceGateway implements WarehouseResourceGateway {
             .uri("/internal/v1/warehouse-pallets/resolve/{palletCode}", palletCode)
             .header("X-Internal-Service-Token", internalToken)
             .retrieve().onStatus(HttpStatusCode::isError, (request, result) -> {
-                throw new IllegalArgumentException("Warehouse rejected pallet code: HTTP " + result.getStatusCode());
+                throw palletLookupFailure(result.getStatusCode());
             }).body(WarehousePalletResponse.class);
-        if (response == null || response.data() == null) throw new IllegalArgumentException("Warehouse returned an empty pallet response");
+        if (response != null && "A0404".equals(response.code())) {
+            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Warehouse pallet was not found");
+        }
+        if (response == null || response.data() == null) {
+            throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE,
+                "Warehouse pallet service returned no usable response");
+        }
         return new WarehousePalletReference(response.data().id(), response.data().palletCode(),
             response.data().warehouseId(), response.data().locationId(), response.data().status(),
             response.data().fbaWarehouseCode(), response.data().version());
     }
 
+    private ResponseStatusException palletLookupFailure(HttpStatusCode status) {
+        return new ResponseStatusException(status.value() == 404 ? HttpStatus.NOT_FOUND
+            : (status.is4xxClientError() ? HttpStatus.BAD_REQUEST : HttpStatus.SERVICE_UNAVAILABLE),
+            status.value() == 404 ? "Warehouse pallet was not found" : "Warehouse pallet lookup failed");
+    }
+
     @Override
     public WarehouseLocationReference resolveLocation(long warehouseId, String locationCode) {
         WarehouseLocationResponse response = client.get()
@@ -173,7 +185,7 @@ public class HttpWarehouseResourceGateway implements WarehouseResourceGateway {
         return response.data();
     }
 
-    private record WarehousePalletResponse(WarehousePalletData data) {}
+    private record WarehousePalletResponse(String code, String message, WarehousePalletData data) {}
     private record WarehousePalletData(@JsonAlias("palletId") long id, String palletCode, long warehouseId, long locationId,
                                        String status, String fbaWarehouseCode, int version) {}
     private record ReserveEnvelope(ReserveData data) {}

lastleg-service/src/main/java/com/baiyue/lastleg/palletops/gateway/HttpPalletPhysicalGateway.java

@@ -6,8 +6,10 @@ import jakarta.annotation.PostConstruct;
 import jakarta.annotation.Resource;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.HttpStatusCode;
+import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Component;
 import org.springframework.web.client.RestClient;
+import org.springframework.web.server.ResponseStatusException;
 
 import java.util.LinkedHashMap;
 import java.util.Map;
@@ -31,12 +33,24 @@ public class HttpPalletPhysicalGateway implements PalletPhysicalGateway {
         ResolveEnvelope response = client.get().uri("/internal/v1/warehouse-pallets/resolve/{code}", palletCode)
             .header("X-Internal-Service-Token", internalToken).retrieve()
             .onStatus(HttpStatusCode::isError, (request, result) -> {
-                throw new IllegalArgumentException("Warehouse rejected pallet scan: HTTP " + result.getStatusCode());
+                throw palletLookupFailure(result.getStatusCode());
             }).body(ResolveEnvelope.class);
-        if (response == null || response.data() == null) throw new IllegalStateException("Warehouse returned no pallet");
+        if (response != null && "A0404".equals(response.code())) {
+            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Warehouse pallet was not found");
+        }
+        if (response == null || response.data() == null) {
+            throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE,
+                "Warehouse pallet service returned no usable response");
+        }
         return response.data();
     }
 
+    private ResponseStatusException palletLookupFailure(HttpStatusCode status) {
+        return new ResponseStatusException(status.value() == 404 ? HttpStatus.NOT_FOUND
+            : (status.is4xxClientError() ? HttpStatus.BAD_REQUEST : HttpStatus.SERVICE_UNAVAILABLE),
+            status.value() == 404 ? "Warehouse pallet was not found" : "Warehouse pallet lookup failed");
+    }
+
     @Override
     public LocationReference resolveLocation(long warehouseId, long locationId) {
         LocationEnvelope response = client.get().uri(uri -> uri
@@ -76,7 +90,7 @@ public class HttpPalletPhysicalGateway implements PalletPhysicalGateway {
             }).toBodilessEntity();
     }
 
-    private record ResolveEnvelope(PalletReference data) { }
+    private record ResolveEnvelope(String code, String message, PalletReference data) { }
     private record LocationEnvelope(LocationReference data) { }
     private record TransitionEnvelope(Transition data) { }
 }

lastleg-service/src/main/java/com/baiyue/lastleg/palletops/service/PdaPalletOperationService.java

@@ -367,6 +367,7 @@ public class PdaPalletOperationService {
 
     private PalletPhysicalGateway.PalletReference requirePallet(long warehouseId, String code) {
         PalletPhysicalGateway.PalletReference pallet = physical.resolve(code(code));
+        if (pallet == null) throw notFound("未找到托盘");
         if (pallet.warehouseId() != warehouseId) throw conflict("托盘不属于 Token 冻结的海外仓");
         if ("SCRAPPED".equals(pallet.status())) throw conflict("已报废托盘不能执行作业");
         return pallet;
@@ -517,6 +518,7 @@ public class PdaPalletOperationService {
     private static long value(Long value) { return value == null ? 0L : value; }
     private static ResponseStatusException conflict(String message) { return new ResponseStatusException(HttpStatus.CONFLICT, message); }
     private static ResponseStatusException badRequest(String message) { return new ResponseStatusException(HttpStatus.BAD_REQUEST, message); }
+    private static ResponseStatusException notFound(String message) { return new ResponseStatusException(HttpStatus.NOT_FOUND, message); }
 
     private record PlannedMove(long positionId, long packages, long expectedVersion,
                                long sourcePalletId, String sourcePalletCode,

lastleg-service/src/main/java/com/baiyue/lastleg/pda/move/service/PdaInventoryMoveService.java

@@ -51,6 +51,7 @@ public class PdaInventoryMoveService {
         if (existing != null) return replay(existing, requestHash);
 
         var pallet = warehouse.resolvePallet(required(request.sourcePalletCode(), "Source pallet code is required"));
+        if (pallet == null) throw notFound("Source pallet was not found");
         if (pallet.warehouseId() != warehouseId) throw conflict("Source pallet belongs to another overseas warehouse");
         var target = warehouse.resolveLocation(warehouseId,
             required(request.targetLocationCode(), "Target location code is required"));
@@ -188,5 +189,6 @@ public class PdaInventoryMoveService {
     private static long value(Long value) { return value == null ? 0 : value; }
     private static String required(String value, String message) { if (value == null || value.isBlank()) throw badRequest(message); return value.trim(); }
     private static ResponseStatusException badRequest(String message) { return new ResponseStatusException(HttpStatus.BAD_REQUEST, message); }
+    private static ResponseStatusException notFound(String message) { return new ResponseStatusException(HttpStatus.NOT_FOUND, message); }
     private static ResponseStatusException conflict(String message) { return new ResponseStatusException(HttpStatus.CONFLICT, message); }
 }

lastleg-service/src/main/java/com/baiyue/lastleg/pda/warehouse/service/PdaWarehouseService.java

@@ -42,6 +42,7 @@ public class PdaWarehouseService {
 
     public PdaWarehouseResponses.Pallet pallet(long warehouseId, PdaWarehouseRequests.Scan request) {
         WarehouseResourceGateway.WarehousePalletReference pallet = warehouse.resolvePallet(code(request.code()));
+        if (pallet == null) throw notFound("Warehouse pallet was not found");
         if (pallet.warehouseId() != warehouseId) throw conflict("Pallet belongs to another overseas warehouse");
         WarehouseResourceGateway.WarehouseLocationReference location = warehouse.resolveLocation(warehouseId,
             pallet.locationId());