添加快速索引文件

warehouse/AGENTS.md

@@ -0,0 +1,29 @@
+# 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`。