feat: add overseas warehouse location management

src/modules/overseas-warehouse/api/locations.ts

@@ -0,0 +1,64 @@
+import { overseasHttp } from '@/shared/api/overseasHttp'
+import { unwrapApiResponse, type ApiEnvelope } from '@/shared/api/http'
+import { normalizeOverseasPage, type OverseasPagePayload } from './lastMileOrders'
+
+export type OverseasLocationType = 'VIRTUAL' | 'NORMAL' | 'SHARED_OVERFLOW'
+export type OverseasLocationStatus = 'ACTIVE' | 'IDLE' | 'OCCUPIED' | 'INACTIVE' | 'DISABLED'
+
+export interface OverseasLocationDto {
+  id: string
+  warehouseId: string
+  warehouseCode?: string | null
+  warehouseName?: string | null
+  zoneCode: string
+  zoneName?: string | null
+  locationCode: string
+  locationName?: string | null
+  locationType: OverseasLocationType
+  sharedOverflow: boolean
+  status: OverseasLocationStatus
+  maxLoadKg?: number | string | null
+  occupiedPalletCount?: number | null
+  version: number
+  remark?: string | null
+  createdAt?: string | null
+  updatedAt?: string | null
+}
+
+export interface SaveOverseasLocationPayload {
+  zoneCode: string
+  locationCode: string
+  locationType: 'NORMAL'
+  maxLoadKg: number
+  status: 'ACTIVE' | 'INACTIVE'
+  remark?: string | null
+}
+
+export interface OverseasLocationQuery { page?: number; size?: number; zoneCode?: string; keyword?: string; locationType?: OverseasLocationType | ''; status?: OverseasLocationStatus | '' }
+
+function base(warehouseId: string) { return `/platform/v1/warehouse-admin/${encodeURIComponent(warehouseId)}/locations` }
+
+export async function listOverseasLocations(warehouseId: string, query: OverseasLocationQuery = {}) {
+  const response = await overseasHttp.get<ApiEnvelope<OverseasPagePayload<OverseasLocationDto>>, ApiEnvelope<OverseasPagePayload<OverseasLocationDto>>>(base(warehouseId), { params: { page: query.page ?? 1, size: query.size ?? 20, ...query } })
+  return normalizeOverseasPage(unwrapApiResponse(response))
+}
+
+export async function createOverseasLocation(warehouseId: string, payload: SaveOverseasLocationPayload) {
+  const response = await overseasHttp.post<ApiEnvelope<string>, ApiEnvelope<string>>(base(warehouseId), payload)
+  return unwrapApiResponse(response)
+}
+
+export async function updateOverseasLocation(warehouseId: string, locationId: string, payload: SaveOverseasLocationPayload & { version: number }) {
+  const response = await overseasHttp.put<ApiEnvelope<null>, ApiEnvelope<null>>(`${base(warehouseId)}/${encodeURIComponent(locationId)}`, payload)
+  return unwrapApiResponse(response)
+}
+
+export async function changeOverseasLocationStatus(warehouseId: string, locationId: string, payload: SaveOverseasLocationPayload & { version: number }) {
+  const response = await overseasHttp.put<ApiEnvelope<null>, ApiEnvelope<null>>(`${base(warehouseId)}/${encodeURIComponent(locationId)}`, payload)
+  return unwrapApiResponse(response)
+}
+
+export async function deleteOverseasLocation(warehouseId: string, locationId: string, version: number) {
+  const response = await overseasHttp.delete<ApiEnvelope<null>, ApiEnvelope<null>>(`${base(warehouseId)}/${encodeURIComponent(locationId)}`, { params: { version } })
+  return unwrapApiResponse(response)
+}