feat(frontend): 搭建桌面端基础界面与 Workspace

- App Shell 壳层：主导航、次导航、Title Bar、状态栏 - Vault 入口页：最近 Vault、打开/创建 Vault、AI Core 状态 - Workspace 与文件树：浏览、打开、创建笔记/文件夹 - Design Token：浅色/深色主题 CSS Variables - Contracts / Service / Store / Router 基础架构 - 统一 ApiClient 与 SseClient，对接后端 API 契约
2026-08-29 10:36:16 +08:00
parent 694c1b27c1
commit f9efc4f4a2
42 changed files with 8044 additions and 167 deletions
@@ -0,0 +1,102 @@
+import type { ApiError, ErrorResponse } from '@/contracts'
+
+const BASE_URL = import.meta.env.VITE_API_BASE || ''
+
+interface RequestOptions extends RequestInit {
+  params?: Record<string, string | number | boolean | undefined>
+  token?: string
+}
+
+export class ApiErrorClass extends Error {
+  code: string
+  details?: Record<string, unknown>
+
+  constructor(code: string, message: string, details?: Record<string, unknown>) {
+    super(message)
+    this.name = 'ApiError'
+    this.code = code
+    this.details = details
+  }
+}
+
+async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {
+  const { params, token, headers, ...rest } = options
+
+  let url = path.startsWith('http') ? path : `${BASE_URL}${path}`
+
+  if (params) {
+    const usp = new URLSearchParams()
+    Object.entries(params).forEach(([k, v]) => {
+      if (v !== undefined && v !== null) usp.append(k, String(v))
+    })
+    const qs = usp.toString()
+    if (qs) url += `?${qs}`
+  }
+
+  const reqHeaders: Record<string, string> = {
+    'Content-Type': 'application/json',
+    ...(headers as Record<string, string>),
+  }
+
+  if (token) {
+    reqHeaders['Authorization'] = `Bearer ${token}`
+  }
+
+  const reqId = crypto.randomUUID()
+  reqHeaders['X-Request-Id'] = reqId
+
+  try {
+    const resp = await fetch(url, {
+      ...rest,
+      headers: reqHeaders,
+    })
+
+    if (resp.ok) {
+      if (resp.status === 204) return undefined as T
+      const ct = resp.headers.get('content-type') || ''
+      if (ct.includes('application/json')) return (await resp.json()) as T
+      return resp as unknown as T
+    }
+
+    let errBody: ErrorResponse | null = null
+    try {
+      errBody = (await resp.json()) as ErrorResponse
+    } catch {
+      /* ignore */
+    }
+
+    const code = errBody?.error?.code || `HTTP_${resp.status}`
+    const message = errBody?.error?.message || `Request failed with status ${resp.status}`
+    const details = errBody?.error?.details
+
+    throw new ApiErrorClass(code, message, details)
+  } catch (e) {
+    if (e instanceof ApiErrorClass) throw e
+    throw new ApiErrorClass('NETWORK_ERROR', (e as Error).message || 'Network error')
+  }
+}
+
+export const apiClient = {
+  get<T>(path: string, options?: Omit<RequestOptions, 'method'>) {
+    return request<T>(path, { ...options, method: 'GET' })
+  },
+  post<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'body'>) {
+    return request<T>(path, {
+      ...options,
+      method: 'POST',
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    })
+  },
+  patch<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'body'>) {
+    return request<T>(path, {
+      ...options,
+      method: 'PATCH',
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    })
+  },
+  delete<T>(path: string, options?: Omit<RequestOptions, 'method'>) {
+    return request<T>(path, { ...options, method: 'DELETE' })
+  },
+}
+
+export default apiClient