# Admin 仓储资源模块指引

## 路径基准与读取顺序

- 本文件适用于 `src/modules/warehouse-resources/`，代码路径相对本目录；应用公共规则见 `../../../AGENTS.md`。
- 模块按子域分目录：`locations/`（库位）、`pallets/`（托盘），各自有页面与 API；先定子域再看文件。
- 后端分两处：国内库位/托盘归 `warehouse/`，海外库位/托盘归 `warehouse-overseas-service/`；按当前页面仓库类型判断读哪个。

## 页面与入口

| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 库位列表、编码、类型与启停 | `locations/pages/LocationsView.vue` | `locations/api/platformLocations.ts`；`warehouse/`（国内）、`warehouse-overseas-service/`（海外） |
| 托盘列表、状态与批量操作 | `pallets/pages/PalletsView.vue` | `pallets/api/platformPallets.ts`；同上 |
| 托盘/库位打印入口 | 托盘行操作 | 打印模板归 `print/` |

## 关键边界

- 海外库位与托盘是公共资源（`customer_id=0`），平台接口不接收目标客户参数；资源锁仍按真实客户隔离。
- `A0/SHARED_OVERFLOW`、`VIRTUAL` 由服务端事实保护，不能按普通库位编辑、停用或删除。
- 可预留托盘必须 `IDLE` 且绑定库位为 `VIRTUAL + ACTIVE` 或真实库位 `IDLE`；前端只展示服务端 `reservable` 与阻断原因。
- 托盘标不得回退到 100×100 mm 箱唛模板；模板只在 `print/` 维护。
- 本模块只做资源主数据维护，不做排车、出库或派送的资源分配。

## 验证

- 定向：`pnpm test src/modules/warehouse-resources/<目标测试>`；接口变化同时核对对应服务的资源合同。
- 本文件或索引变更后，从后端根运行 `./scripts/agents-index-contract.ps1`。