= [
+ {
+ title: '任务 / 订单',
+ minWidth: 230,
+ render: (_, row) => (
+
+ navigate(`/admin/tasks/${row.taskId}`)}>
+ {row.taskNo}
+
+ {row.platformOrderId}
+
+ ),
+ },
+ {
+ title: '商品',
+ minWidth: 210,
+ render: (_, row) => (
+
+ {row.skuName || '-'}
+ {row.skuCode || row.executorKey}
+
+ ),
+ },
+ {
+ title: '状态',
+ minWidth: 250,
+ render: (_, row) => (
+
+
+
+
+
+ ),
+ },
+ {
+ title: '角色',
+ minWidth: 180,
+ render: (_, row) => (
+
+ {row.roleName || '-'}
+ {row.roleId || row.loginType || '-'}
+
+ ),
+ },
+ {
+ title: '时间 / 异常',
+ minWidth: 220,
+ render: (_, row) => (
+
+ {formatAdminDateTime(row.updatedAt)}
+ {row.lastError || '-'}
+
+ ),
+ },
+ ]
+
+ function applyFilters(values: TaskFilterForm) {
+ setSearchParams(cleanParams({ ...values, page: 1, pageSize }))
+ }
+
+ function resetFilters() {
+ setSearchParams(cleanParams({ page: 1, pageSize }))
+ }
+
+ return (
+
+ )
+}
+
+function cleanParams(params: Record) {
+ const next = new URLSearchParams()
+ Object.entries(params).forEach(([key, value]) => {
+ const normalized = String(value ?? '').trim()
+ if (normalized) {
+ next.set(key, normalized)
+ }
+ })
+ return next
+}
diff --git a/apps/frontend-react/src/services/admin/audit-logs.ts b/apps/frontend-react/src/services/admin/audit-logs.ts
new file mode 100644
index 00000000..66030ebe
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/audit-logs.ts
@@ -0,0 +1,9 @@
+import { apiGet } from '@/lib/http'
+import type { AdminAuditLogItem, AdminPagination } from '@/types/admin'
+
+export function fetchAdminAuditLogs(params?: Record) {
+ return apiGet<{ items: AdminAuditLogItem[]; pagination: AdminPagination }>(
+ '/api/v1/admin/audit-logs',
+ params,
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/auth.ts b/apps/frontend-react/src/services/admin/auth.ts
new file mode 100644
index 00000000..aab2ddd1
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/auth.ts
@@ -0,0 +1,14 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type { AdminLoginResponse, AdminSessionSummary } from '@/types/admin'
+
+export function loginAdmin(payload: { username: string; password: string }) {
+ return apiPost('/api/v1/admin/auth/login', payload)
+}
+
+export function fetchAdminSession() {
+ return apiGet('/api/v1/admin/auth/session')
+}
+
+export function logoutAdmin() {
+ return apiPost<{ success: boolean }>('/api/v1/admin/auth/logout', {})
+}
diff --git a/apps/frontend-react/src/services/admin/dashboard.ts b/apps/frontend-react/src/services/admin/dashboard.ts
new file mode 100644
index 00000000..518d3902
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/dashboard.ts
@@ -0,0 +1,6 @@
+import { apiGet } from '@/lib/http'
+import type { AdminDashboardSummary } from '@/types/admin'
+
+export function fetchAdminDashboardSummary() {
+ return apiGet('/api/v1/admin/dashboard/summary')
+}
diff --git a/apps/frontend-react/src/services/admin/index.ts b/apps/frontend-react/src/services/admin/index.ts
new file mode 100644
index 00000000..99c97f94
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/index.ts
@@ -0,0 +1,7 @@
+export * from './auth'
+export * from './dashboard'
+export * from './users'
+export * from './audit-logs'
+export * from './platform-config'
+export * from './orders'
+export * from './tasks'
diff --git a/apps/frontend-react/src/services/admin/orders.ts b/apps/frontend-react/src/services/admin/orders.ts
new file mode 100644
index 00000000..02de9ed5
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/orders.ts
@@ -0,0 +1,13 @@
+import { apiGet } from '@/lib/http'
+import type { AdminOrderDetail, AdminOrderListItem, AdminPagination } from '@/types/admin'
+
+export function fetchAdminOrders(params?: Record) {
+ return apiGet<{ items: AdminOrderListItem[]; pagination: AdminPagination }>(
+ '/api/v1/admin/orders',
+ params,
+ )
+}
+
+export function fetchAdminOrderDetail(orderId: number | string) {
+ return apiGet(`/api/v1/admin/orders/${orderId}`)
+}
diff --git a/apps/frontend-react/src/services/admin/platform-config/cloudtentacles.ts b/apps/frontend-react/src/services/admin/platform-config/cloudtentacles.ts
new file mode 100644
index 00000000..30e5890a
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/cloudtentacles.ts
@@ -0,0 +1,336 @@
+import { apiDelete, apiGet, apiPost } from '@/lib/http'
+import type {
+ AdminCloudtentaclesLoginTestResult,
+ AdminCloudtentaclesDeliveryRecordListResult,
+ AdminCloudtentaclesOverrideRuleConfig,
+ AdminCloudtentaclesSkuListResult,
+ AdminCloudtentaclesSendSmsResult,
+ AdminCloudtentaclesSourceConfigResponse,
+ AdminCloudtentaclesSourceItem,
+ AdminCloudtentaclesSourcesConfig,
+ AdminCloudtentaclesValidateSessionResult,
+} from '@/types/admin'
+
+export function fetchAdminCloudtentaclesSourceConfig() {
+ return apiGet(
+ '/api/v1/admin/platform-config/cloudtentacles-source',
+ )
+}
+
+export function saveAdminCloudtentaclesSourceConfig(
+ payload:
+ | AdminCloudtentaclesSourcesConfig
+ | ({ sourceKey: string } & Partial),
+) {
+ return apiPost(
+ '/api/v1/admin/platform-config/cloudtentacles-source',
+ payload,
+ )
+}
+
+export function deleteAdminCloudtentaclesSource(sourceKey: string) {
+ return apiDelete<{ success: boolean }>(
+ `/api/v1/admin/platform-config/cloudtentacles-source/${sourceKey}`,
+ )
+}
+
+export function fetchAdminCloudtentaclesOverrideRules() {
+ return apiGet(
+ '/api/v1/admin/platform-config/cloudtentacles/override-rules',
+ )
+}
+
+export function saveAdminCloudtentaclesOverrideRules(
+ payload: {
+ enabled: boolean
+ rules: Array<{
+ id?: string
+ enabled?: boolean
+ productName?: string
+ sourceKey?: string
+ deliveryItems?: Array<{
+ cloudSkuId?: number
+ cloudSkuName?: string
+ quantity?: number
+ }>
+ notes?: string
+ }>
+ },
+) {
+ return apiPost(
+ '/api/v1/admin/platform-config/cloudtentacles/override-rules',
+ payload,
+ )
+}
+
+export function sendAdminCloudtentaclesSmsCode(payload: {
+ baseUrl?: string
+ username?: string
+ phone?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/cloudtentacles/send-sms-code',
+ payload,
+ )
+}
+
+export function testAdminCloudtentaclesLogin(payload: {
+ baseUrl?: string
+ username?: string
+ password?: string
+ phone?: string
+ code?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/cloudtentacles/test-login',
+ payload,
+ )
+}
+
+export function validateAdminCloudtentaclesSession(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/cloudtentacles/validate-session',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesAsset(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/asset',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesCategories(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/categories',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesSkuList(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/cloudtentacles/sku/list',
+ payload,
+ )
+}
+
+export function buyAdminCloudtentaclesSku(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ id?: number
+ count?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/sku/buy',
+ payload,
+ )
+}
+
+export function useAdminCloudtentaclesSku(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ id?: number
+ virtualNumberId?: number
+ phone?: string
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/sku/use',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesKnapsack(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/knapsack',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesDeliveryRecords(payload: {
+ sourceKey?: string
+ page?: number
+ size?: number
+ startDate?: string
+ endDate?: string
+ platformOrderId?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/cloudtentacles-records',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesRecordSources() {
+ return apiGet<{
+ sources: Array<{
+ key: string
+ label: string
+ enabled: boolean
+ hasToken: boolean
+ loggedInAt: string
+ }>
+ }>('/api/v1/admin/cloudtentacles-records/sources')
+}
+
+export function fetchAdminCloudtentaclesVnList(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/list',
+ payload,
+ )
+}
+
+export function appointAdminCloudtentaclesVn(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/appoint',
+ payload,
+ )
+}
+
+export function generateAdminCloudtentaclesVnLoginCode(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ id?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/generate-login-code',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesVnCode(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ phone?: string
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/fetch-code',
+ payload,
+ )
+}
+
+export function verifyAdminCloudtentaclesVnCode(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ id?: number
+ code?: string
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/verify-code',
+ payload,
+ )
+}
+
+export function fetchAdminCloudtentaclesBindUrl(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ id?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/bind-url',
+ payload,
+ )
+}
+
+export function backAdminCloudtentaclesVn(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ key?: string
+ id?: number
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/vn/back',
+ payload,
+ )
+}
+
+export function runAdminCloudtentaclesFullFlow(payload: {
+ baseUrl?: string
+ token?: string
+ deviceId?: string
+ deviceType?: number
+ skuId?: number
+ skuCount?: number
+ vnKey?: string
+ sourceKey?: string
+}) {
+ return apiPost>(
+ '/api/v1/admin/platform-config/cloudtentacles/debug/full-flow',
+ payload,
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/platform-config/index.ts b/apps/frontend-react/src/services/admin/platform-config/index.ts
new file mode 100644
index 00000000..9f73f850
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/index.ts
@@ -0,0 +1,6 @@
+export * from './notifications'
+export * from './scheduled-jobs'
+export * from './ninetyone'
+export * from './kuaishou-eticket'
+export * from './kuaishou-feifei'
+export * from './cloudtentacles'
diff --git a/apps/frontend-react/src/services/admin/platform-config/kuaishou-eticket.ts b/apps/frontend-react/src/services/admin/platform-config/kuaishou-eticket.ts
new file mode 100644
index 00000000..cd324b2e
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/kuaishou-eticket.ts
@@ -0,0 +1,60 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type {
+ AdminKuaishouEticketConsumeResult,
+ AdminKuaishouEticketDetailResult,
+ AdminKuaishouEticketShopInfoResult,
+ AdminKuaishouEticketSourceConfig,
+} from '@/types/admin'
+
+export function fetchAdminKuaishouEticketSourceConfig() {
+ return apiGet<{
+ filePath: string
+ source: AdminKuaishouEticketSourceConfig
+ }>('/api/v1/admin/platform-config/kuaishou-eticket-source')
+}
+
+export function saveAdminKuaishouEticketSourceConfig(payload: AdminKuaishouEticketSourceConfig) {
+ return apiPost<{
+ filePath: string
+ source: AdminKuaishouEticketSourceConfig
+ }>('/api/v1/admin/platform-config/kuaishou-eticket-source', payload)
+}
+
+export function queryAdminKuaishouEticketDetail(payload: {
+ baseUrl?: string
+ shopId?: string
+ cookie?: string
+ eTicketId: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-eticket/query-detail',
+ payload,
+ )
+}
+
+export function queryAdminKuaishouEticketShopInfo(payload: {
+ baseUrl?: string
+ shopId?: string
+ cookie?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-eticket/query-shop-info',
+ payload,
+ )
+}
+
+export function consumeAdminKuaishouEticket(payload: {
+ baseUrl?: string
+ shopId?: string
+ cookie?: string
+ eTicketId: string
+ oid?: string
+ formToken?: string
+ num?: number
+ storeId?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-eticket/consume',
+ payload,
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/platform-config/kuaishou-feifei.ts b/apps/frontend-react/src/services/admin/platform-config/kuaishou-feifei.ts
new file mode 100644
index 00000000..b5324f95
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/kuaishou-feifei.ts
@@ -0,0 +1,79 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type {
+ AdminKuaishouFeifeiConfig,
+ AdminKuaishouFeifeiConfigResponse,
+ AdminKuaishouFeifeiMatchResult,
+ AdminKuaishouFeifeiOrderResult,
+ AdminKuaishouFeifeiProductListResult,
+ AdminKuaishouFeifeiProductSyncResult,
+} from '@/types/admin'
+
+export function fetchAdminKuaishouFeifeiConfig() {
+ return apiGet(
+ '/api/v1/admin/platform-config/kuaishou-feifei',
+ )
+}
+
+export function saveAdminKuaishouFeifeiConfig(payload: AdminKuaishouFeifeiConfig) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-feifei',
+ payload,
+ )
+}
+
+export function matchAdminKuaishouFeifeiProduct(productName: string) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-feifei/match',
+ { productName },
+ )
+}
+
+export function fetchAdminKuaishouFeifeiProducts(payload: {
+ page?: number
+ perPage?: number
+ status?: string
+ supplyProductName?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-feifei/products',
+ payload,
+ )
+}
+
+export function syncAdminKuaishouFeifeiProducts(payload: {
+ status?: string
+ supplyProductName?: string
+} = {}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-feifei/sync-products',
+ payload,
+ )
+}
+
+export function createAdminKuaishouFeifeiTestOrder(payload: {
+ platformOrderNo: string
+ productCode: string
+ platformBuyNum?: number
+ platformAmount?: number | null
+ playerAccount?: string
+ playerGameRegion?: string
+ playerGameSrv?: string
+ playerGameRole?: string
+ submitPlayer?: boolean
+ notifyUrl?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-feifei/test-order',
+ payload,
+ )
+}
+
+export function queryAdminKuaishouFeifeiOrder(payload: {
+ platformOrderNo?: string
+ orderNo?: string
+}) {
+ return apiPost(
+ '/api/v1/admin/platform-config/kuaishou-feifei/query-order',
+ payload,
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/platform-config/ninetyone.ts b/apps/frontend-react/src/services/admin/platform-config/ninetyone.ts
new file mode 100644
index 00000000..c5ef2aeb
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/ninetyone.ts
@@ -0,0 +1,42 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type {
+ AdminNinetyoneOrderActionResult,
+ AdminNinetyoneOrderListResult,
+} from '@/types/admin'
+
+export function fetchAdminNinetyoneOrders(
+ params: {
+ page?: number
+ pageSize?: number
+ status?: string
+ } = {},
+) {
+ const searchParams = new URLSearchParams()
+ if (params.page) {
+ searchParams.set('page', String(params.page))
+ }
+ if (params.pageSize) {
+ searchParams.set('pageSize', String(params.pageSize))
+ }
+ if (params.status) {
+ searchParams.set('status', params.status)
+ }
+ const queryString = searchParams.toString()
+ return apiGet(
+ `/api/v1/admin/platform-config/ninetyone/orders${queryString ? `?${queryString}` : ''}`,
+ )
+}
+
+export function retryAdminNinetyoneOrder(orderId: number | string) {
+ return apiPost(
+ `/api/v1/admin/platform-config/ninetyone/orders/${orderId}/retry`,
+ {},
+ )
+}
+
+export function failAdminNinetyoneOrder(orderId: number | string, payload: { reason?: string }) {
+ return apiPost(
+ `/api/v1/admin/platform-config/ninetyone/orders/${orderId}/fail`,
+ payload,
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/platform-config/notifications.ts b/apps/frontend-react/src/services/admin/platform-config/notifications.ts
new file mode 100644
index 00000000..f5056037
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/notifications.ts
@@ -0,0 +1,23 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type { AdminNotificationConfig, AdminNotificationTestResult } from '@/types/admin'
+
+export function fetchAdminNotificationConfig() {
+ return apiGet<{
+ filePath: string
+ source: AdminNotificationConfig
+ }>('/api/v1/admin/platform-config/notifications')
+}
+
+export function saveAdminNotificationConfig(payload: AdminNotificationConfig) {
+ return apiPost<{
+ filePath: string
+ source: AdminNotificationConfig
+ }>('/api/v1/admin/platform-config/notifications', payload)
+}
+
+export function testAdminNotification(payload: { title?: string; body?: string; url?: string }) {
+ return apiPost(
+ '/api/v1/admin/platform-config/notifications/test',
+ payload,
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/platform-config/scheduled-jobs.ts b/apps/frontend-react/src/services/admin/platform-config/scheduled-jobs.ts
new file mode 100644
index 00000000..55089011
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/platform-config/scheduled-jobs.ts
@@ -0,0 +1,20 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type { AdminScheduledJobsConfig, AdminScheduledJobsResponse } from '@/types/admin'
+
+export function fetchAdminScheduledJobsConfig() {
+ return apiGet('/api/v1/admin/platform-config/scheduled-jobs')
+}
+
+export function saveAdminScheduledJobsConfig(payload: AdminScheduledJobsConfig) {
+ return apiPost(
+ '/api/v1/admin/platform-config/scheduled-jobs',
+ payload,
+ )
+}
+
+export function runAdminScheduledJob(jobId: string) {
+ return apiPost<{
+ result: Record
+ runtime: AdminScheduledJobsResponse['runtime']
+ }>(`/api/v1/admin/platform-config/scheduled-jobs/${jobId}/run`, {})
+}
diff --git a/apps/frontend-react/src/services/admin/tasks.ts b/apps/frontend-react/src/services/admin/tasks.ts
new file mode 100644
index 00000000..4e715205
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/tasks.ts
@@ -0,0 +1,93 @@
+import { apiGet, apiGetBlob, apiPost } from '@/lib/http'
+import type {
+ AdminPagination,
+ AdminTaskActionResponse,
+ AdminTaskDetail,
+ AdminTaskListItem,
+} from '@/types/admin'
+
+export function fetchAdminTasks(params?: Record) {
+ return apiGet<{ items: AdminTaskListItem[]; pagination: AdminPagination }>(
+ '/api/v1/admin/tasks',
+ params,
+ )
+}
+
+export function fetchAdminTaskDetail(taskId: number | string) {
+ return apiGet(`/api/v1/admin/tasks/${taskId}`)
+}
+
+export function fetchAdminTaskScreenshot(taskId: number | string) {
+ return apiGetBlob(`/api/v1/admin/tasks/${taskId}/screenshot`)
+}
+
+export function retryAdminTask(taskId: number | string) {
+ return apiPost(`/api/v1/admin/tasks/${taskId}/retry`, {})
+}
+
+export function regenerateAdminTaskClaimLink(taskId: number | string) {
+ return apiPost(`/api/v1/admin/tasks/${taskId}/regenerate-claim-link`, {})
+}
+
+export function closeAdminTask(taskId: number | string) {
+ return apiPost(`/api/v1/admin/tasks/${taskId}/close`, {})
+}
+
+export function markAdminTaskManualReview(taskId: number | string) {
+ return apiPost(`/api/v1/admin/tasks/${taskId}/mark-manual-review`, {})
+}
+
+export function completeAdminTaskManualDispatch(
+ taskId: number | string,
+ payload: {
+ outcome: 'delivered' | 'failed'
+ resultMessage?: string
+ deliveryReference?: string
+ deliveredCredential?: string
+ },
+) {
+ return apiPost(
+ `/api/v1/admin/tasks/${taskId}/complete-manual-dispatch`,
+ payload,
+ )
+}
+
+export function prepareAdminTaskKuaishouCloudFulfillment(taskId: number | string) {
+ return apiPost(
+ `/api/v1/admin/tasks/${taskId}/kuaishou-cloud/prepare`,
+ {},
+ )
+}
+
+export function refreshAdminTaskKuaishouCloudRoleInfo(taskId: number | string) {
+ return apiPost(
+ `/api/v1/admin/tasks/${taskId}/kuaishou-cloud/refresh-role-info`,
+ {},
+ )
+}
+
+export function rebindAdminTaskKuaishouCloudRole(taskId: number | string) {
+ return apiPost(
+ `/api/v1/admin/tasks/${taskId}/kuaishou-cloud/rebind-role`,
+ {},
+ )
+}
+
+export function dispatchAdminTaskKuaishouCloudFulfillment(
+ taskId: number | string,
+ payload: {
+ ticketCode?: string
+ } = {},
+) {
+ return apiPost(
+ `/api/v1/admin/tasks/${taskId}/kuaishou-cloud/dispatch`,
+ payload,
+ )
+}
+
+export function returnNumberAdminTaskKuaishouCloudFulfillment(taskId: number | string) {
+ return apiPost(
+ `/api/v1/admin/tasks/${taskId}/kuaishou-cloud/return-number`,
+ {},
+ )
+}
diff --git a/apps/frontend-react/src/services/admin/users.ts b/apps/frontend-react/src/services/admin/users.ts
new file mode 100644
index 00000000..039a1ddb
--- /dev/null
+++ b/apps/frontend-react/src/services/admin/users.ts
@@ -0,0 +1,33 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type { AdminPagination, AdminUserListItem } from '@/types/admin'
+
+export function fetchAdminUsers(params?: Record) {
+ return apiGet<{ items: AdminUserListItem[]; pagination: AdminPagination }>(
+ '/api/v1/admin/users',
+ params,
+ )
+}
+
+export function createAdminUser(payload: {
+ username: string
+ password: string
+ role: string
+ status?: string
+}) {
+ return apiPost<{ user: AdminUserListItem }>('/api/v1/admin/users', payload)
+}
+
+export function updateAdminUserRole(userId: number | string, payload: { role: string }) {
+ return apiPost<{ user: AdminUserListItem }>(`/api/v1/admin/users/${userId}/role`, payload)
+}
+
+export function updateAdminUserStatus(userId: number | string, payload: { status: string }) {
+ return apiPost<{ user: AdminUserListItem }>(`/api/v1/admin/users/${userId}/status`, payload)
+}
+
+export function resetAdminUserPassword(userId: number | string, payload: { password: string }) {
+ return apiPost<{ user: AdminUserListItem }>(
+ `/api/v1/admin/users/${userId}/reset-password`,
+ payload,
+ )
+}
diff --git a/apps/frontend-react/src/services/claim.ts b/apps/frontend-react/src/services/claim.ts
new file mode 100644
index 00000000..e5b508c2
--- /dev/null
+++ b/apps/frontend-react/src/services/claim.ts
@@ -0,0 +1,27 @@
+import { apiGet, apiPost } from '@/lib/http'
+import type { ClaimDetailData } from '@/types/claim'
+
+export function fetchClaimDetail(token: string) {
+ return apiGet(`/api/v1/claim/${token}`)
+}
+
+export function verifyKuaishouCloudClaimTicket(
+ token: string,
+ payload: {
+ ticketCode: string
+ },
+) {
+ return apiPost(`/api/v1/claim/${token}/kuaishou-cloud/verify-ticket`, payload)
+}
+
+export function confirmKuaishouCloudClaimRole(token: string) {
+ return apiPost(`/api/v1/claim/${token}/kuaishou-cloud/confirm-role`, {})
+}
+
+export function rebindKuaishouCloudClaimRole(token: string) {
+ return apiPost(`/api/v1/claim/${token}/kuaishou-cloud/rebind-role`, {})
+}
+
+export function redeemKuaishouCloudClaim(token: string) {
+ return apiPost(`/api/v1/claim/${token}/kuaishou-cloud/redeem`, {})
+}
diff --git a/apps/frontend-react/src/styles/main.css b/apps/frontend-react/src/styles/main.css
new file mode 100644
index 00000000..d02360f0
--- /dev/null
+++ b/apps/frontend-react/src/styles/main.css
@@ -0,0 +1,195 @@
+:root {
+ color: #1f2937;
+ background: #f5f7fb;
+ font-synthesis: none;
+ text-rendering: optimizeLegibility;
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+}
+
+* {
+ box-sizing: border-box;
+}
+
+body {
+ margin: 0;
+ min-width: 320px;
+ min-height: 100vh;
+}
+
+button,
+input,
+textarea,
+select {
+ font: inherit;
+}
+
+.login-page {
+ min-height: 100vh;
+ display: grid;
+ place-items: center;
+ padding: 24px;
+ background:
+ linear-gradient(135deg, rgba(22, 119, 255, 0.1), rgba(19, 194, 194, 0.08)),
+ #f5f7fb;
+}
+
+.login-panel {
+ width: min(440px, 100%);
+ box-shadow: 0 18px 50px rgba(15, 23, 42, 0.12);
+}
+
+.login-heading {
+ margin-bottom: 24px;
+}
+
+.login-heading h1 {
+ margin: 8px 0 0;
+ font-size: 28px;
+}
+
+.eyebrow {
+ color: #1677ff;
+ font-weight: 700;
+ letter-spacing: 0;
+}
+
+.admin-shell {
+ min-height: 100vh;
+}
+
+.admin-sider {
+ border-right: 1px solid #edf0f5;
+ box-shadow: 4px 0 18px rgba(15, 23, 42, 0.04);
+ z-index: 2;
+}
+
+.admin-brand {
+ height: 64px;
+ display: grid;
+ align-content: center;
+ padding: 0 20px;
+ border-bottom: 1px solid #edf0f5;
+}
+
+.admin-brand strong {
+ color: #111827;
+ font-size: 18px;
+}
+
+.admin-brand span {
+ color: #6b7280;
+ font-size: 12px;
+}
+
+.admin-topbar {
+ height: 64px;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 0 20px;
+ border-bottom: 1px solid #edf0f5;
+}
+
+.admin-user {
+ margin-left: auto;
+}
+
+.admin-user-copy {
+ display: grid;
+ justify-items: end;
+ line-height: 1.3;
+}
+
+.admin-content {
+ padding: 20px;
+}
+
+.page-stack {
+ display: grid;
+ gap: 16px;
+}
+
+.page-header {
+ display: flex;
+ align-items: flex-start;
+ justify-content: space-between;
+ gap: 16px;
+}
+
+.page-title {
+ margin: 0 !important;
+}
+
+.page-description {
+ margin: 6px 0 0;
+ color: #6b7280;
+}
+
+.filter-form {
+ row-gap: 12px;
+}
+
+.cell-stack {
+ display: grid;
+ gap: 4px;
+}
+
+.muted {
+ color: #6b7280;
+}
+
+.json-preview {
+ max-height: 460px;
+ overflow: auto;
+ margin: 0;
+ padding: 14px;
+ border: 1px solid #edf0f5;
+ border-radius: 6px;
+ background: #0f172a;
+ color: #dbeafe;
+ font-size: 12px;
+ line-height: 1.6;
+}
+
+.empty-page {
+ min-height: 50vh;
+ display: grid;
+ place-items: center;
+}
+
+.route-loading {
+ min-height: 100vh;
+ display: grid;
+ place-items: center;
+}
+
+.full-width {
+ width: 100%;
+}
+
+.feedback-prompt p {
+ margin-top: 0;
+}
+
+@media (max-width: 900px) {
+ .admin-sider {
+ position: fixed !important;
+ left: 0;
+ top: 0;
+ bottom: 0;
+ height: 100vh;
+ }
+
+ .admin-content {
+ padding: 14px;
+ }
+
+ .admin-user-copy {
+ display: none;
+ }
+
+ .page-header {
+ display: grid;
+ }
+}
diff --git a/apps/frontend-react/src/types/admin/audit-logs.ts b/apps/frontend-react/src/types/admin/audit-logs.ts
new file mode 100644
index 00000000..d54fc10b
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/audit-logs.ts
@@ -0,0 +1,13 @@
+import type { AdminRole } from './auth'
+
+export interface AdminAuditLogItem {
+ logId: number
+ actorUserId: number
+ actorUsername: string
+ actorRole: AdminRole
+ action: string
+ targetType: string
+ targetId: string
+ payload: Record
+ createdAt: string
+}
diff --git a/apps/frontend-react/src/types/admin/auth.ts b/apps/frontend-react/src/types/admin/auth.ts
new file mode 100644
index 00000000..d9d23fc7
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/auth.ts
@@ -0,0 +1,22 @@
+export type AdminRole = 'admin' | 'operator' | 'support'
+export type AdminUserStatus = 'active' | 'disabled'
+
+export interface AdminLoginResponse {
+ token: string
+ expiresAt: string
+ user: {
+ userId: number
+ username: string
+ role: AdminRole
+ }
+}
+
+export interface AdminSessionSummary {
+ authenticated: boolean
+ expiresAt: string
+ user: {
+ userId: number
+ username: string
+ role: AdminRole
+ }
+}
diff --git a/apps/frontend-react/src/types/admin/common.ts b/apps/frontend-react/src/types/admin/common.ts
new file mode 100644
index 00000000..29821fba
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/common.ts
@@ -0,0 +1,5 @@
+export interface AdminPagination {
+ page: number
+ pageSize: number
+ total: number
+}
diff --git a/apps/frontend-react/src/types/admin/dashboard.ts b/apps/frontend-react/src/types/admin/dashboard.ts
new file mode 100644
index 00000000..7d666bf0
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/dashboard.ts
@@ -0,0 +1,7 @@
+export interface AdminDashboardSummary {
+ todayOrders: number
+ paidPendingClaim: number
+ claimingTasks: number
+ redeemedToday: number
+ abnormalTasks: number
+}
diff --git a/apps/frontend-react/src/types/admin/index.ts b/apps/frontend-react/src/types/admin/index.ts
new file mode 100644
index 00000000..db08037a
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/index.ts
@@ -0,0 +1,81 @@
+// Common types
+export type { AdminPagination } from './common'
+
+// Auth types
+export type { AdminRole, AdminUserStatus, AdminLoginResponse, AdminSessionSummary } from './auth'
+
+// Users types
+export type { AdminUserListItem } from './users'
+
+// Audit logs types
+export type { AdminAuditLogItem } from './audit-logs'
+
+// Dashboard types
+export type { AdminDashboardSummary } from './dashboard'
+
+// Orders types
+export type {
+ AdminOrderFulfillmentProgress,
+ AdminOrderListItem,
+ AdminOrderDetail,
+} from './orders'
+
+// Tasks types
+export type {
+ AdminTaskListItem,
+ AdminTaskOperations,
+ AdminTaskActionResponse,
+ AdminTaskDetail,
+} from './tasks'
+
+// Platform config types
+export type {
+ AdminNotificationBarkRecipient,
+ AdminNotificationWpushRecipient,
+ AdminNotificationConfig,
+ AdminNotificationSendResult,
+ AdminNotificationTestResult,
+ AdminCloudtentaclesMonitorAccount,
+ AdminScheduledJobAccountRuntime,
+ AdminScheduledJobCloudtentaclesAccount,
+ AdminScheduledJobItem,
+ AdminScheduledJobsConfig,
+ AdminScheduledJobRuntimeState,
+ AdminScheduledJobsResponse,
+ AdminNinetyoneOrderItem,
+ AdminNinetyoneOrderListResult,
+ AdminNinetyoneOrderActionResult,
+ AdminKuaishouEticketSourceConfig,
+ AdminKuaishouEticketShopConfigItem,
+ AdminKuaishouEticketShopInfoResult,
+ AdminKuaishouEticketDetailResult,
+ AdminKuaishouEticketConsumeResult,
+ AdminKuaishouFeifeiProductRule,
+ AdminKuaishouFeifeiConfig,
+ AdminKuaishouFeifeiEffectiveConfig,
+ AdminKuaishouFeifeiConfigResponse,
+ AdminKuaishouFeifeiProductSyncResult,
+ AdminKuaishouFeifeiProductMatch,
+ AdminKuaishouFeifeiMatchResult,
+ AdminKuaishouFeifeiProductItem,
+ AdminKuaishouFeifeiProductListResult,
+ AdminKuaishouFeifeiOrderResult,
+ AdminCloudtentaclesSourceItem,
+ AdminCloudtentaclesSourcesConfig,
+ AdminCloudtentaclesSourceConfigResponse,
+ AdminCloudtentaclesOverrideDeliveryItem,
+ AdminCloudtentaclesOverrideRule,
+ AdminCloudtentaclesOverrideRuleConfig,
+ AdminCloudtentaclesSessionsMap,
+ AdminCloudtentaclesSourceConfig,
+ AdminCloudtentaclesPersistedSession,
+ AdminCloudtentaclesSessionItem,
+ AdminCloudtentaclesSendSmsResult,
+ AdminCloudtentaclesSessionSummary,
+ AdminCloudtentaclesLoginTestResult,
+ AdminCloudtentaclesValidateSessionResult,
+ AdminCloudtentaclesSkuItem,
+ AdminCloudtentaclesSkuListResult,
+ AdminCloudtentaclesDeliveryRecordItem,
+ AdminCloudtentaclesDeliveryRecordListResult,
+} from './platform-config'
diff --git a/apps/frontend-react/src/types/admin/orders.ts b/apps/frontend-react/src/types/admin/orders.ts
new file mode 100644
index 00000000..c41d39aa
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/orders.ts
@@ -0,0 +1,72 @@
+import type { AdminTaskListItem } from './tasks'
+
+export interface AdminOrderFulfillmentProgress {
+ totalTaskCount: number
+ preparedTaskCount: number
+ completedTaskCount: number
+ resourceStatus: string
+ customerStatus: string
+}
+
+export interface AdminOrderListItem {
+ orderId: number
+ provider: string
+ platform: string
+ shopId: string
+ shopName: string
+ platformOrderId: string
+ orderStatus: string
+ payStatus: string
+ buyerId: string
+ buyerName: string
+ receiverContact: string
+ totalAmount: string
+ totalAmountFen: number
+ currency: string
+ paidAt: string | null
+ createdAt: string
+ updatedAt: string
+ itemCount: number
+ totalQuantity: number
+ itemSummary: string
+ taskCount: number
+ resourceStatus: string
+ customerStatus: string
+ preparedTaskCount: number
+ completedTaskCount: number
+}
+
+export interface AdminOrderDetail {
+ order: {
+ orderId: number
+ provider: string
+ platform: string
+ shopId: string
+ shopName: string
+ platformOrderId: string
+ orderStatus: string
+ payStatus: string
+ buyerId: string
+ buyerName: string
+ receiverContact: string
+ totalAmount: string
+ totalAmountFen: number
+ currency: string
+ paidAt: string | null
+ createdAt: string
+ updatedAt: string
+ itemSummary: string
+ rawPayload: Record
+ fulfillmentProgress: AdminOrderFulfillmentProgress
+ }
+ items: Array<{
+ orderItemId: number
+ skuCode: string
+ skuName: string
+ itemTitle: string
+ quantity: number
+ deliveryMode: string
+ spec: Record
+ }>
+ tasks: AdminTaskListItem[]
+}
diff --git a/apps/frontend-react/src/types/admin/platform-config/cloudtentacles.ts b/apps/frontend-react/src/types/admin/platform-config/cloudtentacles.ts
new file mode 100644
index 00000000..6442d35f
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/cloudtentacles.ts
@@ -0,0 +1,181 @@
+export interface AdminCloudtentaclesSourceItem {
+ key: string
+ label: string
+ enabled: boolean
+ baseUrl: string
+ username: string
+ password: string
+ phone: string
+ deviceId: string
+ deviceType: number
+}
+
+export interface AdminCloudtentaclesSourcesConfig {
+ enabled: boolean
+ sources: AdminCloudtentaclesSourceItem[]
+}
+
+export interface AdminCloudtentaclesPersistedSession {
+ token: string
+ tokenMasked: string
+ baseUrl: string
+ username: string
+ phoneMasked: string
+ loggedInAt: string
+ deviceId: string
+ deviceType: number
+ hasToken: boolean
+}
+
+export type AdminCloudtentaclesSessionItem = AdminCloudtentaclesPersistedSession
+
+export interface AdminCloudtentaclesSessionsMap {
+ [sourceKey: string]: AdminCloudtentaclesPersistedSession
+}
+
+export interface AdminCloudtentaclesSourceConfigResponse {
+ filePath: string
+ sessionFilePath: string
+ enabled: boolean
+ sources: AdminCloudtentaclesSourceItem[]
+ sessions: AdminCloudtentaclesSessionsMap
+}
+
+export interface AdminCloudtentaclesOverrideDeliveryItem {
+ cloudSkuId: number
+ cloudSkuName: string
+ quantity: number
+}
+
+export interface AdminCloudtentaclesOverrideRule {
+ id: string
+ enabled: boolean
+ productName: string
+ normalizedProductName: string
+ sourceKey: string
+ deliveryItems: AdminCloudtentaclesOverrideDeliveryItem[]
+ notes: string
+}
+
+export interface AdminCloudtentaclesOverrideRuleConfig {
+ filePath: string
+ enabled: boolean
+ rules: AdminCloudtentaclesOverrideRule[]
+}
+
+export interface AdminCloudtentaclesSendSmsResult {
+ baseUrl: string
+ username: string
+ phone: string
+ phoneMasked: string
+ sentAt: string
+ responseMessage: string
+}
+
+export interface AdminCloudtentaclesSessionSummary {
+ tokenMasked: string
+ permissionCount: number
+ permissions: string[]
+ persisted?: boolean
+}
+
+export interface AdminCloudtentaclesLoginTestResult {
+ baseUrl: string
+ username: string
+ phoneMasked: string
+ loggedInAt: string
+ responseMessage: string
+ token: string
+ session: AdminCloudtentaclesSessionSummary
+ userInfo: Record
+ asset: number
+}
+
+export interface AdminCloudtentaclesValidateSessionResult {
+ baseUrl: string
+ loggedInAt: string
+ session: AdminCloudtentaclesSessionSummary
+ userInfo: Record
+ asset: number
+}
+
+export interface AdminCloudtentaclesSkuItem {
+ id: number
+ categoriesId: number
+ name: string
+ description: string
+ image: string
+ inventory: number
+ price: number
+ listingTime: string
+ delistingTime: string
+ buyLimitMin: number
+ buyLimitMax: number
+ raw: Record
+}
+
+export interface AdminCloudtentaclesSkuListResult {
+ baseUrl: string
+ itemCount: number
+ items: AdminCloudtentaclesSkuItem[]
+ rawItems: Record[]
+}
+
+export interface AdminCloudtentaclesDeliveryRecordItem {
+ createdAt: string
+ recordId: string
+ virtualNumberId: number
+ userId: number
+ count: number
+ cdk: string
+ exchangeUrl: string
+ name: string
+ skuId: number
+ skuName: string
+ skuImage: string
+ phone: string
+ status: number
+ fulfillUser: string
+ operatorName: string
+ platformOrderId: string
+ taskId: number
+ taskNo: string
+ orderShopId: string
+ orderShopName: string
+ consumeShopId: string
+ consumeShopName: string
+ roleName: string
+ roleId: string
+ localTaskStatus: string
+ localDeliveryStatus: string
+ localDispatchStatus: string
+ localDispatchAt: string
+ localResultCode: string
+ localResultMessage: string
+ matchConfidence: string
+ raw: Record
+}
+
+export interface AdminCloudtentaclesDeliveryRecordListResult {
+ baseUrl: string
+ page: number
+ size: number
+ total: number
+ sourceKey?: string
+ queryStartDate?: string
+ queryEndDate?: string
+ localOrderMatched?: boolean
+ items: AdminCloudtentaclesDeliveryRecordItem[]
+ raw: Record
+}
+
+/** @deprecated Use AdminCloudtentaclesSourceItem + AdminCloudtentaclesSourcesConfig instead */
+export interface AdminCloudtentaclesSourceConfig {
+ enabled: boolean
+ baseUrl: string
+ username: string
+ password: string
+ phone: string
+ deviceId: string
+ deviceType: number
+}
diff --git a/apps/frontend-react/src/types/admin/platform-config/index.ts b/apps/frontend-react/src/types/admin/platform-config/index.ts
new file mode 100644
index 00000000..560c4c6d
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/index.ts
@@ -0,0 +1,65 @@
+export type {
+ AdminNotificationBarkRecipient,
+ AdminNotificationWpushRecipient,
+ AdminNotificationConfig,
+ AdminNotificationSendResult,
+ AdminNotificationTestResult,
+} from './notifications'
+
+export type {
+ AdminCloudtentaclesMonitorAccount,
+ AdminScheduledJobAccountRuntime,
+ AdminScheduledJobCloudtentaclesAccount,
+ AdminScheduledJobItem,
+ AdminScheduledJobsConfig,
+ AdminScheduledJobRuntimeState,
+ AdminScheduledJobsResponse,
+} from './scheduled-jobs'
+
+export type {
+ AdminNinetyoneOrderItem,
+ AdminNinetyoneOrderListResult,
+ AdminNinetyoneOrderActionResult,
+} from './ninetyone'
+
+export type {
+ AdminKuaishouEticketSourceConfig,
+ AdminKuaishouEticketShopConfigItem,
+ AdminKuaishouEticketShopInfoResult,
+ AdminKuaishouEticketDetailResult,
+ AdminKuaishouEticketConsumeResult,
+} from './kuaishou-eticket'
+
+export type {
+ AdminKuaishouFeifeiProductRule,
+ AdminKuaishouFeifeiConfig,
+ AdminKuaishouFeifeiEffectiveConfig,
+ AdminKuaishouFeifeiConfigResponse,
+ AdminKuaishouFeifeiProductSyncResult,
+ AdminKuaishouFeifeiProductMatch,
+ AdminKuaishouFeifeiMatchResult,
+ AdminKuaishouFeifeiProductItem,
+ AdminKuaishouFeifeiProductListResult,
+ AdminKuaishouFeifeiOrderResult,
+} from './kuaishou-feifei'
+
+export type {
+ AdminCloudtentaclesSourceItem,
+ AdminCloudtentaclesSourcesConfig,
+ AdminCloudtentaclesSourceConfigResponse,
+ AdminCloudtentaclesOverrideDeliveryItem,
+ AdminCloudtentaclesOverrideRule,
+ AdminCloudtentaclesOverrideRuleConfig,
+ AdminCloudtentaclesSessionsMap,
+ AdminCloudtentaclesSourceConfig,
+ AdminCloudtentaclesPersistedSession,
+ AdminCloudtentaclesSessionItem,
+ AdminCloudtentaclesSendSmsResult,
+ AdminCloudtentaclesSessionSummary,
+ AdminCloudtentaclesLoginTestResult,
+ AdminCloudtentaclesValidateSessionResult,
+ AdminCloudtentaclesSkuItem,
+ AdminCloudtentaclesSkuListResult,
+ AdminCloudtentaclesDeliveryRecordItem,
+ AdminCloudtentaclesDeliveryRecordListResult,
+} from './cloudtentacles'
diff --git a/apps/frontend-react/src/types/admin/platform-config/kuaishou-eticket.ts b/apps/frontend-react/src/types/admin/platform-config/kuaishou-eticket.ts
new file mode 100644
index 00000000..046bca9c
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/kuaishou-eticket.ts
@@ -0,0 +1,83 @@
+export interface AdminKuaishouEticketShopConfigItem {
+ shopId: string
+ kshopName: string
+ cookie: string
+ cookieMasked: string
+ hasCookie: boolean
+ userAvatar: string
+ enabled: boolean
+}
+
+export interface AdminKuaishouEticketSourceConfig {
+ enabled: boolean
+ baseUrl: string
+ shops: AdminKuaishouEticketShopConfigItem[]
+}
+
+export interface AdminKuaishouEticketShopInfoResult {
+ baseUrl: string
+ ok: boolean
+ result: number
+ errorMessage: string
+ requestId: string
+ shop: {
+ shopId: string
+ kshopName: string
+ userAvatar: string
+ settleStatus: number
+ hasCookie: boolean
+ }
+ raw: Record
+}
+
+export interface AdminKuaishouEticketDetailResult {
+ baseUrl: string
+ eTicketId: string
+ ok: boolean
+ alreadyConsumed: boolean
+ result: number
+ errorMessage: string
+ requestId: string
+ serverTimestamp: string
+ detail: {
+ uid: string
+ fulfillDetailId: string
+ sellerId: string
+ formToken: string
+ validEndTime: string
+ validStartTime: string
+ leftReverseCount: number
+ eTicketId: string
+ oid: string
+ totalCount: number
+ leftCount: number
+ status: string
+ } | null
+ goods: {
+ itemId: string
+ itemPicUrl: string
+ itemTitle: string
+ price: string
+ skuDesc: string
+ skuId: string
+ } | null
+ raw: Record
+}
+
+export interface AdminKuaishouEticketConsumeResult {
+ baseUrl: string
+ eTicketId: string
+ oid: string
+ formToken: string
+ num: number
+ storeId: string
+ ok: boolean
+ consumed: boolean
+ alreadyConsumed: boolean
+ result: number
+ errorMessage: string
+ requestId: string
+ serverTimestamp: string
+ detail: AdminKuaishouEticketDetailResult['detail']
+ raw: Record
+}
diff --git a/apps/frontend-react/src/types/admin/platform-config/kuaishou-feifei.ts b/apps/frontend-react/src/types/admin/platform-config/kuaishou-feifei.ts
new file mode 100644
index 00000000..ecea64ef
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/kuaishou-feifei.ts
@@ -0,0 +1,104 @@
+export interface AdminKuaishouFeifeiProductRule {
+ id: string
+ enabled: boolean
+ productName: string
+ normalizedProductName: string
+ productCode: string
+ skuName: string
+ notes: string
+}
+
+export interface AdminKuaishouFeifeiConfig {
+ enabled: boolean
+ baseUrl: string
+ appKey: string
+ appSecret: string
+ timeoutMs: number
+ notifyUrl: string
+ productRules: AdminKuaishouFeifeiProductRule[]
+}
+
+export interface AdminKuaishouFeifeiEffectiveConfig {
+ enabled: boolean
+ baseUrl: string
+ timeoutMs: number
+ notifyUrl: string
+ hasAppKey: boolean
+ hasAppSecret: boolean
+ productRuleCount: number
+}
+
+export interface AdminKuaishouFeifeiConfigResponse {
+ filePath: string
+ source: AdminKuaishouFeifeiConfig
+ effective: AdminKuaishouFeifeiEffectiveConfig
+}
+
+export interface AdminKuaishouFeifeiProductSyncResult extends AdminKuaishouFeifeiConfigResponse {
+ sync: {
+ productCount: number
+ ruleCount: number
+ status: string
+ supplyProductName: string
+ }
+}
+
+export interface AdminKuaishouFeifeiProductMatch {
+ matchMode: string
+ productName: string
+ normalizedProductName: string
+ productCode: string
+ skuName: string
+}
+
+export interface AdminKuaishouFeifeiMatchResult {
+ productName: string
+ normalizedProductName: string
+ matched: boolean
+ match: AdminKuaishouFeifeiProductMatch | null
+}
+
+export interface AdminKuaishouFeifeiProductItem {
+ productCode: string
+ name: string
+ channel: string
+ externalProductId: string
+ imageUrl: string
+ status: string
+ supplyStatus: string
+ supplyPricePoints: number
+ feePoints: number
+ unitCostPoints: number
+ maxOrderQuantity: number
+ salePricePoints: number | null
+ raw: Record
+}
+
+export interface AdminKuaishouFeifeiProductListResult {
+ items: AdminKuaishouFeifeiProductItem[]
+ total: number
+ page: number
+ perPage: number
+ raw: Record
+}
+
+export interface AdminKuaishouFeifeiOrderResult {
+ orderNo: string
+ platformOrderNo: string
+ productCode: string
+ productName: string
+ rechargeStatus: number
+ rechargeStatusLabel: string
+ pointsCharged: number
+ playerAccount: string
+ platformBuyNum: number
+ rechargeResultMessage: string
+ createdAt: string
+ updatedAt: string
+ rechargeFinishAt: string
+ h5: {
+ entryUrl: string
+ rechargeUrl: string
+ }
+ raw: Record
+}
diff --git a/apps/frontend-react/src/types/admin/platform-config/ninetyone.ts b/apps/frontend-react/src/types/admin/platform-config/ninetyone.ts
new file mode 100644
index 00000000..19df7c49
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/ninetyone.ts
@@ -0,0 +1,32 @@
+export interface AdminNinetyoneOrderItem {
+ orderId: number
+ orderNo: string
+ outTradeNo: string
+ orderStatus: string
+ payStatus: string
+ shopId: string
+ shopName: string
+ productNo: string
+ productName: string
+ buyNum: number
+ taskCount: number
+ failReason: string
+ createdAt: string
+ updatedAt: string
+ items: Array>
+}
+
+export interface AdminNinetyoneOrderListResult {
+ page: number
+ pageSize: number
+ total: number
+ items: AdminNinetyoneOrderItem[]
+}
+
+export interface AdminNinetyoneOrderActionResult {
+ orderId: number
+ orderNo: string
+ orderStatus: string
+ orderItemCount: number
+ taskCount: number
+}
diff --git a/apps/frontend-react/src/types/admin/platform-config/notifications.ts b/apps/frontend-react/src/types/admin/platform-config/notifications.ts
new file mode 100644
index 00000000..1a847acb
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/notifications.ts
@@ -0,0 +1,50 @@
+export interface AdminNotificationBarkRecipient {
+ id: string
+ name: string
+ deviceKey: string
+ deviceKeyMasked: string
+ enabled: boolean
+}
+
+export interface AdminNotificationWpushRecipient {
+ id: string
+ name: string
+ apiKey: string
+ apiKeyMasked: string
+ enabled: boolean
+}
+
+export interface AdminNotificationConfig {
+ enabled: boolean
+ channels: {
+ bark: {
+ enabled: boolean
+ serverUrl: string
+ recipients: AdminNotificationBarkRecipient[]
+ }
+ wpush: {
+ enabled: boolean
+ recipients: AdminNotificationWpushRecipient[]
+ }
+ }
+}
+
+export interface AdminNotificationSendResult {
+ channel: string
+ recipientId: string
+ recipientName: string
+ recipientKeyMasked: string
+ ok: boolean
+ status: number
+ errorMessage: string
+ response: unknown
+}
+
+export interface AdminNotificationTestResult {
+ enabled: boolean
+ channel: string
+ successCount: number
+ failedCount: number
+ skippedCount: number
+ results: AdminNotificationSendResult[]
+}
diff --git a/apps/frontend-react/src/types/admin/platform-config/scheduled-jobs.ts b/apps/frontend-react/src/types/admin/platform-config/scheduled-jobs.ts
new file mode 100644
index 00000000..5a0d82b1
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/platform-config/scheduled-jobs.ts
@@ -0,0 +1,74 @@
+export interface AdminScheduledJobCloudtentaclesAccount {
+ sourceKey: string
+ label: string
+ enabled: boolean
+ assetThreshold: number
+}
+
+export interface AdminScheduledJobItem {
+ id: string
+ type: string
+ enabled: boolean
+ intervalSeconds: number
+ cooldownSeconds: number
+ config: {
+ assetThreshold: number
+ accounts: AdminScheduledJobCloudtentaclesAccount[]
+ }
+}
+
+export interface AdminScheduledJobsConfig {
+ enabled: boolean
+ jobs: AdminScheduledJobItem[]
+}
+
+export interface AdminScheduledJobRuntimeState {
+ id: string
+ enabled: boolean
+ running: boolean
+ lastRunAt: string
+ lastFinishedAt: string
+ nextRunAt: string
+ lastStatus: string
+ lastMessage: string
+ lastAsset: number | null
+ lastThreshold: number | null
+ lastAccounts: AdminScheduledJobAccountRuntime[]
+ lastAccountCount: number
+ lastCheckedCount: number
+ lastOkCount: number
+ lastLowAssetCount: number
+ lastFailedCount: number
+ lastManual: boolean
+}
+
+export interface AdminScheduledJobAccountRuntime {
+ sourceKey: string
+ label: string
+ enabled: boolean
+ hasToken: boolean
+ ok: boolean
+ skipped: boolean
+ status: string
+ message: string
+ asset: number | null
+ threshold: number
+ checkedAt: string
+}
+
+export interface AdminCloudtentaclesMonitorAccount {
+ sourceKey: string
+ label: string
+ enabled: boolean
+ username: string
+ phoneMasked: string
+ hasToken: boolean
+ loggedInAt: string
+}
+
+export interface AdminScheduledJobsResponse {
+ filePath: string
+ source: AdminScheduledJobsConfig
+ runtime: AdminScheduledJobRuntimeState[]
+ cloudtentaclesAccounts: AdminCloudtentaclesMonitorAccount[]
+}
diff --git a/apps/frontend-react/src/types/admin/tasks.ts b/apps/frontend-react/src/types/admin/tasks.ts
new file mode 100644
index 00000000..20193cb5
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/tasks.ts
@@ -0,0 +1,223 @@
+export interface AdminTaskListItem {
+ taskId: number
+ taskNo: string
+ platformOrderId: string
+ skuCode: string
+ skuName: string
+ status: string
+ executorKey: string
+ deliveryStatus: string
+ resultCode: string
+ resultMessage: string
+ resourceStatus: string
+ customerStatus: string
+ loginType: string
+ roleName: string
+ roleId: string
+ runtimeSessionId: string
+ claimedAt: string | null
+ roleConfirmedAt: string | null
+ redeemedAt: string | null
+ retryCount: number
+ lastError: string
+ createdAt: string
+ updatedAt: string
+ claimToken: string
+ screenshotPath: string
+}
+
+export interface AdminTaskOperations {
+ canRetry: boolean
+ canRegenerateClaimLink: boolean
+ canClose: boolean
+ canMarkManualReview: boolean
+ canCompleteManualDispatch: boolean
+ canPrepareKuaishouCloudFulfillment: boolean
+ canRefreshKuaishouCloudRoleInfo: boolean
+ canRebindKuaishouCloudRole: boolean
+ canDispatchKuaishouCloudFulfillment: boolean
+ canReturnKuaishouCloudFulfillment: boolean
+ canViewSensitiveTaskData: boolean
+}
+
+export interface AdminTaskActionResponse {
+ task: {
+ taskId: number
+ taskNo: string
+ status: string
+ deliveryStatus: string
+ resultCode: string
+ resultMessage: string
+ primaryClaimTokenId: number | null
+ lastError: string
+ updatedAt: string
+ }
+ claimUrl?: string
+ token?: string
+}
+
+export interface AdminTaskDetail {
+ task: AdminTaskListItem
+ order: null | {
+ orderId: number
+ provider: string
+ platform: string
+ shopId: string
+ shopName: string
+ platformOrderId: string
+ payStatus: string
+ orderStatus: string
+ }
+ orderItem: null | {
+ orderItemId: number
+ skuCode: string
+ skuName: string
+ quantity: number
+ }
+ claimToken: null | {
+ primaryClaimTokenId: number
+ token: string
+ status: string
+ expiredAt: string
+ claimUrl: string
+ }
+ artifacts: Record
+ screenshotUrl: string
+ review: {
+ required: boolean
+ screenshotCapturedAt: string | null
+ roleId: string
+ roleName: string
+ }
+ redeemResolution: null | {
+ status: string
+ taskStatus: string
+ replacementCount: number
+ finishedAt: string | null
+ attempts: Array<{
+ attempt: number
+ codeMasked: string
+ credentialType: string
+ outcome: string
+ resultCode: string
+ resultMessage: string
+ }>
+ }
+ kuaishouCloudFulfillment: null | {
+ flowType: string
+ configId: string
+ internalSkuCode: string
+ internalSkuName: string
+ ticket: {
+ code: string
+ capturedAt: string | null
+ status: string
+ verifiedAt: string | null
+ goodsTitle: string
+ leftCount: number
+ }
+ binding: {
+ prepareStatus: string
+ cloudSourceKeys: string[]
+ cloudSourceLabels: string[]
+ resolvedSourceKey: string
+ resolvedSourceLabel: string
+ skuId: number
+ skuName: string
+ vnKey: string
+ vnId: number
+ vnPhone: string
+ bindUrl: string
+ bindPreparedAt: string | null
+ bindExpiresAt: string | null
+ bindProbeAt: string | null
+ bindProbeStatus: string
+ bindProbeMessage: string
+ }
+ role: {
+ status: string
+ name: string
+ rid: string
+ refreshedAt: string | null
+ errorMessage: string
+ rawInfo: Record | null
+ }
+ purchase: {
+ autoBuyEnabled: boolean
+ minAssetReserve: number
+ usedKnapsack: boolean
+ purchaseTriggered: boolean
+ assetBefore: number
+ assetAfter: number
+ purchaseAt: string | null
+ }
+ dispatch: {
+ status: string
+ dispatchAt: string | null
+ sendType: number
+ note: string
+ }
+ returnNumber: {
+ status: string
+ returnedAt: string | null
+ autoReturnEnabled: boolean
+ }
+ consume: {
+ status: string
+ shopId: string
+ shopName: string
+ autoConsumeEnabled: boolean
+ consumedAt: string | null
+ errorMessage: string
+ }
+ rebind: {
+ currentAttempt: number
+ history: Array<{
+ attempt: number
+ source: string
+ requestedAt: string | null
+ requestedBy: Record | null
+ status: string
+ errorMessage: string
+ oldBinding: {
+ vnKey: string
+ vnId: number
+ vnPhone: string
+ bindUrl: string
+ bindPreparedAt: string | null
+ bindExpiresAt: string | null
+ roleName: string
+ roleId: string
+ }
+ newBinding: null | {
+ vnKey: string
+ vnId: number
+ vnPhone: string
+ bindUrl: string
+ bindPreparedAt: string | null
+ bindExpiresAt: string | null
+ }
+ }>
+ }
+ notes: string
+ }
+ manualDispatch: null | {
+ outcome: string
+ deliveryReference: string
+ deliveredCredential: string
+ resultMessage: string
+ completedAt: string | null
+ completedBy: null | {
+ userId: number
+ username: string
+ role: string
+ }
+ }
+ events: Array<{
+ eventId: number
+ eventType: string
+ payload: Record
+ createdAt: string
+ }>
+ operations: AdminTaskOperations
+}
diff --git a/apps/frontend-react/src/types/admin/users.ts b/apps/frontend-react/src/types/admin/users.ts
new file mode 100644
index 00000000..7c5438a2
--- /dev/null
+++ b/apps/frontend-react/src/types/admin/users.ts
@@ -0,0 +1,10 @@
+import type { AdminRole, AdminUserStatus } from './auth'
+
+export interface AdminUserListItem {
+ userId: number
+ username: string
+ role: AdminRole
+ status: AdminUserStatus
+ createdAt: string
+ updatedAt: string
+}
diff --git a/apps/frontend-react/src/types/claim.ts b/apps/frontend-react/src/types/claim.ts
new file mode 100644
index 00000000..d1370129
--- /dev/null
+++ b/apps/frontend-react/src/types/claim.ts
@@ -0,0 +1,168 @@
+import type { KnownTaskStatus } from '@/domain/task-status'
+
+export type ClaimTokenStatus = 'active' | 'used' | 'expired' | 'revoked' | (string & {})
+
+export type ClaimTaskStatus = KnownTaskStatus | (string & {})
+
+export interface ClaimTaskInfo {
+ taskId: number
+ taskNo: string
+ status: ClaimTaskStatus
+ executorKey: string
+ requiresSupportReview: boolean
+ expiresAt: string | null
+ claimedAt: string | null
+ roleConfirmedAt: string | null
+ redeemedAt: string | null
+ loginType: string
+ lastError: string
+ runtimeSessionId: string
+}
+
+export interface ClaimOrderInfo {
+ orderId: number
+ platform: string
+ platformOrderId: string
+ payStatus: string
+ orderStatus: string
+ totalAmount: string
+ totalAmountFen: number
+ currency: string
+}
+
+export interface ClaimOrderItemInfo {
+ orderItemId: number
+ skuCode: string
+ skuName: string
+ quantity: number
+}
+
+export interface ClaimProductInfo {
+ title: string
+ skuCode: string
+ quantity: number
+ isBundle: boolean
+ items: Array<{
+ cloudSkuId: number
+ name: string
+ quantity: number
+ }>
+}
+
+export interface ClaimResultInfo {
+ resultCode: string
+ resultMessage: string
+ screenshotReady: boolean
+ screenshotUrl: string
+}
+
+export interface ClaimKuaishouCloudFlowInfo {
+ flowType: 'kuaishou_cloud'
+ shopId: string
+ shopName: string
+ guideImages: string[]
+ ticket: {
+ code: string
+ status: string
+ capturedAt: string | null
+ verifiedAt: string | null
+ goodsTitle: string
+ leftCount: number
+ }
+ binding: {
+ prepareStatus: string
+ cloudSourceKeys: string[]
+ resolvedSourceKey: string
+ skuId: number
+ skuName: string
+ vnKey: string
+ vnId: number
+ bindUrl: string
+ bindPreparedAt: string | null
+ bindExpiresAt: string | null
+ bindProbeAt: string | null
+ bindProbeStatus: string
+ bindProbeMessage: string
+ vnPhone: string
+ roleName: string
+ roleId: string
+ }
+ role: {
+ status: string
+ name: string
+ rid: string
+ refreshedAt: string | null
+ errorMessage: string
+ defaultName: string
+ defaultRid: string
+ defaultCapturedAt: string | null
+ defaultCaptureStatus: string
+ defaultErrorMessage: string
+ isDefaultRole: boolean
+ }
+ purchase: {
+ autoBuyEnabled: boolean
+ minAssetReserve: number
+ usedKnapsack: boolean
+ purchaseTriggered: boolean
+ assetBefore: number
+ assetAfter: number
+ purchaseAt: string | null
+ }
+ dispatch: {
+ status: string
+ dispatchAt: string | null
+ failedAt: string | null
+ failedStage: string
+ errorCode: string
+ errorMessage: string
+ note: string
+ }
+ returnNumber: {
+ status: string
+ returnedAt: string | null
+ }
+ consume: {
+ status: string
+ shopId: string
+ shopName: string
+ consumedAt: string | null
+ errorMessage: string
+ }
+ rebind?: {
+ currentAttempt: number
+ history: Array>
+ }
+}
+
+export interface ClaimKuaishouFeifeiFlowInfo {
+ flowType: 'kuaishou_feifei'
+ productCode: string
+ productName: string
+ platformOrderNo: string
+ orderNo: string
+ rechargeStatus: number
+ rechargeStatusLabel: string
+ rechargeResultMessage: string
+ claimUrl: string
+ consumeStatus: string
+ h5: {
+ entryUrl: string
+ rechargeUrl: string
+ }
+ lastSyncedAt: string | null
+}
+
+export interface ClaimDetailData {
+ tokenStatus: ClaimTokenStatus
+ claimUrl: string
+ flowType: 'kuaishou_cloud' | 'kuaishou_ct_assisted' | 'kuaishou_feifei' | (string & {})
+ task: ClaimTaskInfo
+ order: ClaimOrderInfo
+ orderItem: ClaimOrderItemInfo
+ product: ClaimProductInfo
+ session: unknown | null
+ kuaishouCloudFulfillment: ClaimKuaishouCloudFlowInfo | null
+ kuaishouFeifei: ClaimKuaishouFeifeiFlowInfo | null
+ result: ClaimResultInfo | null
+}
diff --git a/apps/frontend-react/src/utils/admin-auth.ts b/apps/frontend-react/src/utils/admin-auth.ts
new file mode 100644
index 00000000..cbb374e6
--- /dev/null
+++ b/apps/frontend-react/src/utils/admin-auth.ts
@@ -0,0 +1,99 @@
+const ADMIN_TOKEN_KEY = 'order-site-admin-token'
+const ADMIN_EXPIRES_AT_KEY = 'order-site-admin-token-expires-at'
+const ADMIN_USER_ID_KEY = 'order-site-admin-user-id'
+const ADMIN_USERNAME_KEY = 'order-site-admin-username'
+const ADMIN_ROLE_KEY = 'order-site-admin-role'
+
+const ADMIN_ROLE_LEVEL: Record<'support' | 'operator' | 'admin', number> = {
+ support: 1,
+ operator: 2,
+ admin: 3,
+}
+
+export function getAdminToken() {
+ return localStorage.getItem(ADMIN_TOKEN_KEY) || ''
+}
+
+export function getAdminTokenExpiresAt() {
+ return localStorage.getItem(ADMIN_EXPIRES_AT_KEY) || ''
+}
+
+export function getAdminUserId() {
+ const value = Number(localStorage.getItem(ADMIN_USER_ID_KEY) || 0)
+ return Number.isFinite(value) && value > 0 ? value : 0
+}
+
+export function getAdminUsername() {
+ return localStorage.getItem(ADMIN_USERNAME_KEY) || ''
+}
+
+export function getAdminRole() {
+ const role = localStorage.getItem(ADMIN_ROLE_KEY)
+ if (role === 'admin' || role === 'operator' || role === 'support') {
+ return role
+ }
+
+ return 'support'
+}
+
+export function hasAdminRole(role: 'admin' | 'operator' | 'support') {
+ if (!hasAdminSession()) {
+ return false
+ }
+
+ return ADMIN_ROLE_LEVEL[getAdminRole()] >= ADMIN_ROLE_LEVEL[role]
+}
+
+export function setAdminSession(
+ token: string,
+ expiresAt: string,
+ user?: { userId: number; username: string; role: 'admin' | 'operator' | 'support' },
+) {
+ localStorage.setItem(ADMIN_TOKEN_KEY, token)
+ localStorage.setItem(ADMIN_EXPIRES_AT_KEY, expiresAt)
+
+ if (user?.userId) {
+ localStorage.setItem(ADMIN_USER_ID_KEY, String(user.userId))
+ }
+
+ if (user?.username) {
+ localStorage.setItem(ADMIN_USERNAME_KEY, user.username)
+ }
+
+ if (user?.role) {
+ localStorage.setItem(ADMIN_ROLE_KEY, user.role)
+ }
+}
+
+export function clearAdminSession() {
+ localStorage.removeItem(ADMIN_TOKEN_KEY)
+ localStorage.removeItem(ADMIN_EXPIRES_AT_KEY)
+ localStorage.removeItem(ADMIN_USER_ID_KEY)
+ localStorage.removeItem(ADMIN_USERNAME_KEY)
+ localStorage.removeItem(ADMIN_ROLE_KEY)
+}
+
+export function hasAdminSession() {
+ const token = getAdminToken()
+ const expiresAt = getAdminTokenExpiresAt()
+
+ if (!token) {
+ return false
+ }
+
+ if (isExpired(expiresAt)) {
+ clearAdminSession()
+ return false
+ }
+
+ return true
+}
+
+function isExpired(expiresAt: string) {
+ if (!expiresAt) {
+ return false
+ }
+
+ const expiresAtMs = Date.parse(expiresAt)
+ return Number.isFinite(expiresAtMs) && expiresAtMs <= Date.now()
+}
diff --git a/apps/frontend-react/src/utils/admin-display.ts b/apps/frontend-react/src/utils/admin-display.ts
new file mode 100644
index 00000000..c579d923
--- /dev/null
+++ b/apps/frontend-react/src/utils/admin-display.ts
@@ -0,0 +1,135 @@
+export function formatStatusWithRaw(status: string, labelMap: Record = {}) {
+ const normalized = String(status || '').trim()
+
+ if (!normalized) {
+ return '-'
+ }
+
+ const key = normalized.toLowerCase()
+ const label = labelMap[key]
+
+ if (!label || label === normalized) {
+ return normalized
+ }
+
+ return `${label} (${normalized})`
+}
+
+export function formatAuditAction(action: string) {
+ const labelMap: Record = {
+ admin_user_created: '创建后台用户',
+ admin_user_role_updated: '修改用户角色',
+ admin_user_status_updated: '修改用户状态',
+ admin_user_password_reset: '重置用户密码',
+ task_regenerate_claim_link: '重发领取链接',
+ task_kuaishou_cloud_rebind_role: '换绑角色',
+ task_closed: '关闭任务',
+ task_mark_manual_review: '转人工处理',
+ task_complete_manual_dispatch: '完成人工履约',
+ platform_shop_config_updated: '更新店铺配置',
+ platform_fulfillment_config_updated: '更新履约配置',
+ }
+
+ return formatStatusWithRaw(action, labelMap)
+}
+
+export function formatAuditTargetType(targetType: string) {
+ const labelMap: Record = {
+ admin_user: '后台用户',
+ task: '交付任务',
+ platform_config: '平台配置',
+ }
+
+ return formatStatusWithRaw(targetType, labelMap)
+}
+
+export function formatTaskEventType(eventType: string) {
+ const labelMap: Record = {
+ manual_dispatch_completed: '人工履约已回写',
+ claim_redeem_code_used: '兑换码已使用',
+ claim_redeem_code_invalid: '兑换码错误',
+ claim_redeem_completed: '兑换链路完成',
+ kuaishou_cloud_rebind_requested: '发起角色换绑',
+ kuaishou_cloud_rebind_old_number_returned: '换绑旧号已退还',
+ kuaishou_cloud_rebind_prepared: '换绑资源已准备',
+ kuaishou_cloud_rebind_failed: '换绑失败',
+ }
+
+ return formatStatusWithRaw(eventType, labelMap)
+}
+
+export function formatRedeemOutcomeLabel(value: string) {
+ const normalized = String(value || '').trim()
+
+ switch (normalized) {
+ case 'success':
+ return '兑换成功'
+ case 'code_used':
+ return '兑换码已使用'
+ case 'code_invalid':
+ return '兑换码错误'
+ case 'captcha_rejected':
+ return '验证码错误'
+ case 'failed':
+ return '兑换失败'
+ default:
+ return normalized || '-'
+ }
+}
+
+export function formatRedeemResolutionStatus(value: string) {
+ return value === 'success' ? '已完成' : value === 'failed' ? '失败收口' : value || '-'
+}
+
+export function formatKuaishouRoleInfoLabel(value: string) {
+ const normalized = String(value || '').trim()
+
+ switch (normalized) {
+ case 'name':
+ return '角色名称'
+ case 'rid':
+ return '角色 ID'
+ default:
+ return normalized || '-'
+ }
+}
+
+export function formatTaskEventPayload(payload: Record) {
+ const parts = [
+ payload.outcome ? `结果 ${payload.outcome}` : '',
+ payload.resultCode ? `代码 ${payload.resultCode}` : '',
+ payload.resultMessage ? `说明 ${payload.resultMessage}` : '',
+ payload.codeMasked ? `凭据 ${payload.codeMasked}` : '',
+ payload.previousCodeMasked ? `旧码 ${payload.previousCodeMasked}` : '',
+ payload.nextCodeMasked ? `新码 ${payload.nextCodeMasked}` : '',
+ payload.ticketCodeMasked ? `卡券号 ${payload.ticketCodeMasked}` : '',
+ payload.vnId ? `虚拟号 #${payload.vnId}` : '',
+ payload.oldVnId ? `旧虚拟号 #${payload.oldVnId}` : '',
+ payload.vnPhoneMasked ? `号码 ${payload.vnPhoneMasked}` : '',
+ payload.oldVnPhoneMasked ? `旧号码 ${payload.oldVnPhoneMasked}` : '',
+ payload.oldRoleName ? `旧角色 ${payload.oldRoleName}` : '',
+ payload.oldRoleId ? `旧角色ID ${payload.oldRoleId}` : '',
+ payload.attempt ? `第 ${payload.attempt} 次` : '',
+ payload.bindUrl ? `绑定链接 ${payload.bindUrl}` : '',
+ payload.sendType ? `发送类型 ${payload.sendType}` : '',
+ payload.note ? `备注 ${payload.note}` : '',
+ payload.previousOutcome
+ ? `切换原因 ${formatRedeemOutcomeLabel(String(payload.previousOutcome || ''))}`
+ : '',
+ payload.deliveryReference ? `单号 ${payload.deliveryReference}` : '',
+ payload.platformOrderId ? `平台单 ${payload.platformOrderId}` : '',
+ payload.trigger ? `触发 ${payload.trigger}` : '',
+ payload.reason ? `原因 ${payload.reason}` : '',
+ payload.purchaseTriggered === true ? '已触发购买' : '',
+ payload.usedKnapsack === true ? '使用背包库存' : '',
+ payload.responseStatus ? `HTTP ${payload.responseStatus}` : '',
+ payload.requestId ? `请求 ${payload.requestId}` : '',
+ payload.errorMessage ? `错误 ${payload.errorMessage}` : '',
+ ].filter(Boolean)
+
+ if (parts.length > 0) {
+ return parts.join(' · ')
+ }
+
+ return JSON.stringify(payload || {})
+}
diff --git a/apps/frontend-react/src/utils/admin-options.ts b/apps/frontend-react/src/utils/admin-options.ts
new file mode 100644
index 00000000..5abb1c10
--- /dev/null
+++ b/apps/frontend-react/src/utils/admin-options.ts
@@ -0,0 +1,52 @@
+export const adminPayStatusOptions = [
+ { label: '全部', value: '' },
+ { label: '未支付', value: 'unpaid' },
+ { label: '已支付', value: 'paid' },
+ { label: '失败', value: 'failed' },
+ { label: '已退款', value: 'refunded' },
+]
+
+export const adminTaskStatusOptions = [
+ { label: '全部', value: '' },
+ { label: '待支付', value: 'pending_payment' },
+ { label: '已支付', value: 'paid' },
+ { label: '已生成链接', value: 'link_generated' },
+ { label: '已创建会话', value: 'claimed' },
+ { label: '已确认角色', value: 'role_confirmed' },
+ { label: '兑换中', value: 'redeeming' },
+ { label: '已兑换', value: 'redeemed' },
+ { label: '待重试', value: 'retry_pending' },
+ { label: '人工处理', value: 'manual_review' },
+ { label: '已过期', value: 'expired' },
+ { label: '已关闭', value: 'closed' },
+]
+
+export const adminUserRoleOptions = [
+ { label: '全部', value: '' },
+ { label: '管理员', value: 'admin' },
+ { label: '普通运营', value: 'operator' },
+ { label: '客服', value: 'support' },
+]
+
+export const adminUserStatusOptions = [
+ { label: '全部', value: '' },
+ { label: '生效中', value: 'active' },
+ { label: '已停用', value: 'disabled' },
+]
+
+export const adminAuditActionOptions = [
+ { label: '全部', value: '' },
+ { label: '创建后台用户', value: 'admin_user_created' },
+ { label: '修改用户角色', value: 'admin_user_role_updated' },
+ { label: '修改用户状态', value: 'admin_user_status_updated' },
+ { label: '重置用户密码', value: 'admin_user_password_reset' },
+ { label: '换绑角色', value: 'task_kuaishou_cloud_rebind_role' },
+ { label: '关闭任务', value: 'task_closed' },
+ { label: '转人工处理', value: 'task_mark_manual_review' },
+]
+
+export const adminAuditTargetTypeOptions = [
+ { label: '全部', value: '' },
+ { label: '后台用户', value: 'admin_user' },
+ { label: '交付任务', value: 'task' },
+]
diff --git a/apps/frontend-react/src/utils/admin-time.ts b/apps/frontend-react/src/utils/admin-time.ts
new file mode 100644
index 00000000..b3696153
--- /dev/null
+++ b/apps/frontend-react/src/utils/admin-time.ts
@@ -0,0 +1 @@
+export { formatDateTime as formatAdminDateTime } from '@/utils/date-time'
diff --git a/apps/frontend-react/src/utils/date-time.ts b/apps/frontend-react/src/utils/date-time.ts
new file mode 100644
index 00000000..1567b29f
--- /dev/null
+++ b/apps/frontend-react/src/utils/date-time.ts
@@ -0,0 +1,54 @@
+const ISO_DATE_TIME_PATTERN =
+ /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})?$/
+
+export function isIsoDateTimeString(value: unknown): value is string {
+ return typeof value === 'string' && ISO_DATE_TIME_PATTERN.test(value.trim())
+}
+
+export function formatDateTime(value: string | null | undefined, fallback = '-') {
+ const normalized = String(value || '').trim()
+
+ if (!normalized) {
+ return fallback
+ }
+
+ const date = new Date(normalized)
+
+ if (Number.isNaN(date.getTime())) {
+ return normalized.replace('T', ' ').replace('Z', '')
+ }
+
+ const year = date.getFullYear()
+ const month = String(date.getMonth() + 1).padStart(2, '0')
+ const day = String(date.getDate()).padStart(2, '0')
+ const hours = String(date.getHours()).padStart(2, '0')
+ const minutes = String(date.getMinutes()).padStart(2, '0')
+ const seconds = String(date.getSeconds()).padStart(2, '0')
+
+ return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`
+}
+
+export function normalizeDateTimeValue(value: unknown): unknown {
+ if (Array.isArray(value)) {
+ return value.map((item) => normalizeDateTimeValue(item))
+ }
+
+ if (value && typeof value === 'object') {
+ return Object.fromEntries(
+ Object.entries(value).map(([key, currentValue]) => [
+ key,
+ normalizeDateTimeValue(currentValue),
+ ]),
+ )
+ }
+
+ if (isIsoDateTimeString(value)) {
+ return formatDateTime(value, '')
+ }
+
+ return value
+}
+
+export function stringifyDisplayJson(value: unknown, space = 2) {
+ return JSON.stringify(normalizeDateTimeValue(value), null, space)
+}
diff --git a/apps/frontend-react/src/vite-env.d.ts b/apps/frontend-react/src/vite-env.d.ts
new file mode 100644
index 00000000..11f02fe2
--- /dev/null
+++ b/apps/frontend-react/src/vite-env.d.ts
@@ -0,0 +1 @@
+///
diff --git a/apps/frontend-react/tsconfig.app.json b/apps/frontend-react/tsconfig.app.json
new file mode 100644
index 00000000..8d75ae3c
--- /dev/null
+++ b/apps/frontend-react/tsconfig.app.json
@@ -0,0 +1,26 @@
+{
+ "compilerOptions": {
+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+ "target": "ES2022",
+ "useDefineForClassFields": true,
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
+ "allowJs": false,
+ "skipLibCheck": true,
+ "esModuleInterop": true,
+ "allowSyntheticDefaultImports": true,
+ "strict": true,
+ "ignoreDeprecations": "6.0",
+ "forceConsistentCasingInFileNames": true,
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+ "jsx": "react-jsx",
+ "baseUrl": ".",
+ "paths": {
+ "@/*": ["src/*"]
+ }
+ },
+ "include": ["src"]
+}
diff --git a/apps/frontend-react/tsconfig.json b/apps/frontend-react/tsconfig.json
new file mode 100644
index 00000000..1ffef600
--- /dev/null
+++ b/apps/frontend-react/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "files": [],
+ "references": [
+ { "path": "./tsconfig.app.json" },
+ { "path": "./tsconfig.node.json" }
+ ]
+}
diff --git a/apps/frontend-react/tsconfig.node.json b/apps/frontend-react/tsconfig.node.json
new file mode 100644
index 00000000..672c8363
--- /dev/null
+++ b/apps/frontend-react/tsconfig.node.json
@@ -0,0 +1,14 @@
+{
+ "compilerOptions": {
+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+ "target": "ES2023",
+ "lib": ["ES2023"],
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "allowSyntheticDefaultImports": true,
+ "strict": true,
+ "noEmit": true,
+ "types": ["node"]
+ },
+ "include": ["vite.config.ts"]
+}
diff --git a/apps/frontend-react/vite.config.ts b/apps/frontend-react/vite.config.ts
new file mode 100644
index 00000000..eae32342
--- /dev/null
+++ b/apps/frontend-react/vite.config.ts
@@ -0,0 +1,31 @@
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
+
+const currentDir = path.dirname(fileURLToPath(import.meta.url))
+const apiTarget = process.env.VITE_API_TARGET || 'http://127.0.0.1'
+
+export default defineConfig({
+ plugins: [react()],
+ resolve: {
+ alias: {
+ '@': path.resolve(currentDir, 'src'),
+ },
+ },
+ server: {
+ host: '0.0.0.0',
+ port: 5174,
+ proxy: {
+ '/api': {
+ target: apiTarget,
+ changeOrigin: true,
+ },
+ '/health': {
+ target: apiTarget,
+ changeOrigin: true,
+ },
+ },
+ },
+})