docs(admin): add module-level AGENTS indexes for all 33 modules

新增 29 个模块级 AGENTS.md,补齐入口表指向,使 33 个业务模块均可从入口直达页面与接口。

- 每个模块指引统一为:路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 入口表 35 行改为指向 modules 下的 AGENTS.md,补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条
- 详细索引最长行从 1315 字符压缩到 699 字符,规则正文移入新增的“货柜工作台规则”小节
- 仅索引文档,未改动业务代码
This commit is contained in:
2026-10-20 12:45:00 +08:00
parent 7005228b52
commit b34626bd4b
32 changed files with 886 additions and 26 deletions
+27
View File
@@ -0,0 +1,27 @@
# Admin 仓库主档模块指引
## 路径基准与读取顺序
- 本文件适用于 `src/modules/warehouses/`,代码路径相对本目录;应用公共规则见 `../../../AGENTS.md`。
- 只有 `pages/WarehousesView.vue`、`api/platformWarehouses.ts`、`types.ts`;仓库地址、能力与状态都在同一页维护。
- 后端唯一权威是 `warehouse/`(`PlatformWarehouseController`、`WarehouseApplicationService.java`);本页不区分国内/海外仓,类型由服务端字段决定。
## 页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 仓库列表、类型、状态与地址 | `pages/WarehousesView.vue` | `api/platformWarehouses.ts`;`warehouse/` |
| 地址与服务能力维护 | 详情与编辑弹框 | `api/platformWarehouses.ts`;`warehouse/` |
| 海外仓合作仓 | 同页面,类型选择 | `warehouse/PlatformWarehouseController.java` |
## 关键边界
- 仓库 ID、类型、状态、地址与能力只在本模块维护;海外资源服务只保存 `warehouseId` 引用,不复制主档。
- 仓库是平台公共主数据(`tenant_id=0`),不绑定客户;客户筛选不得缩小仓库候选。
- 停用仓库前确认在途订单、预占与资源锁;停用不回溯历史单据。
- 海外收货仓必须是 `OVERSEAS + ACTIVE + RECEIVING`,FBA 目的仓必须是 `FBA`,不得互相顶替。
## 验证
- 定向:`pnpm test src/modules/warehouses/<目标测试>`;字段变化同时核对 `warehouse/` 的 `warehouse-v1.yaml`。
- 本文件或索引变更后,从后端根运行 `./scripts/agents-index-contract.ps1`。