一期/一期头程订单闭环设计.md

@@ -2,7 +2,7 @@
 
 > 状态：产品决策已确认，前端静态闭环实施中  
 > 创建日期：2026-07-28  
-> 适用范围：`apps/client-web`、`apps/admin-web`、`packages/shared`、`services/api`
+> 适用范围：`apps/client-web`、`apps/admin-web`、`baiyue-firstleg`
 
 ## 一、目标
 
@@ -91,7 +91,7 @@
 | `COMPLETED` | 已完成 | 一期订单履约结束 |
 | `CANCELLED` | 已取消 | 客户或平台按规则取消 |
 
-该方案与当前管理后台实现最接近。`packages/shared` 现有“处理中”以及旧架构文档中的“已确认、已报关、到港待提”不作为一期并存状态；产品确认后统一迁移。
+该方案与当前管理后台实现最接近。两个前端应用内 `shared/` 现有“处理中”以及旧架构文档中的“已确认、已报关、到港待提”不作为一期并存状态；产品确认后分别迁移。
 
 ### 允许的状态转换
 
@@ -346,8 +346,8 @@
 ## 九、实施顺序
 
 1. 将已确认的注册、企业资料审核、订单修改和基础资料规则冻结为接口契约。
-2. 将稳定订单状态、企业资料审核状态、运输方式、基础资料和订单快照模型统一到 `packages/shared`。
-3. 在 `services/api` 初始化后定义企业资料审核、订单、收货仓、快递公司和往来单位 OpenAPI，并以服务端状态机和权限校验作为唯一业务规则来源。
+2. 以 Java Controller、DTO 和 OpenAPI 为跨端契约来源，在 Admin、Client 各自应用内 `shared/` 和 API 适配层维护前端映射。
+3. 在 `baiyue-firstleg` 定义企业资料审核、订单、收货仓、快递公司和往来单位接口，并以服务端状态机和权限校验作为唯一业务规则来源。
 4. 实现后台基础资料维护、快递公司/往来单位批量导入和企业客户端往来单位只读查询。
 5. 实现客户工作台订单列表、创建和详情页面，静态阶段通过 API 适配层提供可替换数据源。
 6. 将管理后台订单 Pinia 模拟操作迁移到同一 API 契约，并接入履约快递信息。

三期/三期开发规划.md

@@ -222,7 +222,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 - 弱网、断网、前后台切换、重复提交和换班清理。
 - 真实设备、扫描头和发布方式确认前，不绑定厂商 SDK。
 
-### 服务端 `services/api`
+### 服务端 `baiyue-firstleg`
 
 - 最终保证身份、租户、仓库数据范围、权限、状态、门禁、幂等、并发和审计。
 - 管理出仓、排柜、订舱、拖车、拣货、装柜、报关和时间线的事务边界。