功能提交

warehouse/AGENTS.md

@@ -15,7 +15,7 @@
 | 内部资源锁定、释放、报废 | `controller/InternalWarehouseResourceLockController.java` |
 | 仓库与资源服务 | `service/WarehouseApplicationService.java`、`WarehouseResourceService.java`、`WarehouseResourceLockService.java` |
 | 内部服务令牌 | `security/InternalServiceTokenGuard.java` |
-| 数据库 | `src/main/resources/db/warehouse.sql` |
+| 数据库基线与中文注释契约 | `src/main/resources/db/warehouse.sql`、`src/test/java/com/baiyue/warehouse/schema/SchemaChineseCommentContractTest.java` |
 | 测试 | `src/test/java/com/baiyue/warehouse/` |
 
 ## 数据与安全规则
@@ -24,8 +24,22 @@
 - 资源锁定以业务幂等键和 reservation 标识防重；释放/报废操作必须验证当前状态。
 - 内部资源接口必须校验服务令牌；普通用户不得直接调用。
 
+## 数据库表索引与注释约束
+
+| 业务域 | 表名 | 中文含义 |
+|---|---|---|
+| 库位 | `wh_location` | 海外仓库位资源 |
+| 托盘 | `wh_pallet` | 海外仓实物托盘资源 |
+| 资源锁 | `wh_resource_lock` | 仓储资源锁定记录 |
+| 仓库 | `wh_warehouse` | 海外仓档案 |
+| 仓库地址 | `wh_warehouse_address` | 海外仓地址 |
+| 服务能力 | `wh_service_capability` | 海外仓服务能力 |
+| 托盘绑定 | `wh_pallet_business_binding` | 托盘业务绑定关系 |
+
+- 新增或修改表时，表 `COMMENT` 和每个普通字段的 `COMMENT` 必须填写准确的中文业务含义。
+- `SchemaChineseCommentContractTest` 自动扫描全部 `wh_` 表；新增字段必须同步更新基线 SQL、统一增量 SQL 和存量备注迁移。
+
 ## 修改与验证
 
 - 字段、注释和索引同步维护基线 SQL 与统一增量 SQL。
 - 定向验证：`mvn -pl warehouse -am test`。
-