From 94ef079891bc0a2c47052e35595406e27f5a1258 Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Tue, 4 Aug 2026 15:41:54 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 一期/一期头程订单闭环设计.md | 8 ++++---- 三期/三期开发规划.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/一期/一期头程订单闭环设计.md b/一期/一期头程订单闭环设计.md index 424a8ab..49cdc0e 100644 --- a/一期/一期头程订单闭环设计.md +++ b/一期/一期头程订单闭环设计.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 契约,并接入履约快递信息。 diff --git a/三期/三期开发规划.md b/三期/三期开发规划.md index 9e7370a..7235a0d 100644 --- a/三期/三期开发规划.md +++ b/三期/三期开发规划.md @@ -222,7 +222,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片 - 弱网、断网、前后台切换、重复提交和换班清理。 - 真实设备、扫描头和发布方式确认前,不绑定厂商 SDK。 -### 服务端 `services/api` +### 服务端 `baiyue-firstleg` - 最终保证身份、租户、仓库数据范围、权限、状态、门禁、幂等、并发和审计。 - 管理出仓、排柜、订舱、拖车、拣货、装柜、报关和时间线的事务边界。