ouyangxq
b34626bd4b
新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。 - 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条 - 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节 - 仅索引文档，未改动业务代码
2.6 KiB
2.6 KiB
Admin 客户模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/customers/，代码路径相对本目录；应用公共规则见../../../AGENTS.md，客户与权限语义见../../../docs/business-index.md、docs/平台客户层级与权限契约.md。 - 客户主档、成员与角色归
../iam/，账号与登录标识归backend auth/，资质文件归file/；本模块只做客户视图、审核入口与客户级计费规则。 - 后端只查
iam/（客户主档与审核）、auth/（登录标识）、file/（资质）、firstleg/customerstatistics/（运营统计）。
页面与入口
| 目标 | 页面/路由 | API 与后端 |
|---|---|---|
| 客户列表、筛选与统计 | pages/CustomersView.vue；customers |
../iam/api/platformIam.ts；firstleg/customerstatistics/ |
| 企业审核入口 | pages/CustomersView.vue；customers/reviews 模式 |
iam/ 审核接口；资质 file/ |
| 客户详情、计费规则与运营指标 | pages/CustomerDetailView.vue、components/CustomerBillingRulesPanel.vue、components/CustomerOperatingMetricCard.vue；customers/:tenantId |
iam/、firstleg/ |
| 海外仓阶梯费用 | pages/OverseasStorageFeesView.vue、CustomerOverseasStorageFeePanel.vue；customers/overseas-storage-fees |
overseasStorageFee.ts、overseasStorageFeeTiers.ts；lastleg-service/ |
| 客户箱规与计费主数据 | components/CustomerBillingRulesPanel.vue |
firstleg/ 箱规与计价主数据 |
| 详情浮层标题与密度 | customerDialogTitle.ts、customerDensity.css |
本地实现，按公共密度样式约束 |
关键边界
- 公司联系电话只作企业联系信息，不修改管理员/成员登录手机号，也不要求跨企业唯一；编辑客户资料不提交账号手机号变更。
- 审核必填资质仅营业执照与统一社会信用代码；法人身份证选填，可随资质包提交，也可在已有营业执照后单独补传或替换。
- 客户列表属
*:list权限，已含详情只读；写操作使用独立权限，前端守卫不替代服务端鉴权。 - 平台仓库是公共主数据，不与客户绑定；客户筛选不得缩小仓库候选。
- 长整型客户 ID 按字符串透传，不用内部 ID 作业务编号展示。
- 海外仓阶梯费用按客户与仓库维度提交版本，金额与生效结果只认服务端返回。
验证
- 定向：
pnpm test src/modules/customers/<目标测试>；审核必填或费用阶梯变更同时核对iam/lastleg-service合同。 - 本文件或索引变更后，从后端根运行
./scripts/agents-index-contract.ps1。