Files

6.4 KiB
Raw Permalink Blame History

入库测量与计费文档

入库测量与计费当前范围止于头程下单、商户提交、平台审核、到仓测量与称重、费用试算和费用确认。测量审核后主状态停在 WAIT_SPLIT,费用可独立维护且不得回退主流程状态;分柜、托盘/库位、预装、PDA 拣货、装柜和派送统一归入国内货柜履约。入库测量与计费不建设应收应付、对账、收付款、核销、发票和利润模块。

当前主体模型

  • 入库测量与计费继续按“平台—客户”两级开发。tenant_id > 0 / tenantId 当前表示客户 ID,用于客户隔离;tenant_id=0 是平台技术作用域。
  • 不新增真实租户、租户选择器或租户级 RBAC,也不把兼容字段重定义为上级租户。历史路径、字段与配置名继续保留。
  • 平台公共仓库、快递公司、托盘、库位和费用项目统一归属平台技术作用域 tenant_id=0,不绑定客户;客户往来单位、订单、文件和费用明细仍按所属客户 tenant_id>0 严格隔离,费用明细引用公共 fee_item_id。10001 是客户 ID,不得用于公共资源归属。

文档

当前状态

截至 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_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