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.9 KiB

Raw Blame History

Admin FBA 价格簿模块指引

路径基准与读取顺序

本文件适用于 src/modules/fba-pricing/，代码路径相对本目录；应用公共规则见 ../../../AGENTS.md。
子域：carrier-rates/（客户专属价格簿、柜级阶梯运费、上传与确认）、customer-rules/（客户计费规则）；各自有页面与 API。
后端归 firstleg/（FbaPricingService.java、PlatformPriceBookService.java、firstleg/pricing/ContainerTierAmountAllocator.java）；计费消费方见 ../inbounds/。

页面与入口

目标	页面/入口	API 与后端
客户专属价格簿列表、上传与确认	`carrier-rates/pages/CarrierRatesView.vue`	`carrier-rates/api/platformPriceBooks.ts`；`firstleg/PlatformPriceBookService`
价格版本详情、仓库映射与只读价格行	`carrier-rates/pages/CarrierRateDetailView.vue`	同上
客户计费规则	`customer-rules/api.ts`	`firstleg/` 箱规与计价主数据
对外导出	`public.ts`	—

关键边界

价格簿页面必须显式选择公共报价或具体客户；列表、上传、确认只作用于该 customerId，不混版本。
计价优先客户专属 ACTIVE 版本，无专属才回退公共 ACTIVE；柜级阶梯金额与分摊只展示服务端结果。
调整计费量只能在服务端允许区间内，并提交当前费用版本、原因与二次确认。
上传后按 versionId 进入独立详情页，价格行只读；确认动作不可逆，需二次确认。
私人仓尾程派送费使用稳定代码，只对 PRIVATE 目的地开放；一件代发须在预装确认前完成试算。

验证

定向：pnpm test src/modules/fba-pricing/<目标测试>；价格字段变化同时核对 fba-pricing-v1.yaml 与 ../inbounds/ 计费消费。
本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。

1.9 KiB Raw Blame History Unescape Escape

Admin FBA 价格簿模块指引

路径基准与读取顺序

页面与入口

关键边界

验证

1.9 KiB

Raw Blame History