2026-08-19 16:45:51 +08:00
|
|
|
|
# 四期海外仓前端待补契约
|
|
|
|
|
|
|
2026-08-19 17:08:45 +08:00
|
|
|
|
第一批正式页面只冻结路由、权限、字段与操作承载方式。后端服务边界现已确认：浏览器请求统一进入 `gateway-overseas/`（RS256/JWKS，Audience=`lastleg-api`）；尾程订单、入仓计划、换标、产品/箱号快照和库存业务归 `lastleg-service/`；海外仓库、地址、能力、库位、实物托盘和资源锁归 `warehouse-overseas-service/`。国内 `warehouse/` 只维护“海外仓合作仓”公共主数据类型。
|
2026-08-19 16:45:51 +08:00
|
|
|
|
|
2026-08-19 17:08:45 +08:00
|
|
|
|
以下前端适配或页面级契约补齐前，页面不得用演示数据或本地成功提示替代真实调用：
|
|
|
|
|
|
|
|
|
|
|
|
- 统一认证/HTTP 层对海外 API Base、短时海外 Access Token 的存储、刷新和自动选择，以及与现有国内 `http` 客户端一致的错误处理；业务页面不得自行读写 Token，也不得把请求发往国内 `gateway/`、`firstleg/` 或 `warehouse/`。
|
2026-08-19 16:45:51 +08:00
|
|
|
|
- 尾程订单分页查询、详情、导入模板、批量导入、异步导出、批量转仓和入库计划接口；分页查询需明确“全部 / 待分配”页签的请求映射，以及出库单号、派送单号只读关联字段。
|
|
|
|
|
|
- 入库单分页查询、详情、创建、编辑、预约、智能排车接口，以及状态机、幂等键和操作权限。
|
|
|
|
|
|
- 库存汇总、分页查询、详情、库位库存、托盘箱号和进销存记录接口。
|
|
|
|
|
|
- 换标单分页、详情、创建、编辑/审核、文件上传与费用明细接口，以及状态机和幂等约定。
|
|
|
|
|
|
- 托盘分页、详情、创建、编辑接口，以及海外仓/FBA 仓候选、编码唯一性与占用状态约束。
|
|
|
|
|
|
- 箱号分页、详情、创建、编辑接口，以及产品/托盘/入库单关联校验；“已出库”只作为只读库存事实，本模块不承接出库动作。
|
|
|
|
|
|
- 产品分页、详情、创建、编辑接口，以及 SKU 唯一性、品类和包装尺寸精度约定。
|
|
|
|
|
|
- 四期权限资源在 IAM 初始化数据中的正式登记。前端暂按本模块 `permissions.ts` 的稳定编码装配。
|
|
|
|
|
|
- 所有分页响应、错误码、`requestId`/`traceId`、时间/金额精度和长整型 ID 字符串传输约定。
|
|
|
|
|
|
|
|
|
|
|
|
范围排除：海外仓出库、退货出库、海外派送和其他库存离仓接口。
|
|
|
|
|
|
|
2026-08-19 17:08:45 +08:00
|
|
|
|
`lastleg-service` 已提供尾程订单、入仓计划、库存查询等 Controller，`warehouse-overseas-service` 已提供平台海外仓、库位和托盘 Controller；接入时以这些服务的 Controller/DTO/OpenAPI 为准。当前 `types.ts` 只冻结原型派生的页面展示字段，不是海外 API DTO；不得据此推导未覆盖页面的分页包络、URL、请求参数、时间/金额精度或写接口。统一区域客户端和对应页面契约完成后再建立实际 API 适配层，并逐页替换空态数据源。
|
