优化

2026-08-19 17:08:45 +08:00
parent 65cd9ecefa
commit 033b5df6b6
8 changed files with 25 additions and 18 deletions
@@ -1,14 +1,17 @@
 # 海外业务待补契约

-当前仓库尚未提供海外区域 API Base、海外 Token 选择器或海外采购/本土运输正式端点。模块因此只冻结 TypeScript 请求/响应模型和页面结构，不创建临时 URL，不使用示例数据，也不模拟提交成功。
+后端服务边界已经确认：浏览器统一经 `gateway-overseas/`（Audience=`lastleg-api`）访问 `lastleg-service/`；海外采购进入 `procurement/`，本土卡车进入 `trucking/`，本土散板进入该服务的独立稳定子域。现有平台采购与美国卡车 Controller 是接口适配事实来源，不得将这些请求接到国内 `gateway/`、`firstleg/` 或 `warehouse/`。
+
+模块当前仍只冻结 TypeScript 请求/响应模型和页面结构；在统一海外 Base/Token 选择与页面 DTO 适配完成前，不创建临时 URL，不使用示例数据，也不模拟提交成功。

 后端接入前需冻结：

- 海外 Gateway Base 与统一认证层的海外 Token 选择方式；
- 采购订单、卡车订单、散板订单的列表、详情、创建与更新端点；
+- 统一认证层对海外 Gateway Base 与短时海外 Token 的自动选择方式；
+- 将采购订单映射到 `lastleg-service` 的 `/api/platform/v1/last-leg/overseas-procurements`，将卡车订单映射到 `/api/platform/v1/last-leg/us-truck-orders`，并补齐当前 Admin 原型所需动作与 DTO；
+- 本土散板的正式平台端点及 DTO；
 - 分页信封、长整型 ID 字符串透传、金额/币种精度和时间格式；
 - 状态机、允许编辑状态、乐观锁版本、幂等键及错误码；
 - 客户、采购仓库等只读候选接口与权限；
 - 对应 `list/create/edit` 权限资源在海外服务端的鉴权落点。

-接入时应在统一双区域 HTTP/认证层完成 Base 与 Token 选择，业务页面不得自行读写 Token 或创建第二套登录。
+接入时应在统一双区域 HTTP/认证层完成 Base 与 Token 选择，业务页面不得自行读写 Token、创建第二套登录或绕回国内 Gateway。
@@ -13,8 +13,9 @@ import type {
 /**
 * 海外区域 API 的前端边界。
 *
- * 当前仓库尚未冻结海外 API Base、Token 选择和端点路径，因此这里只保存
- * 请求/响应形状，不创建 Axios 实例、不拼接临时 URL，也不提供模拟实现。
+ * 服务边界固定为 gateway-overseas -> lastleg-service。当前统一海外 Base/Token
+ * 选择以及部分页面端点/DTO 尚未完成适配，因此这里只保存请求/响应形状，
+ * 不创建模块级 Axios 实例、不拼接临时 URL，也不提供模拟实现。
 */
 export interface OverseasBusinessApi {
  listPurchases(query: OverseasPurchaseQuery): Promise<OverseasBusinessPage<OverseasPurchaseOrder>>
@@ -5,7 +5,7 @@ withDefaults(defineProps<{ domain: string; compact?: boolean }>(), { compact: fa
 <template>
  <el-alert class="contract-pending" type="warning" :closable="false" show-icon>
    <template #title>{{ domain }}海外区域接口待接入</template>
-    <p v-if="!compact">页面已按四期原型冻结字段与承载方式；海外 API Base、Token 选择和正式端点补齐前，不展示演示数据，也不会模拟查询或写入成功。</p>
+    <p v-if="!compact">后端边界已固定为 gateway-overseas → lastleg-service；统一海外 Base/Token 选择及本页面端点、DTO 与权限适配完成前，不展示演示数据，也不会模拟查询或写入成功。</p>
  </el-alert>
 </template>