feat: 完成后台联调与通用列表组件

src/api/platformPartners.ts

@@ -0,0 +1,108 @@
+import { http, unwrapApiResponse, type ApiEnvelope } from '@/api/http'
+
+export type PlatformPartnerType = 'CUSTOMER' | 'SUPPLIER' | 'BOTH'
+export type PlatformPartnerStatus = 'ACTIVE' | 'INACTIVE'
+
+export interface PlatformPartnerResource {
+  id: number | string
+  tenantId: number | string
+  partnerCode: string
+  partnerName: string
+  partnerType: PlatformPartnerType
+  contactName: string
+  contactPhone: string
+  contactEmail: string | null
+  countryCode: string
+  province: string | null
+  city: string
+  district: string | null
+  addressLine: string
+  postalCode: string | null
+  status: PlatformPartnerStatus
+  createdAt?: string | null
+  updatedAt?: string | null
+}
+
+export interface PlatformPartnerPage {
+  records: PlatformPartnerResource[]
+  page: number
+  size: number
+  total: number
+  pages: number
+}
+
+type PlatformPartnerPagePayload = Omit<PlatformPartnerPage, 'page' | 'size' | 'total' | 'pages'> & {
+  page: number | string
+  size: number | string
+  total: number | string
+  pages: number | string
+}
+
+export interface PlatformPartnerQuery {
+  page: number
+  size: number
+  keyword?: string
+  type?: PlatformPartnerType
+  status?: PlatformPartnerStatus
+}
+
+export interface SavePlatformPartnerRequest {
+  partnerCode: string
+  partnerName: string
+  partnerType: PlatformPartnerType
+  contactName: string
+  contactPhone: string
+  contactEmail: string | null
+  countryCode: string
+  province: string | null
+  city: string
+  district: string | null
+  addressLine: string
+  postalCode: string | null
+  status: PlatformPartnerStatus
+}
+
+const basePath = '/platform/v1/partners'
+
+export async function listPlatformPartners(tenantId: number, query: PlatformPartnerQuery) {
+  const response = await http.get<ApiEnvelope<PlatformPartnerPagePayload>, ApiEnvelope<PlatformPartnerPagePayload>>(basePath, {
+    params: { tenantId, ...query },
+  })
+  const page = unwrapApiResponse(response)
+  return {
+    ...page,
+    page: Number(page.page),
+    size: Number(page.size),
+    total: Number(page.total),
+    pages: Number(page.pages),
+  }
+}
+
+export async function createPlatformPartner(tenantId: number, payload: SavePlatformPartnerRequest) {
+  const response = await http.post<ApiEnvelope<number | string>, ApiEnvelope<number | string>>(basePath, payload, {
+    params: { tenantId },
+  })
+  return unwrapApiResponse(response)
+}
+
+export async function updatePlatformPartner(
+  tenantId: number,
+  partnerId: number | string,
+  payload: SavePlatformPartnerRequest,
+) {
+  const response = await http.put<ApiEnvelope<null>, ApiEnvelope<null>>(`${basePath}/${partnerId}`, payload, {
+    params: { tenantId },
+  })
+  return unwrapApiResponse(response)
+}
+
+export async function changePlatformPartnerStatus(
+  tenantId: number,
+  partnerId: number | string,
+  status: PlatformPartnerStatus,
+) {
+  const response = await http.patch<ApiEnvelope<null>, ApiEnvelope<null>>(`${basePath}/${partnerId}/status`, { status }, {
+    params: { tenantId },
+  })
+  return unwrapApiResponse(response)
+}