ouyangxq
b34626bd4b
新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。 - 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条 - 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节 - 仅索引文档，未改动业务代码
1.5 KiB
1.5 KiB
Admin 主数据模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/master-data/，代码路径相对本目录；应用公共规则见../../../AGENTS.md。 - 子域分目录：
counterparties/（往来单位）、express-companies/（快递公司），各自有页面与 API。 - 后端都归
warehouse/（PlatformPartnerController、PlatformExpressCompanyController、PartnerImportService）；供应商不在此处，见../suppliers/。
页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 往来单位列表、导入与启停 | counterparties/pages/PartnersView.vue |
counterparties/api/platformPartners.ts；warehouse/ |
| 快递公司列表与维护 | express-companies/pages/ExpressCompaniesView.vue |
express-companies/api/platformExpressCompanies.ts；warehouse/ |
| 导入模板与批量写入 | 往来单位导入入口 | warehouse/PartnerImportService.java |
关键边界
- 往来单位与快递公司是平台公共主数据（
tenant_id=0），不绑定客户。 - 导入先全量校验再原子写入，逐行失败原因回填；不信任模板隐藏列。
- 供应商（含 TRUCKING 国内/海外车队范围）归
../suppliers/，不要在本模块扩展供应商类别。 - 停用往来单位不影响历史单据的名称快照。
验证
- 定向：
pnpm test src/modules/master-data/<目标测试>；导入规则变化同时核对warehouse/的导入合同。 - 本文件或索引变更后，从后端根运行
./scripts/agents-index-contract.ps1。