# 三期文档

三期以头程物流“03 出仓”为范围，完成从排柜、订舱、拖车和仓内拣货，到封柜、报关、国内出仓并等待装船的业务闭环。

## 当前主体模型与开工禁令

- 三期继续按业务单租户、“平台—客户”两级开发，客户之间严格隔离。Java 与接口中的业务 `tenant_id > 0` / `tenantId` 当前表示客户 ID；`tenant_id=0` 是平台身份、平台 RBAC 和平台公共仓库、快递公司、托盘、库位等公共资源技术作用域。客户往来单位、订单、文件和费用仍归属客户 `tenant_id>0`。
- 三期不得新增租户主表、租户选择器、客户所属租户配置、租户切换、租户级 RBAC 或租户级配置，也不得把当前 `tenant_id` 从客户 ID 改义为上级租户 ID。
- `tenant`、`Tenant*`、`merchant`、接口路径和字段属于历史兼容命名，继续保留；真实租户能力必须等未来独立需求、数据迁移和跨服务契约方案确认后再实施。

## 文档

- [三期闭环审计报告（2026-08-08）](三期闭环审计报告-2026-08-08.md)：基于当前代码、接口、自动化和测试环境证据的闭环审计，列出阻断项、优先级和 GO 准入标准。
- [三期开发规划：国内出仓](三期开发规划.md)
- [三期开发进度表](三期开发进度表.md)：参考一期采用“大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”结构维护。
- [虫虫出海三期开发进度表（Excel）](虫虫出海三期开发进度表.xlsx)：可筛选、可下拉维护并使用公式汇总的项目进度工作簿。
- [三期需求确认表](三期需求确认表.md)：集中跟踪 P3-Q1～P3-Q13、负责人和最终结论。
- [三期页面与原型清单](三期页面与原型清单.md)：按管理后台、企业客户端和 PDA 维护页面范围及原型状态。
- `参考资料/出仓流程.png`：本期 9 个核心动作及业务终点的原始参考图。

## 当前状态

三期已有排柜/预装/PDA 拣货/装柜清单子链路，订舱和拖车子模块 API 也已实现并完成独立环境验证；但 2026-08-08 闭环审计结论仍为 `NO-GO`。已确认不新建出仓单，现有订单列表承载待分柜、装柜中、装柜完成和派送完成等主状态。当前缺少订单三期统一编排、五张装柜照片真实上传与硬门禁、报关协同、冲正、Client 三期协同及 PDA 真实身份/真机验收，暂不具备整期验收条件。详细缺口和 GO 标准以最新闭环审计报告为准。