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
+30
View File
@@ -0,0 +1,30 @@
# Admin 供应商模块指引
## 路径基准与读取顺序
- 本文件适用于 `src/modules/suppliers/`,代码路径相对本目录;应用公共规则见 `../../../AGENTS.md`,供应商权限语义见 `../../../docs/平台客户层级与权限契约.md`。
- 供应商是平台公共主数据(`tenant_id=0`),不按客户隔离;往来单位归 `../master-data/`,国内整柜归 `../domestic-containers/`。
- 后端只查 `warehouse/`(公共往来单位与供应商主档)与 `file/`(资质附件)。
## 页面与入口
| 目标 | 页面/路由 | API 与后端 |
|---|---|---|
| 供应商列表、类别与范围筛选 | `pages/SuppliersView.vue`;`suppliers` | `api/platformSuppliers.ts`;`warehouse/` 供应商主档 |
| 新增供应商 | `pages/SupplierFormView.vue`;`suppliers/new` | `api/platformSuppliers.ts` |
| 供应商详情 | `pages/SupplierDetailView.vue`;`suppliers/:id` | `api/platformSuppliers.ts` |
| 编辑供应商 | `pages/SupplierFormView.vue`;`suppliers/:id/edit` | `api/platformSuppliers.ts` |
| 资质与证照附件 | `components/SupplierLicenseDialog.vue` | `file/` |
## 关键边界
- 供应商查询接口固定只使用 `platform:supplier:list`;`platform:supplier:view` 必须保持停用/移除,不得为兼容旧调用重新提升。
- 订舱代理、拖车承运商、报关代理与海外车队都从公共供应商列表选择 `ACTIVE` 且类别/范围匹配的记录;提交服务端供应商 ID,不提交名称或本地推断。
- 供应商是平台公共主数据,不绑定客户;客户筛选不得缩小供应商候选。
- 停用、改类别或改范围属高风险操作,必须确认与结果反馈;失败保留用户上下文。
- 资质附件归 `file/` 的平台作用域,不写入客户文件路径。
## 验证
- 定向:`pnpm test src/modules/suppliers/<目标测试>`;权限码或类别枚举变更同时核对 `warehouse` 供应商合同与权限初始化 SQL。
- 本文件或索引变更后,从后端根运行 `./scripts/agents-index-contract.ps1`。