docs/一期/README.md

一期文档

一期目标是完成平台后台与企业客户端的真实业务基础，以及头程订单最小闭环。

当前主体模型

• 一期及后续未单独启用租户能力的阶段统一按“平台—客户”两级开发，当前是业务单租户、平台管理多客户、客户严格隔离。
• Java 与接口中的 tenant_id > 0、tenantId 当前表示客户 ID，是客户隔离兼容字段；tenant_id=0 是平台账号和平台 RBAC 的技术作用域，不是可管理租户。
• 历史表名、类名、接口路径和字段保留 tenant 命名，但不得据此新增租户主表、租户选择器、租户级权限或把现有字段改义为上级租户。

文档

• 一期开发进度表
• 一期头程订单闭环设计
• 虫虫出海一期开发进度表.xlsx：面向团队日常维护的 Excel 进度表。

原型来源

• 产品原型统一位于 docs/悦/。
• 企业登录与注册分别参考 docs/悦/合并/login.html、docs/悦/合并/register.html；一期只默认包含中文账号密码登录和基础企业注册闭环。
• 快递公司和往来单位参考 docs/悦/货代SAAS平台后台/货代SaaS平台原型.html 中“通用”菜单下的对应页面。
• 原型用于确认信息架构、字段和视觉方向；是否已进入当前 Vue 应用、是否具备完整交互与数据持久化，以一期开发进度表为准。

当前边界

• 平台后台：内部账号登录、客户及企业资料审核、内部用户、角色权限、平台收货仓、快递公司、往来单位和头程订单；工作台不作为一期交付项。
• 企业客户端：中文邮箱/手机号加密码登录、免审核企业注册、企业资料、成员角色权限、头程下单、订单列表和详情；企业资料经平台人工审核通过后才允许提交订单，一期不接短信/邮箱验证码及微信、企业微信登录。
• 服务端：认证、基于兼容字段 tenant_id 的客户隔离、权限、文件、基础资料、订单状态机、幂等和审计。
• 不包含工作台、部门/组织架构、完整 WMS、FBA/海外目的仓服务、在线报价、财务结算、完整报关清关、外部物流接口、多语言及微信/企业微信登录；快递公司和往来单位一期支持批量导入，不提供导出。