1.7 KiB
1.7 KiB
Warehouse Service 模块指引
职责边界
- 负责国内收货仓、仓库地址、服务能力、启停校验和往来单位主数据。
- 往来单位保存在
baiyue_warehouse.wh_partner，不是独立服务；订单只通过内部接口校验并保存快照。
功能快速索引
| 功能 | 入口 |
|---|---|
| 商户可用仓库列表与详情 | controller/MerchantWarehouseController.java |
| 平台仓库增改查与启停 | controller/PlatformWarehouseController.java |
| 内部仓库有效性校验 | controller/InternalWarehouseController.java |
| 商户往来单位候选与详情 | controller/MerchantPartnerController.java |
| 内部往来单位有效性校验 | controller/InternalPartnerController.java |
| 仓库业务编排 | service/WarehouseApplicationService.java |
| 往来单位查询与停用过滤 | service/PartnerQueryService.java |
| 请求与详情 DTO | dto/WarehouseRequests.java、WarehouseDetailResponse.java |
| 仓库、地址、能力、伙伴持久化 | entity/、mapper/、repository/ |
| 表结构、伙伴与种子数据 | src/main/resources/db/warehouse.sql、warehouse-partner.sql、warehouse-seed.sql |
| 测试 | src/test/java/com/baiyue/warehouse/ |
修改与验证
- 商户只看到可用且符合租户/服务范围的数据；平台启停必须检查业务约束，不能只改状态字段。
- 往来单位与仓库查询供 Order 使用，DTO 或有效性语义变化需同步检查
order/client/和订单快照逻辑。 - 数据表、Entity、Mapper、Repository 与种子数据必须同步；历史订单不随主数据更新。
- 从父目录运行
mvn -pl warehouse -am test，再运行scripts/order-warehouse-real-api-regression.ps1。