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

src/api/platformExpressCompanies.ts

@@ -0,0 +1,100 @@
+import { http, unwrapApiResponse, type ApiEnvelope } from '@/api/http'
+
+export type PlatformExpressCompanyStatus = 'ACTIVE' | 'INACTIVE'
+
+export interface PlatformExpressCompanyResource {
+  id: number | string
+  tenantId: number | string
+  companyCode: string
+  companyName: string
+  servicePhone: string | null
+  website: string | null
+  trackingUrlTemplate: string | null
+  status: PlatformExpressCompanyStatus
+  remark: string | null
+  createdAt?: string | null
+  updatedAt?: string | null
+}
+
+export interface PlatformExpressCompanyPage {
+  records: PlatformExpressCompanyResource[]
+  page: number
+  size: number
+  total: number
+  pages: number
+}
+
+export interface SavePlatformExpressCompanyRequest {
+  companyCode: string
+  companyName: string
+  servicePhone: string | null
+  website: string | null
+  trackingUrlTemplate: string | null
+  status: PlatformExpressCompanyStatus
+  remark: string | null
+}
+
+const basePath = '/platform/v1/express-companies'
+
+export async function listPlatformExpressCompanies(
+  tenantId: number,
+  page = 1,
+  size = 20,
+  keyword = '',
+  status: PlatformExpressCompanyStatus | '' = '',
+) {
+  const response = await http.get<ApiEnvelope<PlatformExpressCompanyPage>, ApiEnvelope<PlatformExpressCompanyPage>>(basePath, {
+    params: {
+      tenantId,
+      page,
+      size,
+      keyword: keyword.trim() || undefined,
+      status: status || undefined,
+    },
+  })
+  const result = unwrapApiResponse(response)
+  return {
+    ...result,
+    page: Number(result.page),
+    size: Number(result.size),
+    total: Number(result.total),
+    pages: Number(result.pages),
+  }
+}
+
+export async function getPlatformExpressCompany(tenantId: number, id: number | string) {
+  const response = await http.get<ApiEnvelope<PlatformExpressCompanyResource>, ApiEnvelope<PlatformExpressCompanyResource>>(
+    `${basePath}/${id}`,
+    { params: { tenantId } },
+  )
+  return unwrapApiResponse(response)
+}
+
+export async function createPlatformExpressCompany(tenantId: number, payload: SavePlatformExpressCompanyRequest) {
+  const response = await http.post<ApiEnvelope<number | string>, ApiEnvelope<number | string>>(basePath, payload, {
+    params: { tenantId },
+  })
+  return unwrapApiResponse(response)
+}
+
+export async function updatePlatformExpressCompany(
+  tenantId: number,
+  id: number | string,
+  payload: SavePlatformExpressCompanyRequest,
+) {
+  const response = await http.put<ApiEnvelope<null>, ApiEnvelope<null>>(`${basePath}/${id}`, payload, {
+    params: { tenantId },
+  })
+  return unwrapApiResponse(response)
+}
+
+export async function changePlatformExpressCompanyStatus(
+  tenantId: number,
+  id: number | string,
+  status: PlatformExpressCompanyStatus,
+) {
+  const response = await http.patch<ApiEnvelope<null>, ApiEnvelope<null>>(`${basePath}/${id}/status`, { status }, {
+    params: { tenantId },
+  })
+  return unwrapApiResponse(response)
+}