Files

T

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

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

- 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条
- 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节
- 仅索引文档，未改动业务代码

2026-10-20 12:45:00 +08:00

1.7 KiB

Raw Blame History

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。

1.7 KiB Raw Blame History Unescape Escape

Admin 仓储资源模块指引

路径基准与读取顺序

页面与入口

关键边界

验证

1.7 KiB

Raw Blame History