1

2026-08-04 14:57:50 +08:00
parent 4899c95b75
commit 79d9652402
4 changed files with 132 additions and 19 deletions
@@ -126,10 +126,10 @@
 | `receivingWarehouseId` | 提交必填 | 平台国内收货仓 ID；提交时必须存在且处于启用状态 |
 | `receivingWarehouseName` | 服务端保存 | 下单时仓库名称冗余，兼容列表和旧消费者 |
 | `receivingWarehouseSnapshot` | 服务端保存 | 下单时仓库展示快照，至少包含 ID、编码、名称、省、市和详细地址 |
-| `shipperCounterpartyId` | 提交必填 | 后台维护的启用发货单位 ID；服务端按当前数据范围校验 |
-| `shipperSnapshot` | 服务端保存 | 下单时发货单位名称、联系人、电话和地址快照 |
-| `consigneeCounterpartyId` | 提交必填 | 后台维护的启用收货单位 ID；服务端按当前数据范围校验 |
-| `consigneeSnapshot` | 服务端保存 | 下单时收货单位名称、联系人、电话和地址快照 |
+| `shipperCounterpartyId` | 可选 | 兼容后台往来单位引用；企业客户端下单不强制选择 |
+| `shipperSnapshot` | 我司提货时提交必填 | 仅取货方式为 `PICKUP` 时保存提货公司、联系人、电话和地址快照；自送快递、自送卡车不要求 |
+| `consigneeCounterpartyId` | 可选 | 兼容后台往来单位引用；企业客户端下单不强制选择 |
+| `consigneeSnapshot` | 私人仓时提交必填 | 仅目的仓类型为 `PRIVATE` 时保存私人收件地址快照；FBA 仓、海外仓使用所选公共仓主数据，不重复填写收件资料 |
 | `deliveryInfo` | 平台维护 | 可选履约信息，包含快递公司 ID/快照和快递单号；企业客户端只读 |
 | `transportMode` | 提交必填 | FCL、LCL、AIR、ROAD |
 | `businessType` | 提交必填 | 一期支持 EXPORT、IMPORT |
@@ -1,9 +1,9 @@
 # 虫虫出海一期开发进度表

 > 创建日期：2026-07-27
-> 更新日期：2026-07-31
-> 当前阶段：一期双端持续浏览器联调；Client 一期核心静态页面与路由已完成（静态完成度 100%）。当前采用“前端可改、`baiyue-firstleg/` 后端只读核对”的联调方式；已修正订单主往来单位 `customerId`、往来单位类型契约，并接入角色编辑/启停/删除真实 API。仍需后端准备启用收货仓、自定义角色和快递有值样本后完成浏览器只读验收，写操作暂不执行
-> 总体状态：开发中
+> 更新日期：2026-08-03
+> 当前阶段：一期功能基本完成，进入测试环境部署、业务样本补齐和验收收口。双端核心页面已接真实 API；后端 19 个 Reactor 模块、169 项测试及本地真实接口回归已通过。2026-08-03 最新门禁中，Client 99 项测试和双端生产构建通过，Admin 129 项测试中 122 项通过、7 项失败，需先修正企业审核标识映射及其余页面断言后再做最终验收
+> 总体状态：收口中（暂不标记一期完成）

 头程订单一期闭环范围与接口草案见 `一期头程订单闭环设计.md`。

@@ -42,17 +42,17 @@

 | 模块 | 范围 | 状态 | 进度 | 计划开始 | 计划完成 | 负责人 | 备注 |
 |---|---|---|---:|---|---|---|---|
-| 基础工程 | 前后端工程、数据库、环境、接口规范 | 进行中 | 55% | 2026-07-27 | 待排期 | 待分配 | 双端统一响应、Token 会话和 Gateway 代理已接入；订单与基础资料契约仍待补齐 |
-| 后台客户管理 | 客户档案、企业资料审核、启停和资料维护 | 联调中 | 82% | 2026-07-27 | 待排期 | 待分配 | 客户档案仍使用 Pinia 模拟数据；企业审核已接真实待审、租户资质、鉴权文件预览及审核接口 |
-| 后台管理 | 内部用户、角色、权限 | 进行中 | 70% | 2026-07-27 | 待排期 | 待分配 | RBAC 前端交互已完成，等待接口与真实鉴权 |
-| 后台头程订单 | 订单列表、详情、处理和状态流转 | 进行中 | 70% | 2026-07-27 | 待排期 | 待分配 | 前端创建、查询、详情、指派及状态处理已完成 |
-| 平台收货仓 | 平台维护国内收货仓；客户端选择启用仓库 | 联调中 | 80% | 2026-07-28 | 待排期 | 待分配 | 客户端仓库分页、启用过滤、空态禁建和订单快照已接真实 API；当前返回 0 条，后台维护接口与持久化仍待联调 |
-| 快递公司维护 | 平台后台维护快递公司档案、启停、批量导入及订单履约信息关联 | 进行中 | 75% | 2026-07-28 | 待排期 | 待分配 | 原型字段核对与 Vue 静态实现均已完成；维护、权限、标准模板、整批校验和订单单组履约信息可验收，等待业务 API |
-| 往来单位维护 | 平台后台维护发货单位、收货单位、供应商、服务商档案、批量导入及订单引用 | 进行中 | 75% | 2026-07-28 | 待排期 | 待分配 | 原型核对与 Vue 静态实现分别完成；六类多选、联系人、完整地址、启停、模板下载和文件基础检查可验收，工作表解析与整批导入等待后端 API |
-| 登录注册与客户入驻 | Admin 登录、企业端免审核注册、我的信息、公司信息及企业资料审核 | 联调中 | 85% | 2026-07-27 | 待排期 | 待分配 | Client 已接真实注册登录、退出、刷新令牌、企业资料编辑与营业执照鉴权预览；接口曾完成基础实测，当前局域网 Gateway 请求超时，待恢复后完成浏览器验收 |
-| 客户端权限体系 | 企业成员、菜单、角色、权限 | 联调中 | 82% | 2026-07-28 | 待排期 | 待分配 | 已接角色列表/新增和成员列表；授权写接口为全量替换，但缺少已有权限 ID 与已有角色 ID 回显，暂保持只读 |
-| 客户端头程订单 | 下单、列表、详情、平台收货仓及往来单位只读选择 | 联调中 | 85% | 2026-07-28 | 待排期 | 待分配 | 列表、详情、创建/编辑草稿和提交已接真实 API；待审核企业可存草稿但不能提交，往来单位接口、有效仓库种子数据、真实写入和服务端重验仍待完成 |
-| 联调与上线 | 测试、验收、部署、初始化数据 | 待开始 | 0% | 待排期 | 待排期 | 待分配 | 一期发布 |
+| 基础工程 | 前后端工程、数据库、环境、接口规范 | 测试中 | 92% | 2026-07-27 | 待排期 | 待分配 | 双端工程、Gateway、认证、统一响应、数据库脚本和 OpenAPI 基础已完成；待测试环境迁移、配置发布和部署核验 |
+| 后台客户管理 | 客户档案、企业资料审核、启停和资料维护 | 测试中 | 88% | 2026-07-27 | 待排期 | 待分配 | 客户档案、资质和审核已接真实 API；当前 Admin 测试暴露审核记录 `reviewId`/租户字段映射风险，修复后需用待审/驳回样本验收 |
+| 后台管理 | 内部用户、角色、权限 | 测试中 | 93% | 2026-07-27 | 待排期 | 待分配 | 内部用户完整生命周期、角色权限回显与保存、权限资源维护均已接真实 API；待受限账号、停用权限即时生效和跨租户 403 验收 |
+| 后台头程订单 | 订单列表、详情、审核、受理、处理、完成、取消及履约信息 | 测试中 | 93% | 2026-07-27 | 待排期 | 待分配 | 订单状态流转、内部备注及快递信息已接真实 API；待准备完整状态与快递有值样本完成浏览器验收 |
+| 平台收货仓 | 平台维护国内收货仓；客户端选择启用仓库 | 测试中 | 92% | 2026-07-28 | 待排期 | 待分配 | 后台增改查和启停、客户端选择、详情及订单快照均已接真实 API；待测试环境初始化启用仓库并验收停用与历史引用 |
+| 快递公司维护 | 平台后台维护快递公司档案、启停及订单履约信息关联 | 测试中 | 90% | 2026-07-28 | 待排期 | 待分配 | 后台分页、详情、新增、编辑、启停和订单履约快递已接真实 API；批量导入后端解析接口尚未形成最终验收证据 |
+| 往来单位维护 | 平台后台维护往来单位档案、启停及订单引用 | 测试中 | 92% | 2026-07-28 | 待排期 | 待分配 | 后台增改查和启停、客户端真实候选及订单快照已接真实 API；批量导入及多类型测试样本仍待最终验收 |
+| 登录注册与客户入驻 | Admin 登录、企业端注册、个人与企业资料及企业审核 | 测试中 | 92% | 2026-07-27 | 待排期 | 待分配 | 登录注册、令牌轮换、个人/企业资料、资质上传与鉴权预览均已接真实 API；待五种企业状态和文件存储部署验收 |
+| 客户端权限体系 | 企业成员、菜单、角色、权限 | 测试中 | 95% | 2026-07-28 | 待排期 | 待分配 | 成员完整维护、角色增改启停删除、权限回显与全量保存均已接真实 API；Client 相关自动化测试通过，待普通成员和越权场景验收 |
+| 客户端头程订单 | 下单、列表、详情、平台收货仓及往来单位选择 | 测试中 | 94% | 2026-07-28 | 待排期 | 待分配 | 草稿、编辑、提交、列表、详情、幂等、仓库与往来单位快照均已接真实 API；待有效主数据和完整状态样本完成浏览器闭环验收 |
+| 联调与上线 | 测试、验收、部署、初始化数据 | 进行中 | 65% | 2026-07-30 | 待排期 | 待分配 | 本地后端真实接口回归、Client 99 项测试和双端构建已通过；Admin 尚有 7 项测试失败，测试环境迁移、部署及业务验收未完成 |

 ## 三、详细任务表

@@ -4,6 +4,9 @@

 ## 文档

+- [二期 V2 需求确认清单（当前会议填写）](二期V2需求确认清单.md)
+- [二期需求优化版 V2：测量、计费、托盘入库主流程](二期需求优化版-v2-测量计费入库主流程.md)
+- [二期需求优化版：原型对照（上一版优化稿）](二期需求优化版-原型对照.md)
 - [二期开发规划：头程到仓](二期开发规划.md)
 - [二期头程计费模块规划](二期计费财务模块规划.md)
 - [二期头程计费需求确认表](二期计费财务需求确认表.md)
@@ -17,4 +20,4 @@

 ## 当前状态

-二期已经启动，采用“需求确认与开发并行”的推进方式。2026-07-31 已合并产品确认结果：到仓作业结论已补齐，二期财务范围收缩为“仅头程计费”。当前只剩 P2-Q14、P2-Q15、P2-Q16 三项计费细节待确认；应收应付、对账、收付款、核销、发票、汇率结算和利润不纳入二期。具体任务状态和实际进度由开发负责人回填，当前文档不代表已承诺完成日期。
+二期已经启动，采用“需求确认与开发并行”的推进方式。2026-07-31 已合并产品确认结果：到仓作业结论已补齐，二期财务范围收缩为“仅头程计费”。当前 V2 的 C1-C8 业务结论以及 T1-T3 技术、仓库和供应商参数仍待确认；原 P2-Q14 至 P2-Q16 已并入 V2，不再单独维护。应收应付、对账、收付款、核销、发票、汇率结算和利润不纳入二期。具体任务状态和实际进度由开发负责人回填，当前文档不代表已承诺完成日期。
@@ -0,0 +1,110 @@
+# 虫虫出海二期 V2 需求确认清单
+
+> 创建日期：2026-08-03  
+> 当前状态：待产品与业务确认  
+> 确认对象：[二期需求优化版 V2：测量、计费、托盘入库闭环](二期需求优化版-v2-测量计费入库主流程.md)  
+> 适用范围：头程订单审核通过后的测量、计费、托盘分配、库位占用和入库闭环
+
+## 一、使用说明
+
+- 本清单是二期 V2 的唯一会议确认入口。
+- 产品只有一人，不填写确认人和确认时间，只填写“最终结论”和“状态”。
+- 状态统一使用：`待确认`、`已确认`、`暂缓`。
+- 认可当前建议时，可将当前建议直接复制为最终结论，并把状态改为“已确认”。
+- 修改当前建议时，必须写清可直接转成页面、接口、状态、计算或验收规则的最终结论。
+- 暂时无法确定时，状态改为“暂缓”，同时填写二期临时处理方式。
+- C1 至 C8 全部形成可开发结论后，V2 才能替换现有 24 项开发计划。
+
+## 二、产品与业务必须确认的 8 项
+
+| 编号 | 需要确认的事项 | 当前建议 | 最终结论 | 状态 |
+|---|---|---|---|---|
+| C1 | 是否正式采用 V2 作为二期唯一开发基线 | 采用“测量数据采集 → 测量审核 → 自动试算 → 人工确认 → 发送费用 → 托盘与库位占用 → 入库成功”主流程；确认后旧 24 项计划和第一份优化稿停止作为开发依据 | 待填写 | 待确认 |
+| C2 | 长宽高和重量分别从哪里取得 | 长宽高由第三方测量设备按入仓码回传；重量由称重图片 OCR 识别，允许人工校正并保留 OCR 原值、修正值和修正原因 | 待填写 | 待确认 |
+| C3 | 测量审核失败是否允许继续计费和入库 | 默认禁止；仅在 Nacos 异常放行开关开启、操作人有专属权限且填写放行原因时允许继续；作废单、缺少费用快照或无可用库位始终禁止放行 | 待填写 | 待确认 |
+| C4 | 二期计费结果的业务边界 | 二期只生成发送给客户的头程费用；船司价格只作为计价基础，不生成船司应付、成本、对账、收付款、核销、发票或利润数据 | 待填写 | 待确认 |
+| C5 | KG/CBM 计费公式、换算系数和价格匹配维度 | 包税按 `体积 × 167` 转换为 KG 后与实重取大；不包税按 `重量 ÷ 363` 转换为 CBM 后与实测体积取大；`167`、`363` 按客户规则版本配置，不硬编码；价格按起运仓、渠道/计费类型、船司、FBA 目的仓和有效期唯一匹配 | 待填写 | 待确认 |
+| C6 | 二期首批头程费用项目白名单 | 只纳入实际使用的基础运费和明确附加费；每项费用必须确认编码、名称、计费单位、币种、自动/人工、触发条件及是否允许人工调整 | 待填写 | 待确认 |
+| C7 | 发送费用、入库成功及复核节点 | “发送费用给客户”作为二期完成节点：锁定费用快照、生成托盘分配、占用库位并将入库单改为已入库；默认不再增加独立接收审核或第二人复核 | 待填写 | 待确认 |
+| C8 | 托盘拆分和库位占用规则 | 按实际总体积除以单托盘可用容积向上取整；二期默认一托一库位；托盘只分配体积和箱数汇总，不拆到 SKU；入库后换位作为 P1 独立功能 | 待填写 | 待确认 |
+
+## 三、C6 首批费用项目填写表
+
+没有实际业务的费用不要为了匹配原型而纳入二期。白名单之外的费用默认不能自动生成。
+
+| 费用编码 | 费用名称 | 计费单位 | 默认币种 | 自动/人工 | 单价来源 | 触发条件 | 是否允许调整 | 备注 |
+|---|---|---|---|---|---|---|---|---|
+| 待填写 | 待填写 | KG/CBM/票/固定金额 | CNY/USD/待确认 | 待填写 | 客户规则/船司价格/人工 | 待填写 | 待填写 | 待填写 |
+| 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+
+## 四、技术、仓库与供应商确认的 3 项
+
+以下事项不要求产品单独决定，但必须在对应任务开工前形成书面技术结论。
+
+| 编号 | 需要确认的事项 | 当前建议 | 最终结论 | 状态 |
+|---|---|---|---|---|
+| T1 | 第三方长宽高设备接入参数 | 确认供应商、测试环境、入仓码格式、设备编码、事件号、HMAC 签名、时间戳容差、幂等期限、超时和重试规则；第三方不得直接传内部数据库主键 | 待填写 | 待确认 |
+| T2 | OCR 接入参数 | 确认 OCR 服务商、图片格式、单图技术上限、单批数量、识别时限、置信度阈值、公斤/磅识别、失败重试和人工校正规则；业务服务通过 `fileId` 调用，不传服务器目录 | 待填写 | 待确认 |
+| T3 | 托盘和库位基础资料 | 确认托盘编码规则、标准可用容积、仓库现有托盘数量、库位编码、可用状态及初始化数据；并发占位由数据库唯一约束或乐观锁保证 | 待填写 | 待确认 |
+
+## 五、确认后形成的二期主流程
+
+```text
+一期头程订单审核通过
+  → 生成入库单和唯一入仓码
+  → 第三方回传长宽高
+  → 上传称重图片并进行 OCR
+  → 人工校正和确认重量
+  → 测量审核
+  → 客户规则与船司 FBA 价格自动试算
+  → 人工确认费用
+  → 发送费用给客户
+  → 拆分托盘并分配库位
+  → 占用库位并完成入库
+  → 客户只读查看费用和入库结果
+  → 异步发送客户通知
+```
+
+## 六、明确不纳入二期
+
+- 船司应付、供应商应付和应付审核。
+- 客户或供应商对账单、结算周期和账单争议。
+- 收款、付款、退款、核销、反核销和银行流水。
+- 发票、开票接口、会计凭证和总账。
+- 单票利润、利润率和完整财务报表。
+- 阶梯价、组合优惠和通用计费表达式平台。
+- 完整 SKU 库存、盘点、拣货、复核和出库。
+- 入库后的常规移库、拆托、并托和库存成本。
+- PDA 作业端。
+
+## 七、与原确认问题的对应关系
+
+| 原编号 | 原问题 | V2 对应项 | 处理方式 |
+|---|---|---|---|
+| P2-Q14 | 首批费用项目 | C6 | 由 C6 费用白名单替代 |
+| P2-Q15 | 计费规则复杂度 | C4、C5 | 由计费边界、公式和匹配维度替代 |
+| P2-Q16 | 费用生成节点 | C7 | 由费用确认、发送和入库成功节点替代 |
+
+C1 至 C8 确认后，原 P2-Q14 至 P2-Q16 不再单独维护，避免形成两套需求编号。
+
+## 八、确认完成后的文档处理
+
+1. 将本文件状态改为“已确认”。
+2. 将 [二期需求优化版 V2](二期需求优化版-v2-测量计费入库主流程.md) 标记为正式开发基线。
+3. 将 [二期需求优化版：原型对照](二期需求优化版-原型对照.md) 标记为历史版本，不再用于开发。
+4. 用 V2 的 13 项任务替换现有 24 项开发计划，并同步 Markdown 和 Excel 进度表。
+5. 将 C1 至 C8 的结论转换为状态、接口、数据表、权限、异常和验收规则。
+6. 将 T1 至 T3 分配给技术、仓库和供应商负责人，在对应开发任务开始前补齐。
+7. 后续新增应收应付、对账、收付款、发票或利润时，必须另行立项，不得直接扩入二期。
+
+## 九、进入开发排期的完成标准
+
+- C1 至 C8 均为“已确认”，或“暂缓”但已写明二期可执行的临时处理方式。
+- C6 至少形成一版可初始化的费用项目白名单。
+- 计费公式、换算系数、唯一匹配维度和费用发送节点可以转为自动化测试。
+- 托盘数量、库位占用和并发冲突规则可以转为数据库约束和接口验收。
+- T1 至 T3 已明确责任方和最晚完成节点。
+- V2 的 13 项任务已经同步到正式开发进度表，旧任务不再继续认领。