30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
|
# 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`。
|