二期文档
二期当前范围止于头程下单、商户提交、平台审核、到仓测量与称重、费用试算和费用确认。测量审核后主状态停在 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：测量、计费、托盘入库主流程
- 二期需求优化版：原型对照（上一版优化稿）
- 二期开发规划：头程到仓
- 二期头程计费模块规划
- 二期头程计费需求确认表
- 二期费用项目数据归属决策记录
- 二期头程计费需求确认表（Excel，保留历史文件名）
- 二期产品待确认事项（发产品填写）
- 二期开发进度表
- 二期开发进度表（Excel）
- 二期前端页面清单与多对话并行任务表
- 海外仓阶梯费用前端联调说明（2026-08-05）
- 二期需求确认清单：产品与业务确认
- 二期需求确认清单（会议填写 Excel）
- 规划依据：头程物流流程图
当前状态
截至 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 产品结论仍由产品/业务负责人填写；已经实现和测试通过的技术能力记录在验收报告及确认清单的技术状态章节中。
核心文档
规划与历史文档
数据库增量
可重复执行的测试库增量脚本位于：
D:\baiyue-firstleg\deploy\sql\头程数据库统一增量-MySQL8.sql
该文件是头程数据库唯一增量入口，后续数据库变更只追加到此文件。当前已包含一期、二期以及海外仓阶梯费用基础资料所需结构、索引和权限。历史日期脚本不再作为部署入口。
其中海外仓阶梯费用新增：
wh_overseas_storage_fee_rulewh_overseas_storage_fee_tier- 5 个查询、唯一性和关联索引
- 4 项平台端按钮权限及平台系统管理员默认授权
原二期回归字段仍包含：
fl_inbound_weight_result.created_byfl_inbound_weight_result.updated_byfl_inbound_pallet_allocation.warehouse_resource_tenant_id