docs/二期/二期开发进度表.md

# 虫虫出海二期开发进度表：到仓与头程计费

> 创建日期：2026-07-28  
> 更新日期：2026-07-31  
> 当前阶段：开发已启动，需求确认并行  
> 总体状态：到仓规则和范围已确认，3 项计费细节待补充；实际开发进度待负责人回填

二期严格以头程物流“02 到仓”和头程计费为范围。范围依据见 [二期开发规划](二期开发规划.md)，确认结论见 [二期需求确认清单](二期需求确认清单.md)。原型只用于页面、字段和流程参考，不自动扩大二期范围。

## 一、进度口径

- 开发任务共 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% 的开发进度；开发、测试和验收完成后才能标记“已完成”。
- 需求结论先回写 [二期需求确认清单](二期需求确认清单.md)，再同步本表、开发规划、任务依赖和验收标准。