This commit is contained in:
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。