85 lines
5.1 KiB
Markdown
85 lines
5.1 KiB
Markdown
# 二期文档
|
||
|
||
二期以头程物流“02 到仓”为作业主线，完成预约取货、送货上门、入库测量、差异记录和指定库位闭环，并增加头程费用项目、计费规则、费用试算和费用明细。产品已确认二期不建设应收应付、对账、收付款、核销、发票和利润模块。
|
||
|
||
## 当前主体模型
|
||
|
||
- 二期继续按“平台—客户”两级开发。`tenant_id > 0` / `tenantId` 当前表示客户 ID，用于客户隔离；`tenant_id=0` 是平台技术作用域。
|
||
- 不新增真实租户、租户选择器或租户级 RBAC，也不把兼容字段重定义为上级租户。历史路径、字段与配置名继续保留。
|
||
- 平台公共仓库、快递公司、托盘、库位等公共资源统一归属平台技术作用域 `tenant_id=0`，不绑定客户；客户往来单位、订单、文件和费用继续按所属客户 `tenant_id>0` 严格隔离。`10001` 是客户 ID，不得用于公共资源归属。
|
||
|
||
## 文档
|
||
|
||
- [二期 V2 需求确认清单（当前会议填写）](二期V2需求确认清单.md)
|
||
- [二期需求优化版 V2：测量、计费、托盘入库主流程](二期需求优化版-v2-测量计费入库主流程.md)
|
||
- [二期需求优化版：原型对照（上一版优化稿）](二期需求优化版-原型对照.md)
|
||
- [二期开发规划：头程到仓](二期开发规划.md)
|
||
- [二期头程计费模块规划](二期计费财务模块规划.md)
|
||
- [二期头程计费需求确认表](二期计费财务需求确认表.md)
|
||
- [二期头程计费需求确认表（Excel，保留历史文件名）](二期计费财务需求确认表.xlsx)
|
||
- [二期产品待确认事项（发产品填写）](二期产品待确认事项.md)
|
||
- [二期开发进度表](二期开发进度表.md)
|
||
- [二期开发进度表（Excel）](虫虫出海二期开发进度表.xlsx)
|
||
- [二期前端页面清单与多对话并行任务表](二期前端页面清单与多对话并行任务表.md)
|
||
- [海外仓阶梯费用前端联调说明（2026-08-05）](海外仓阶梯费用前端联调说明-2026-08-05.md)
|
||
- [二期需求确认清单：产品与业务确认](二期需求确认清单.md)
|
||
- [二期需求确认清单（会议填写 Excel）](二期需求确认清单.xlsx)
|
||
- [规划依据：头程物流流程图](参考资料/头程物流流程图.svg)
|
||
|
||
## 当前状态
|
||
|
||
截至 2026-08-04，任务 `019fc6f9-8dcf-74e1-bc68-d42f15d7802a` 已完成，二期核心主链路已在本地测试数据库和隔离服务端口上完成真实 API 回归，最终结果为 `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 产品结论仍由产品/业务负责人填写；已经实现和测试通过的技术能力记录在验收报告及确认清单的技术状态章节中。
|
||
|
||
## 核心文档
|
||
|
||
- [二期前端联调报告（2026-08-04）](二期前端联调报告-2026-08-04.md)
|
||
- [第三方入仓测量接口联调说明](第三方入仓测量接口联调说明-2026-08-04.md)
|
||
- [二期需求优化版 V2：测量、计费、托盘入库主流程](二期需求优化版-v2-测量计费入库主流程.md)
|
||
- [二期 V2 需求确认清单](二期V2需求确认清单.md)
|
||
|
||
## 规划与历史文档
|
||
|
||
- [二期需求优化版：原型对照](二期需求优化版-原型对照.md)
|
||
- [二期开发规划：头程到仓](二期开发规划.md)
|
||
- [二期开发进度表](二期开发进度表.md)
|
||
- [二期头程计费模块规划](二期计费财务模块规划.md)
|
||
- [二期头程计费需求确认表](二期计费财务需求确认表.md)
|
||
- [二期产品待确认事项](二期产品待确认事项.md)
|
||
- [二期需求确认清单：产品与业务确认](二期需求确认清单.md)
|
||
|
||
## 数据库增量
|
||
|
||
可重复执行的测试库增量脚本位于：
|
||
|
||
```text
|
||
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`
|