优化

warehouse-overseas-service/AGENTS.md

@@ -2,6 +2,7 @@
 
 ## 职责与边界
 
+- Mapper 只由 `BaiyueWarehouseOverseasApplication.java` 对 `com.baiyue.warehouse` 根包按 `@Mapper` 过滤扫描；新增或移动 Mapper 后从后端根运行 `node scripts/mapper-scan-contract.mjs`，不得增加子域扫描配置。
 - 负责海外库位、托盘及业务资源锁定/释放；只保存国内仓库 ID 引用，不保存仓库、地址或能力主档。
 - 国内 `warehouse-service` 是仓库 ID、类型、状态、地址和能力的唯一权威；本服务通过内部目录校验平台共享 `OVERSEAS + ACTIVE + RECEIVING` 仓。尾程入仓计划通过内部网关请求资源；本模块不读取尾程订单库或头程数据库。
 

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/BaiyueWarehouseOverseasApplication.java

@@ -1,5 +1,6 @@
 package com.baiyue.warehouse;
 
+import org.apache.ibatis.annotations.Mapper;
 import org.mybatis.spring.annotation.MapperScan;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
@@ -8,7 +9,7 @@ import org.springframework.cloud.openfeign.EnableFeignClients;
 /**
  * 仓库微服务启动入口，启用 Spring Boot 自动配置并扫描仓库服务的 MyBatis Mapper。
  */
-@MapperScan("com.baiyue.warehouse.mapper")
+@MapperScan(basePackages = "com.baiyue.warehouse", annotationClass = Mapper.class)
 @EnableFeignClients(basePackages = "com.baiyue.warehouse.client")
 @SpringBootApplication(scanBasePackages = "com.baiyue")
 public class BaiyueWarehouseOverseasApplication {

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/mapper/WarehouseLocationMapper.java

@@ -1,10 +1,13 @@
 package com.baiyue.warehouse.mapper;
 
+import org.apache.ibatis.annotations.Mapper;
+
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import com.baiyue.warehouse.entity.WarehouseLocationEntity;
 import org.apache.ibatis.annotations.Insert;
 import org.apache.ibatis.annotations.Param;
 
+@Mapper
 public interface WarehouseLocationMapper extends BaseMapper<WarehouseLocationEntity> {
     /**
      * The unique location-code index makes this safe for concurrent first use of an older warehouse.

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/mapper/WarehousePalletBindingMapper.java

@@ -1,10 +1,13 @@
 package com.baiyue.warehouse.mapper;
 
+import org.apache.ibatis.annotations.Mapper;
+
 import com.baiyue.warehouse.entity.WarehousePalletBindingEntity;
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import org.apache.ibatis.annotations.Param;
 import org.apache.ibatis.annotations.Select;
 
+@Mapper
 public interface WarehousePalletBindingMapper extends BaseMapper<WarehousePalletBindingEntity> {
     @Select("SELECT * FROM wh_pallet_business_binding WHERE customer_id=#{customerId} AND warehouse_id=#{warehouseId} " +
         "AND business_type=#{businessType} AND business_id=#{businessId} LIMIT 1")

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/mapper/WarehousePalletMapper.java

@@ -1,6 +1,9 @@
 package com.baiyue.warehouse.mapper;
 
+import org.apache.ibatis.annotations.Mapper;
+
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import com.baiyue.warehouse.entity.WarehousePalletEntity;
 
+@Mapper
 public interface WarehousePalletMapper extends BaseMapper<WarehousePalletEntity> { }

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/mapper/WarehousePalletTransitionMapper.java

@@ -1,5 +1,7 @@
 package com.baiyue.warehouse.mapper;
 
+import org.apache.ibatis.annotations.Mapper;
+
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import com.baiyue.warehouse.entity.WarehousePalletEntity;
 import com.baiyue.warehouse.entity.WarehousePalletOperationEntity;
@@ -7,6 +9,7 @@ import org.apache.ibatis.annotations.Param;
 import org.apache.ibatis.annotations.Select;
 import org.apache.ibatis.annotations.Update;
 
+@Mapper
 public interface WarehousePalletTransitionMapper extends BaseMapper<WarehousePalletOperationEntity> {
     @Select("SELECT * FROM wh_pallet_operation WHERE operation_key=#{operationKey} LIMIT 1")
     WarehousePalletOperationEntity findOperation(@Param("operationKey") String operationKey);

warehouse-overseas-service/src/main/java/com/baiyue/warehouse/mapper/WarehouseResourceLockMapper.java

@@ -1,11 +1,14 @@
 package com.baiyue.warehouse.mapper;
 
+import org.apache.ibatis.annotations.Mapper;
+
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import com.baiyue.warehouse.entity.WarehouseResourceLockEntity;
 import org.apache.ibatis.annotations.Param;
 import org.apache.ibatis.annotations.Select;
 import org.apache.ibatis.annotations.Update;
 
+@Mapper
 public interface WarehouseResourceLockMapper extends BaseMapper<WarehouseResourceLockEntity> {
     @Select("""
         SELECT * FROM wh_resource_lock