87 lines
6.4 KiB
Markdown
87 lines
6.4 KiB
Markdown
# 入库测量与计费文档
|
||
|
||
入库测量与计费当前范围止于头程下单、商户提交、平台审核、到仓测量与称重、费用试算和费用确认。测量审核后主状态停在 `WAIT_SPLIT`，费用可独立维护且不得回退主流程状态；分柜、托盘/库位、预装、PDA 拣货、装柜和派送统一归入国内货柜履约。入库测量与计费不建设应收应付、对账、收付款、核销、发票和利润模块。
|
||
|
||
## 当前主体模型
|
||
|
||
- 入库测量与计费继续按“平台—客户”两级开发。`tenant_id > 0` / `tenantId` 当前表示客户 ID，用于客户隔离；`tenant_id=0` 是平台技术作用域。
|
||
- 不新增真实租户、租户选择器或租户级 RBAC，也不把兼容字段重定义为上级租户。历史路径、字段与配置名继续保留。
|
||
- 平台公共仓库、快递公司、托盘、库位和费用项目统一归属平台技术作用域 `tenant_id=0`，不绑定客户；客户往来单位、订单、文件和费用明细仍按所属客户 `tenant_id>0` 严格隔离，费用明细引用公共 `fee_item_id`。`10001` 是客户 ID，不得用于公共资源归属。
|
||
|
||
## 文档
|
||
|
||
- [入库测量与计费 V2 需求确认清单（当前会议填写）](入库测量与计费V2需求确认清单.md)
|
||
- [入库测量与计费需求优化版 V2：测量、计费、托盘入库主流程](入库测量与计费需求优化版-v2-测量计费入库主流程.md)
|
||
- [入库测量与计费需求优化版：原型对照（上一版优化稿）](入库测量与计费需求优化版-原型对照.md)
|
||
- [入库测量与计费开发规划：头程到仓](入库测量与计费开发规划.md)
|
||
- [入库测量与计费头程计费模块规划](入库测量与计费计费财务模块规划.md)
|
||
- [入库测量与计费头程计费需求确认表](入库测量与计费计费财务需求确认表.md)
|
||
- [入库测量与计费费用项目数据归属决策记录](入库测量与计费费用项目数据归属决策记录.md)
|
||
- [入库测量与计费头程计费需求确认表（Excel，保留历史文件名）](入库测量与计费计费财务需求确认表.xlsx)
|
||
- [入库测量与计费产品待确认事项（发产品填写）](入库测量与计费产品待确认事项.md)
|
||
- [入库测量与计费开发进度表](入库测量与计费开发进度表.md)
|
||
- [入库测量与计费开发进度表（Excel）](虫虫出海入库测量与计费开发进度表.xlsx)
|
||
- [入库测量与计费前端页面清单与多对话并行任务表](入库测量与计费前端页面清单与多对话并行任务表.md)
|
||
- [海外仓阶梯费用前端联调说明（2026-08-05）](海外仓阶梯费用前端联调说明-2026-08-05.md)
|
||
- [入库测量与计费需求确认清单：产品与业务确认](入库测量与计费需求确认清单.md)
|
||
- [入库测量与计费需求确认清单（会议填写 Excel）](入库测量与计费需求确认清单.xlsx)
|
||
- [规划依据：头程物流流程图](参考资料/头程物流流程图.svg)
|
||
|
||
## 当前状态
|
||
|
||
截至 2026-08-06，当前阶段边界已重新确认为 `WAIT_SPLIT + APPROVED + CONFIRMED`：`WAIT_SPLIT` 只表示入库测量与计费已完成、等待未来国内货柜履约分柜，不代表国内货柜履约已启动。2026-08-04 的 `INBOUNDED + APPROVED + SENT` 是旧范围下的历史回归结果，不再作为当前入库测量与计费验收终点。
|
||
|
||
- 订单：`2084549604719718402`
|
||
- 入库单：`2084549769916538881`
|
||
- 入仓码：`RK-2084549604719718402`
|
||
- 测量批次：`2084556854154715137`
|
||
- 费用单：`FBAF-2084549769916538881-1`
|
||
- 计费结果：实重 `20kg`，体积 `0.24m³`，计费量 `40.08kg`，费用 `440.68 CNY`
|
||
- 自动化测试：Firstleg 77 项、Warehouse 68 项、公共仓储技术归属专项（历史测试名含“资源租户”）3 项全部通过
|
||
- 在线验证：7 个隔离服务健康状态均为 `UP`
|
||
|
||
本地 OCR 未配置真实供应商凭证，因此本轮验证的是“图片上传成功、OCR 返回失败、人工修正并确认、继续完成计费入库”的可用降级链路。真实 OCR 识别准确率仍需在测试环境使用现场秤图验证。
|
||
|
||
产品确认与技术验收是两类状态。V2 的 C1-C8 产品结论仍由产品/业务负责人填写；已经实现和测试通过的技术能力记录在验收报告及确认清单的技术状态章节中。
|
||
|
||
## 核心文档
|
||
|
||
- [入库测量与计费前端联调报告（2026-08-04）](入库测量与计费前端联调报告-2026-08-04.md)
|
||
- [第三方入仓测量接口联调说明](第三方入仓测量接口联调说明-2026-08-04.md)
|
||
- [入库测量与计费需求优化版 V2：测量、计费、托盘入库主流程](入库测量与计费需求优化版-v2-测量计费入库主流程.md)
|
||
- [入库测量与计费 V2 需求确认清单](入库测量与计费V2需求确认清单.md)
|
||
|
||
## 规划与历史文档
|
||
|
||
- [入库测量与计费需求优化版：原型对照](入库测量与计费需求优化版-原型对照.md)
|
||
- [入库测量与计费开发规划：头程到仓](入库测量与计费开发规划.md)
|
||
- [入库测量与计费开发进度表](入库测量与计费开发进度表.md)
|
||
- [入库测量与计费头程计费模块规划](入库测量与计费计费财务模块规划.md)
|
||
- [入库测量与计费头程计费需求确认表](入库测量与计费计费财务需求确认表.md)
|
||
- [入库测量与计费费用项目数据归属决策记录](入库测量与计费费用项目数据归属决策记录.md)
|
||
- [入库测量与计费产品待确认事项](入库测量与计费产品待确认事项.md)
|
||
- [入库测量与计费需求确认清单：产品与业务确认](入库测量与计费需求确认清单.md)
|
||
|
||
## 数据库增量
|
||
|
||
可重复执行的测试库增量脚本位于：
|
||
|
||
```text
|
||
D:\baiyue-firstleg\deploy\sql\头程数据库统一增量-MySQL8.sql
|
||
```
|
||
|
||
该文件是头程数据库唯一增量入口，后续数据库变更只追加到此文件。当前已包含订单与客户、入库测量与计费以及海外仓阶梯费用基础资料所需结构、索引和权限。历史日期脚本不再作为部署入口。
|
||
|
||
其中海外仓阶梯费用新增：
|
||
|
||
- `wh_overseas_storage_fee_rule`
|
||
- `wh_overseas_storage_fee_tier`
|
||
- 5 个查询、唯一性和关联索引
|
||
- 4 项平台端按钮权限及平台系统管理员默认授权
|
||
|
||
原入库测量与计费回归字段仍包含：
|
||
|
||
- `fl_inbound_weight_result.created_by`
|
||
- `fl_inbound_weight_result.updated_by`
|
||
- `fl_inbound_pallet_allocation.warehouse_resource_tenant_id`
|