fix: close phase4 overseas acceptance gaps

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/controller/MerchantWarehouseController.java

@@ -34,7 +34,7 @@ public class MerchantWarehouseController {
 
     @Operation(
         summary = "List available warehouses / 查询可用仓库",
-        description = "Tenant comes only from the authenticated JWT; clients cannot override it. / 租户仅从认证 JWT 获取，客户端不可覆盖。"
+        description = "Customer scope comes only from the authenticated JWT; any customerId query value is ignored. / 客户范围仅从认证 JWT 获取，查询中的 customerId 不生效。"
     )
     @ApiResponses({
         @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "Query succeeded / 查询成功"),

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/controller/PlatformWarehouseController.java

@@ -91,7 +91,8 @@ public class PlatformWarehouseController {
 
     @Operation(
         summary = "List warehouses / 查询仓库",
-        description = "Required authority: " + OverseasWarehousePermissions.WAREHOUSE_LIST + ". Returns all warehouses with optional filters."
+        description = "Required authority: " + OverseasWarehousePermissions.WAREHOUSE_LIST
+            + ". Returns warehouses across customers, or only the optional customerId scope when supplied."
     )
     @ApiResponses({
         @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "Query succeeded / 查询成功"),

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/dto/WarehouseRequests.java

@@ -8,6 +8,7 @@ import jakarta.validation.constraints.Min;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Pattern;
+import jakarta.validation.constraints.Positive;
 import jakarta.validation.constraints.Size;
 
 import java.math.BigDecimal;
@@ -94,6 +95,8 @@ public final class WarehouseRequests {
 
     @Schema(name = "WarehouseQueryRequest", description = "Warehouse page query / 仓库分页查询条件")
     public record QueryRequest(
+        @Schema(description = "Optional target customer ID for platform queries; merchant queries always use the authenticated customer / 平台查询可选目标客户 ID，商户查询始终使用认证客户", example = "10001", nullable = true)
+        @Positive Long customerId,
         @Schema(description = "Page number, starting at 1 / 页码，从 1 开始", example = "1", defaultValue = "1", minimum = "1")
         @Min(1) long page,
         @Schema(description = "Page size / 每页条数", example = "20", defaultValue = "20", minimum = "1", maximum = "200")

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/repository/WarehouseRepository.java

@@ -87,6 +87,7 @@ public class WarehouseRepository {
 
     public PageResult<WarehouseEntity> pageAll(WarehouseRequests.QueryRequest query) {
         LambdaQueryWrapper<WarehouseEntity> wrapper = new LambdaQueryWrapper<WarehouseEntity>()
+            .eq(query.customerId() != null, WarehouseEntity::getCustomerId, query.customerId())
             .eq(StringUtils.hasText(query.status()), WarehouseEntity::getStatus, query.status())
             .eq(StringUtils.hasText(query.countryCode()), WarehouseEntity::getCountryCode, query.countryCode())
             .orderByDesc(WarehouseEntity::getCreatedAt);
@@ -94,6 +95,7 @@ public class WarehouseRepository {
         if (StringUtils.hasText(query.capabilityCode())) {
             List<Long> ids = capabilities.selectList(new LambdaQueryWrapper<ServiceCapabilityEntity>()
                     .select(ServiceCapabilityEntity::getWarehouseId)
+                    .eq(query.customerId() != null, ServiceCapabilityEntity::getCustomerId, query.customerId())
                     .eq(ServiceCapabilityEntity::getCapabilityCode, query.capabilityCode())
                     .eq(ServiceCapabilityEntity::getEnabled, true))
                 .stream()