docs/三期

三期文档

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

当前主体模型与开工禁令

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

文档

• 三期开发规划：国内出仓
• 三期开发进度表：参考一期采用“大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”结构维护。
• 虫虫出海三期开发进度表（Excel）：可筛选、可下拉维护并使用公式汇总的项目进度工作簿。
• 三期需求确认表：集中跟踪 P3-Q1～P3-Q13、负责人和最终结论。
• 三期页面与原型清单：按管理后台、企业客户端和 PDA 维护页面范围及原型状态。
• 参考资料/出仓流程.png：本期 9 个核心动作及业务终点的原始参考图。

当前状态

三期处于范围规划阶段，当前开工结论为 NO-GO。当前以原型图片中的“完成国内出仓，等待装船”为阶段终点。动作依赖与并行关系、排柜规则、PDA 设备、拖车协作、柜封照片清单、报关回执及放行门禁、港务/船期信息范围和来源仍需在启动前确认。产品和业务完成确认后先进入契约与任务准备，六项开工准入全部通过后再进入全面功能开发；通过准入也不授权引入真实租户层。