32 lines
1.5 KiB
Markdown
32 lines
1.5 KiB
Markdown
# Warehouse Service 模块指引
|
|
|
|
## 职责与边界
|
|
|
|
- 负责海外仓库、地址、服务能力、库位、托盘及业务资源锁定/释放。
|
|
- 尾程入仓计划通过内部网关请求资源；本模块不读取尾程订单库或头程数据库。
|
|
|
|
## 快速索引
|
|
|
|
| 功能 | 入口 |
|
|
|---|---|
|
|
| 平台仓库管理 | `src/main/java/com/baiyue/warehouse/controller/PlatformWarehouseController.java` |
|
|
| 商户仓库查询 | `controller/MerchantWarehouseController.java` |
|
|
| 平台/商户库位与托盘 | `controller/PlatformWarehouseResourceController.java`、`MerchantWarehouseResourceController.java` |
|
|
| 内部资源锁定、释放、报废 | `controller/InternalWarehouseResourceLockController.java` |
|
|
| 仓库与资源服务 | `service/WarehouseApplicationService.java`、`WarehouseResourceService.java`、`WarehouseResourceLockService.java` |
|
|
| 内部服务令牌 | `security/InternalServiceTokenGuard.java` |
|
|
| 数据库 | `src/main/resources/db/warehouse.sql` |
|
|
| 测试 | `src/test/java/com/baiyue/warehouse/` |
|
|
|
|
## 数据与安全规则
|
|
|
|
- 平台和商户接口必须分别执行访问域与租户范围校验；客户端传入的 `tenantId` 不能作为唯一授权依据。
|
|
- 资源锁定以业务幂等键和 reservation 标识防重；释放/报废操作必须验证当前状态。
|
|
- 内部资源接口必须校验服务令牌；普通用户不得直接调用。
|
|
|
|
## 修改与验证
|
|
|
|
- 字段、注释和索引同步维护基线 SQL 与统一增量 SQL。
|
|
- 定向验证：`mvn -pl warehouse -am test`。
|
|
|