refactor(admin): migrate data layer to V2 API response contract

- transformResponse unwraps the { data, meta? } envelope and lifts
  meta.pagination into { data, pagination }
- onResponseError reads the { error: { code, message } } body;
  BusinessError carries an optional code
- Pager becomes { page, size, total, totalPages }; ripple field
  renames through table, list views and pagination hooks
- enrichment-admin / search-admin keep local legacy pager types
  (those endpoints still emit the legacy pagination shape)
- drop the removed ?select= param from posts/notes/pages api + callers

Author: Innei

apps/admin/src/api/notes.ts

@@ -6,7 +6,6 @@ import { request } from '~/utils/request'
 export interface GetNotesParams {
   page?: number
   size?: number
-  select?: string
   sortBy?: string
   sortOrder?: number
   db_query?: Record<string, boolean>

apps/admin/src/api/pages.ts

@@ -6,7 +6,6 @@ import { request } from '~/utils/request'
 export interface GetPagesParams {
   page?: number
   size?: number
-  select?: string
 }
 
 export interface CreatePageData {

apps/admin/src/api/posts.ts

@@ -6,7 +6,6 @@ import { request } from '~/utils/request'
 export interface GetPostsParams {
   page?: number
   size?: number
-  select?: string
   sortBy?: string
   sortOrder?: number
   categoryIds?: string[]

apps/admin/src/components/table/index.tsx

@@ -123,9 +123,9 @@ export const Table = defineComponent({
             noPagination
               ? undefined
               : pager?.value && {
-                  page: pager.value.currentPage,
+                  page: pager.value.page,
                   pageSize: pager.value.size,
-                  pageCount: pager.value.totalPage,
+                  pageCount: pager.value.totalPages,
                   // showQuickJumper: ui.viewport.value.mobile ? false : true,
                   showQuickJumper: true,
                   pageSlot: ui.viewport.value.mobile

apps/admin/src/hooks/use-memo-fetch-data-list.ts

@@ -25,8 +25,8 @@ export const createMemoDataListFetchHook = <
       loading.value = false
       data.forEach((i) => idSet.add(i.id))
 
-      currentPage = pagination.currentPage
-      if (!pagination.hasNextPage) {
+      currentPage = pagination.page
+      if (pagination.page >= pagination.totalPages) {
         isEnd = true
       }
     }

apps/admin/src/models/base.ts

@@ -1,10 +1,8 @@
 export interface Pager {
-  total: number
+  page: number
   size: number
-  currentPage: number
-  totalPage: number
-  hasPrevPage: boolean
-  hasNextPage: boolean
+  total: number
+  totalPages: number
 }
 
 export interface PaginateResult<T> {

apps/admin/src/models/enrichment.ts

@@ -1,4 +1,11 @@
-import type { Pager } from './base'
+export interface LegacyPager {
+  total: number
+  size: number
+  currentPage: number
+  totalPage: number
+  hasPrevPage: boolean
+  hasNextPage: boolean
+}
 
 export interface EnrichmentImage {
   url: string
@@ -66,7 +73,7 @@ export interface EnrichmentRow {
 
 export interface EnrichmentListResponse {
   data: EnrichmentRow[]
-  pagination: Pager
+  pagination: LegacyPager
 }
 
 export interface EnrichmentScreenshotRow {
@@ -91,7 +98,7 @@ export interface EnrichmentScreenshotJoinedRow extends EnrichmentScreenshotRow {
 
 export interface EnrichmentScreenshotListResponse {
   data: EnrichmentScreenshotJoinedRow[]
-  pagination: Pager
+  pagination: LegacyPager
 }
 
 export interface EnrichmentScreenshotQuota {

apps/admin/src/models/search-index.ts

@@ -1,4 +1,11 @@
-import type { Pager } from './base'
+export interface SearchIndexLegacyPager {
+  total: number
+  size: number
+  currentPage: number
+  totalPage: number
+  hasPrevPage: boolean
+  hasNextPage: boolean
+}
 
 export type SearchIndexRefType = 'post' | 'note' | 'page'
 
@@ -32,7 +39,7 @@ export interface SearchDocumentAdminRow {
 
 export interface SearchDocumentAdminListResponse {
   data: SearchDocumentAdminRow[]
-  pagination: Pager
+  pagination: SearchIndexLegacyPager
 }
 
 export interface SearchDocumentAdminListParams {

apps/admin/src/utils/request.ts

@@ -2,11 +2,10 @@ import { ofetch } from 'ofetch'
 import { toast } from 'vue-sonner'
 import type { FetchOptions } from 'ofetch'
 
-import { simpleCamelcaseKeys } from './camelcase-keys'
-
 import { API_URL } from '~/constants/env'
 
 import { router } from '../router/router'
+import { simpleCamelcaseKeys } from './camelcase-keys'
 import { uuid } from './index'
 
 export class SystemError extends Error {
@@ -24,6 +23,7 @@ export class BusinessError extends Error {
     message: string | string[],
     public statusCode: number,
     public data?: unknown,
+    public code?: string | number,
   ) {
     super(Array.isArray(message) ? message.join(', ') : message)
     this.name = 'BusinessError'
@@ -73,10 +73,11 @@ export const $api = ofetch.create({
     }
 
     const data = response._data
-    const message = data?.message || '请求失败'
+    const message = data?.error?.message || data?.message || '请求失败'
+    const code = data?.error?.code
     const displayMsg = Array.isArray(message) ? message.join(', ') : message
     toast.error(displayMsg)
-    throw new BusinessError(message, status, data)
+    throw new BusinessError(message, status, data, code)
   },
 })
 
@@ -86,27 +87,31 @@ export type RequestOptions<T = unknown> = Omit<FetchOptions<'json'>, 'body'> & {
   bypassTransform?: boolean
 }
 
-/**
- * 转换响应数据
- * 1. camelCase 转换
- * 2. 解包后端包装的数组响应 { data: [...] } -> [...]
- */
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return !!value && typeof value === 'object' && !Array.isArray(value)
+}
+
+function isResponseEnvelope(value: unknown): value is Record<string, unknown> {
+  return (
+    isPlainObject(value) &&
+    'data' in value &&
+    Object.keys(value).every((key) => key === 'data' || key === 'meta')
+  )
+}
+
 function transformResponse<T>(data: unknown, bypass?: boolean): T {
   if (bypass || !data || typeof data !== 'object') {
     return data as T
   }
 
-  let result = simpleCamelcaseKeys(data as Record<string, unknown>)
+  const result = simpleCamelcaseKeys(data as Record<string, unknown>)
 
-  if (
-    result &&
-    typeof result === 'object' &&
-    !Array.isArray(result) &&
-    'data' in result &&
-    Array.isArray(result.data) &&
-    Object.keys(result).length === 1
-  ) {
-    result = result.data
+  if (isResponseEnvelope(result)) {
+    const meta = (result as any).meta
+    if (meta && isPlainObject(meta.pagination)) {
+      return { data: (result as any).data, pagination: meta.pagination } as T
+    }
+    return (result as any).data as T
   }
 
   return result as T

apps/admin/src/views/ai/components/article-selector-modal.tsx

@@ -115,15 +115,15 @@ export const ArticleSelectorModal = defineComponent({
           shouldFetchPosts
             ? hasKeyword
               ? searchApi.searchPosts({ keyword, size: 50 })
-              : postsApi.getList({ size: 50, select: 'title' })
+              : postsApi.getList({ size: 50 })
             : Promise.resolve({ data: [] }),
           shouldFetchNotes
             ? hasKeyword
               ? searchApi.searchNotes({ keyword, size: 50 })
-              : notesApi.getList({ size: 50, select: 'title' })
+              : notesApi.getList({ size: 50 })
             : Promise.resolve({ data: [] }),
           shouldFetchPages
-            ? pagesApi.getList({ select: 'title' })
+            ? pagesApi.getList({})
             : Promise.resolve({ data: [] }),
         ])