ouyangxq
3879a47673
按现行 OpenAPI 与计费规则修正两处业务偏差，并统一重复规则的维护位置。 - 费用项目：feeCode 允许编辑（OpenAPI 仅约束格式与长度），删除“编码不可变”表述；defaultPrice 改为“带入初值、允许人工修改”，明确为空与 0 的语义及不追改已有费用 - 入库测量：区分平台链路（PlatformInboundMeasurementController -> InboundMeasurementService/MeasurementSubmissionService）与设备上报（MojiaMeasurementOpenApiService） - 箱规算法与 actualMeasurementRows 口径不再在模块指引重复正文，改为指向详细索引
1.7 KiB
1.7 KiB
Admin 尺寸配置模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/dimension-config/，代码路径相对本目录；应用公共规则见../../../AGENTS.md。 - 本模块没有页面，只有
api.ts、types.ts、index.ts：它是客户四档箱规与尺寸系数的数据层，由../inbounds/（测量）和../customers/（客户计费规则）消费。 - 后端只查
firstleg/的CustomerDimensionConfigService.java、CustomerDimensionWeightingService.java。
页面与入口
| 目标 | 入口 | API 与后端 |
|---|---|---|
| 客户箱规配置与四档尺寸 | api.ts、types.ts |
firstleg/service/CustomerDimensionConfigService.java |
| 尺寸系数与默认权重算法 | api.ts |
firstleg/service/CustomerDimensionWeightingService.java |
| 模块对外导出 | index.ts |
供 ../inbounds/、../customers/ 引用 |
关键边界
- 客户固定四档箱规与默认算法（
ADD/MULTIPLY）的正式规则见详细索引同名节；本模块只提供数据入口，不在调用方重写算法或补默认档位。 - 新建客户时的箱规与权重系数初始化由 IAM 建档流程触发（
iam/的初始化服务 + Firstleg 内部接口），本模块只提供查询与保存入口。 - 尺寸单位固定为厘米，体积由服务端计算；页面与调用方不自行换算。
- 改类型或字段时同步检查
../inbounds/、../customers/两个消费方与 Firstleg 合同测试。
验证
- 定向：
pnpm test src/modules/dimension-config/<目标测试>；字段变化同时核对两个消费方。 - 本文件或索引变更后，从后端根运行
./scripts/agents-index-contract.ps1。