Files
admin-web/src/modules/overseas-business/CONTRACT_GAPS.md
T
2026-08-20 09:10:36 +08:00

1.6 KiB

海外业务真实接口接入与剩余缺口

模块通过 @/shared/api/overseasHttp 访问海外 Gateway,业务路径只传 /platform/v1/...。页面不读取 Token、不调用兑换端点,也不感知区域 Base。已接入:

  • 海外采购列表、详情及服务端允许字段的 PATCH 编辑;
  • 本土卡车列表及详情数据(详情只用于原型既有编辑页的数据承载,不新增详情路由);
  • 长整型 ID、金额/重量/体积的字符串归一化,真实状态映射,以及加载、失败、重试和空态。

仍缺少或明确不接入:

  • 海外采购:后端详情只有出库记录,没有原型“进销存明细”所需的完整入库/余额流水;客户与采购仓库候选接口尚未冻结。平台 review 与 outbounds 不在本专项接入范围。
  • 本土卡车:平台端只有列表、详情、状态流转和收托盘,没有平台新增或普通编辑接口;新增/编辑提交继续明确阻断,不借用 Merchant、状态流转或收托盘端点。
  • 本土散板:lastleg-service 尚无独立稳定 Controller/DTO/OpenAPI,列表、新增、编辑均保持缺口,不借用卡车端点。
  • 权限:前端冻结为 platform:overseas-business:*,当前海外服务端采购和卡车管理权限分别为 lastleg:overseas-procurement:manage、lastleg:us-trucking:manage。冲突只记录,页面不绕过;由共享权限总控统一收口。

任何后续写接口都应继续以海外服务 Controller、DTO、OpenAPI 和状态机为准,不发明路径、不模拟成功、不连接国内 Gateway。