优化

src/modules/overseas-business/api/contracts.ts

@@ -0,0 +1,31 @@
+import type {
+  LocalLooseboardOrder,
+  LocalTransportOrder,
+  LocalTransportQuery,
+  OverseasBusinessPage,
+  OverseasPurchaseOrder,
+  OverseasPurchaseQuery,
+  SaveLocalLooseboardOrderRequest,
+  SaveLocalTransportOrderRequest,
+  UpdateOverseasPurchaseRequest,
+} from '../types'
+
+/**
+ * 海外区域 API 的前端边界。
+ *
+ * 当前仓库尚未冻结海外 API Base、Token 选择和端点路径，因此这里只保存
+ * 请求/响应形状，不创建 Axios 实例、不拼接临时 URL，也不提供模拟实现。
+ */
+export interface OverseasBusinessApi {
+  listPurchases(query: OverseasPurchaseQuery): Promise<OverseasBusinessPage<OverseasPurchaseOrder>>
+  getPurchase(purchaseId: string): Promise<OverseasPurchaseOrder>
+  updatePurchase(purchaseId: string, payload: UpdateOverseasPurchaseRequest): Promise<OverseasPurchaseOrder>
+  listTrucks(query: LocalTransportQuery): Promise<OverseasBusinessPage<LocalTransportOrder>>
+  getTruck(orderId: string): Promise<LocalTransportOrder>
+  createTruck(payload: SaveLocalTransportOrderRequest): Promise<LocalTransportOrder>
+  updateTruck(orderId: string, payload: SaveLocalTransportOrderRequest): Promise<LocalTransportOrder>
+  listLooseboards(query: LocalTransportQuery): Promise<OverseasBusinessPage<LocalLooseboardOrder>>
+  getLooseboard(orderId: string): Promise<LocalLooseboardOrder>
+  createLooseboard(payload: SaveLocalLooseboardOrderRequest): Promise<LocalLooseboardOrder>
+  updateLooseboard(orderId: string, payload: SaveLocalLooseboardOrderRequest): Promise<LocalLooseboardOrder>
+}