虫虫出海入库测量与计费开发进度表：到仓与头程计费
创建日期：2026-07-28
更新日期：2026-07-31
当前阶段：开发已启动，需求确认并行
总体状态：到仓规则和范围已确认，3 项计费细节待补充；实际开发进度待负责人回填
入库测量与计费严格以头程物流“02 到仓”和头程计费为范围。范围依据见 入库测量与计费开发规划，确认结论见 入库测量与计费需求确认清单。原型只用于页面、字段和流程参考，不自动扩大入库测量与计费范围。
零、2026-08-05 增量状态
| 任务 |
范围 |
后端 |
前端 |
验证 |
备注 |
P2-WH-OSF-01 |
海外仓客户级天数阶梯仓储费基础资料 CRUD |
已完成 |
不适用 |
Warehouse 全量 91 项、CRUD 定向 6 项通过 |
复用 Warehouse 服务和数据库，不参与当前自动计费 |
P2-ADM-12 |
海外仓阶梯费用平台端页面 |
接口、权限和 Gateway 路由已完成 |
待实现与联调 |
待前端 test、typecheck、build 和浏览器验收 |
契约见《海外仓阶梯费用前端联调说明-2026-08-05》 |
数据库变更只追加到 D:\baiyue-firstleg\deploy\sql\头程数据库统一增量-MySQL8.sql，不再创建日期增量脚本。
一、进度口径
- 开发任务共 24 项；未收到具体完成量、负责人和日期前，不虚填开发进度。
- 需求问题共 24 项：已确认 12 项、暂缓 1 项、待确认 3 项、不纳入入库测量与计费 8 项。
- 当前会议只需处理 P2-Q14、P2-Q15、P2-Q16。
- P2-Q9 暂缓，入库测量与计费不接 PDA；P2-Q17 至 P2-Q24 不纳入入库测量与计费。
- 应收应付、对账、收付款、核销、发票、汇率结算、利润和总账不进入任务、排期和验收。
二、总体进度
| 工作流 |
范围 |
状态 |
开发进度 |
需求状态 |
负责人 |
备注 |
| 规则与数据 |
到仓契约、数据模型、权限、文件和审计 |
待开始 |
0% |
到仓规则已确认 |
待分配 |
客户订单及基础资料契约是前置依赖 |
| 到仓预报 |
取货/送货预报和线下预约结果记录 |
待开始 |
0% |
Q2、Q3 已确认 |
待分配 |
不做容量调度和系统服务商分配 |
| 到仓收货 |
签到、分批收货、标签、照片、异常和冲正 |
待开始 |
0% |
Q1、Q8、Q10、Q12 已确认 |
待分配 |
不建设无预报认领流程 |
| 测量差异 |
实测、三位向上取整、差异记录和客户通知 |
待开始 |
0% |
Q4、Q5、Q6 已确认 |
待分配 |
差异无需客户确认，不阻塞上架或计费 |
| 库位上架 |
库位、上架任务和位置历史 |
待开始 |
0% |
Q7 已确认；Q9 暂缓 |
待分配 |
不做容量校验、隔离区和 PDA |
| 头程计费 |
费用项目、规则版本、试算、调整和费用明细 |
需求确认中 |
0% |
Q13 已确认；Q14-Q16 待确认 |
待分配 |
不生成后续财务数据 |
| 联调发布 |
时间线、测试、初始化、联调和发布 |
待开始 |
0% |
依赖 Q14-Q16 |
待分配 |
确认计费细节后锁定验收基线 |
三、详细任务表
| ID |
里程碑 |
端 |
模块 |
功能/交付内容 |
优先级 |
状态 |
进度 |
原型覆盖 |
需求阻塞 |
依赖 |
负责人 |
计划开始 |
计划完成 |
备注 |
| P2-BASE-01 |
P2-M0 |
公共 |
到仓契约 |
状态、枚举、权限、事件、错误码和快照模型 |
P0 |
待开始 |
0% |
部分 |
- |
客户订单契约 |
待分配 |
待排期 |
待排期 |
按已确认到仓规则建设 |
| P2-BASE-02 |
P2-M0 |
公共 |
数据模型 |
到仓单、批次、处理单元、标签、测量、差异、库位、位置、费用和审计 |
P0 |
待开始 |
0% |
部分 |
- |
P2-BASE-01 |
待分配 |
待排期 |
待排期 |
不包含后续财务对象 |
| P2-ADM-01 |
P2-M1 |
后台 |
到仓列表 |
查询、筛选、分页、详情、空态和异常态 |
P0 |
待开始 |
0% |
较完整 |
- |
P2-BASE-01 |
待分配 |
待排期 |
待排期 |
后台原型可参考 |
| P2-ADM-02 |
P2-M1 |
后台 |
预约结果 |
记录、调整和取消线下预约结果 |
P0 |
待开始 |
0% |
部分 |
- |
P2-ADM-01 |
待分配 |
待排期 |
待排期 |
不建设容量调度和自动分配 |
| P2-CLI-01 |
P2-M1 |
客户端 |
到仓预报 |
取货/送货方式、联系人、仓库和货物摘要提交 |
P0 |
待开始 |
0% |
部分 |
- |
P2-BASE-01 |
待分配 |
待排期 |
待排期 |
预约在线下完成 |
| P2-WH-01 |
P2-M2 |
后台 |
到仓签到 |
识别到仓单、分批收货、交接和异常登记 |
P0 |
待开始 |
0% |
部分 |
- |
P2-BASE-02 |
待分配 |
待排期 |
待排期 |
不建设无预报认领 |
| P2-LABEL-01 |
P2-M2 |
后台 |
处理单元标签 |
编码、佳博 1324D 适配、失败重试、补打、换标和作废 |
P0 |
待开始 |
0% |
部分 |
设备参数核验 |
P2-WH-01 |
待分配 |
待排期 |
待排期 |
开发前完成实机核验 |
| P2-REV-01 |
P2-M2 |
后台 |
收货冲正 |
错绑企业/订单/到仓单的审批、解绑和重绑 |
P0 |
待开始 |
0% |
无 |
- |
P2-WH-01 |
待分配 |
待排期 |
待排期 |
原记录不可删除 |
| P2-WH-02 |
P2-M3 |
后台 |
入库测量 |
原始测量、三位向上取整、复测、照片和历史复算 |
P0 |
待开始 |
0% |
较完整 |
- |
P2-LABEL-01 |
待分配 |
待排期 |
待排期 |
照片必传并保留技术安全控制 |
| P2-DIFF-01 |
P2-M3 |
公共 |
差异计算 |
申报实测对比、差异记录、通知状态和审计 |
P0 |
待开始 |
0% |
部分 |
- |
P2-WH-02 |
待分配 |
待排期 |
待排期 |
差异不阻塞主流程 |
| P2-ADM-03 |
P2-M3 |
后台 |
差异通知 |
查看、补充说明、通知客户和关闭记录 |
P0 |
待开始 |
0% |
部分 |
- |
P2-DIFF-01 |
待分配 |
待排期 |
待排期 |
只记录和通知 |
| P2-CLI-02 |
P2-M3 |
客户端 |
差异查看 |
查看实测、公开照片和差异通知 |
P1 |
待开始 |
0% |
部分 |
- |
P2-DIFF-01 |
待分配 |
待排期 |
待排期 |
不提供客户确认动作 |
| P2-HOLD-01 |
P2-M3 |
公共 |
异常记录 |
非差异类异常、责任人、证据、处理结果和审计 |
P1 |
待开始 |
0% |
部分 |
- |
P2-BASE-02 |
待分配 |
待排期 |
待排期 |
不建设隔离区或差异暂停 |
| P2-LOC-01 |
P2-M4 |
后台 |
库位维护 |
库区、库位编码、状态和权限范围 |
P0 |
待开始 |
0% |
较完整 |
- |
P2-BASE-02 |
待分配 |
待排期 |
待排期 |
不做容量校验 |
| P2-PUT-01 |
P2-M4 |
后台 |
上架任务 |
创建、分配、拆分、异常和完成 |
P0 |
待开始 |
0% |
较完整 |
- |
P2-LOC-01、P2-WH-02 |
待分配 |
待排期 |
待排期 |
不做隔离上架 |
| P2-POS-01 |
P2-M4 |
公共 |
位置记录 |
处理单元当前位置和进入/移出历史 |
P0 |
待开始 |
0% |
部分 |
- |
P2-PUT-01 |
待分配 |
待排期 |
待排期 |
入库测量与计费不建设完整库存系统 |
| P2-SEC-01 |
P2-M0 |
公共 |
文件与保留 |
文件鉴权、类型/安全校验、访问审计、永久保存和备份边界 |
P0 |
待开始 |
0% |
无 |
- |
P2-WH-01 |
待分配 |
待排期 |
待排期 |
产品不设业务大小上限 |
| P2-TIME-01 |
P2-M6 |
公共 |
时间线通知 |
对客事件、差异通知和失败补偿记录 |
P1 |
待开始 |
0% |
部分 |
- |
核心流程完成 |
待分配 |
待排期 |
待排期 |
外部通知渠道另行配置 |
| P2-FEE-01 |
P2-M5 |
后台 |
费用项目 |
头程费用项目、单位、币种、税务属性和启停 |
P0 |
需求确认中 |
0% |
较完整 |
Q14 |
P2-BASE-01 |
待分配 |
待排期 |
待排期 |
仅头程费用白名单 |
| P2-RATE-01 |
P2-M5 |
后台/服务端 |
计费规则 |
规则维度、版本、生效区间、价格结构和发布 |
P0 |
需求确认中 |
0% |
部分 |
Q15 |
P2-FEE-01 |
待分配 |
待排期 |
待排期 |
复杂度按会议结论裁剪 |
| P2-CALC-01 |
P2-M5 |
服务端 |
计费引擎 |
规则匹配、试算、事件触发、幂等、三位向上取整和复算 |
P0 |
需求确认中 |
0% |
无 |
Q16 |
P2-RATE-01、P2-WH-02 |
待分配 |
待排期 |
待排期 |
保存输入、规则和计算快照 |
| P2-FEE-02 |
P2-M5 |
后台 |
头程费用明细 |
自动/人工费用、确认、调整、作废、查询、导出和审计 |
P0 |
需求确认中 |
0% |
较完整 |
Q16 |
P2-CALC-01 |
待分配 |
待排期 |
待排期 |
不生成应收应付或账单 |
| P2-TEST-01 |
P2-M6 |
公共 |
自动化测试 |
越权、幂等、测量舍入、计费复算、标签、差异、位置、文件和审计 |
P0 |
待开始 |
0% |
不适用 |
Q14-Q16 |
所有 P0 模块 |
待分配 |
待排期 |
待排期 |
验证不会产生后续财务数据 |
| P2-REL-01 |
P2-M6 |
公共 |
发布验收 |
初始化仓库、库位、测量规则、标签和费用基础数据，联调、验收和发布 |
P0 |
待开始 |
0% |
不适用 |
Q14-Q16 |
P2-TEST-01 |
待分配 |
待排期 |
待排期 |
需求基线确认后承诺排期 |
四、里程碑
| 里程碑 |
交付目标 |
状态 |
开发进度 |
进入条件 |
计划完成 |
| P2-M0 规则锁定 |
到仓契约、数据关系、权限和文件基线 |
待开始 |
0% |
客户订单及基础资料契约稳定 |
待排期 |
| P2-M1 到仓预报 |
取货/送货预报和线下预约结果可记录 |
待开始 |
0% |
收货仓 API 可用 |
待排期 |
| P2-M2 到仓收货 |
签到、分批收货、标签、照片和冲正可追溯 |
待开始 |
0% |
文件服务、仓库权限及标签设备可用 |
待排期 |
| P2-M3 测量差异 |
原始测量、三位向上取整、差异记录和通知可用 |
待开始 |
0% |
测量规则可用 |
待排期 |
| P2-M4 库位上架 |
库位、上架任务和位置历史可查 |
待开始 |
0% |
库位编码规则确认 |
待排期 |
| P2-M5 头程计费 |
费用项目、规则版本、试算、调整和费用明细可用 |
需求确认中 |
0% |
Q14-Q16 确认，P2-M3 可用 |
待排期 |
| P2-M6 联调验收 |
跨端联调、安全、幂等、复算、测试和发布完成 |
待开始 |
0% |
P2-M1 至 P2-M5 验收通过 |
待排期 |
五、原型映射与范围边界
| 流程/能力 |
原型覆盖 |
入库测量与计费任务 |
入库测量与计费处理 |
| 取货/送货预报 |
部分 |
P2-ADM-02、P2-CLI-01 |
记录线下预约结果，不做容量调度 |
| 到仓收货 |
部分 |
P2-WH-01、P2-REV-01 |
分批收货和冲正；不建设无预报认领 |
| 入库测量 |
较完整 |
P2-WH-02 |
补充规则版本、三位向上取整和历史复算 |
| 差异核对 |
部分 |
P2-DIFF-01、P2-ADM-03、P2-CLI-02 |
只记录和通知，不需要客户确认、不阻塞后续流程 |
| 指定库位 |
较完整 |
P2-LOC-01、P2-PUT-01、P2-POS-01 |
不做容量校验和隔离区 |
| 标签打印 |
部分 |
P2-LABEL-01 |
使用佳博 1324D 实机适配 |
| 头程费用 |
部分 |
P2-FEE-01、P2-RATE-01、P2-CALC-01、P2-FEE-02 |
只做费用项目、规则、试算、调整和明细 |
| 应收应付、对账、收付款、核销 |
原型存在 |
- |
不纳入入库测量与计费 |
| 发票、汇率结算、利润和财务报表 |
原型存在 |
- |
不纳入入库测量与计费 |
| PDA |
有“03 出仓”原型 |
- |
Q9 暂缓，入库测量与计费不接 PDA |
| 完整库存/WMS |
原型存在 |
- |
入库测量与计费只维护处理单元位置记录 |
六、需求确认进度
| 状态 |
数量 |
编号 |
说明 |
| 已确认 |
12 |
Q1-Q8、Q10-Q13 |
到仓规则和“仅头程计费”已进入基线 |
| 暂缓 |
1 |
Q9 |
入库测量与计费不接 PDA |
| 待确认 |
3 |
Q14-Q16 |
费用白名单、计费复杂度、费用生成节点 |
| 不纳入入库测量与计费 |
8 |
Q17-Q24 |
后续财务与结算能力 |
七、测试与验收重点
- 企业和仓库数据权限隔离有效，越权请求被服务端拒绝。
- 重复签到、标签、测量、上架和计费事件不产生重复有效记录。
- 原始测量、三位向上取整结果、规则版本、复测原因和操作者可追溯。
- 差异能够通知客户并留痕，但不会等待客户确认或阻塞上架、计费。
- 称重和测量照片必传；文件类型、恶意内容、越权访问和技术大小上限校验有效。
- 佳博 1324D 完成内容、尺寸、连续打印、缺纸、断电和失败重试验证。
- 系统不存在隔离区、待认领区、无预报认领或库位容量拦截的隐藏流程。
- 费用可追溯到来源事件、计费输入和规则版本，历史费用复算一致。
- 已确认费用不能静默覆盖，调整、作废和导出均有审计。
- 系统不产生应收、应付、对账单、收付款、核销、发票、利润或总账数据。
八、状态维护规则
- 开发状态统一使用：需求确认中、待开始、进行中、联调中、测试中、已完成、已阻塞。
- 原型覆盖统一使用：较完整、部分、无、不适用；原型覆盖不得换算为开发进度。
- 负责人、计划开始和计划完成由排期会议填写；未获得实际数据时保持“待分配/待排期”。
- 开始编码后才能填写大于 0% 的开发进度；开发、测试和验收完成后才能标记“已完成”。
- 需求结论先回写 入库测量与计费需求确认清单，再同步本表、开发规划、任务依赖和验收标准。
