feat(admin-frontend): 初始化管理端登录功能

admin-frontend/src/App.vue

@@ -0,0 +1,3 @@
+<template>
+  <RouterView />
+</template>

admin-frontend/src/api/admin.ts

@@ -0,0 +1,8 @@
+import { adminClient } from './client'
+import type { ApiResponse, SystemStatus } from '@/types/api'
+
+export function getSystemStatus(): Promise<ApiResponse<SystemStatus>> {
+  return adminClient
+    .get<ApiResponse<SystemStatus>>('/system/getSystemStatus')
+    .then((res) => res.data)
+}

admin-frontend/src/api/client.ts

@@ -0,0 +1,52 @@
+import axios from 'axios'
+import type { ApiResponse } from '@/types/api'
+import { getApiBaseUrl, getSecurePath } from '@/utils/runtime'
+import { getToken, removeToken } from '@/utils/token'
+
+function handleError(error: unknown): never {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status
+    const data = error.response?.data as ApiResponse | undefined
+
+    if (status === 401 || status === 403) {
+      removeToken()
+      window.location.hash = '#/login'
+    }
+
+    throw new Error(data?.message || error.message || '请求失败')
+  }
+  throw new Error('网络错误，请检查网络连接')
+}
+
+export const passportClient = axios.create({
+  baseURL: `${getApiBaseUrl()}/passport`,
+  timeout: 15000,
+  headers: { 'Content-Type': 'application/json' },
+})
+
+export const adminClient = axios.create({
+  timeout: 15000,
+  headers: { 'Content-Type': 'application/json' },
+})
+
+adminClient.interceptors.request.use((config) => {
+  const securePath = getSecurePath()
+  config.baseURL = securePath
+    ? `${getApiBaseUrl()}/${securePath}`
+    : getApiBaseUrl()
+  const token = getToken()
+  if (token) {
+    config.headers.Authorization = token
+  }
+  return config
+})
+
+passportClient.interceptors.response.use(
+  (res) => res,
+  (err) => handleError(err),
+)
+
+adminClient.interceptors.response.use(
+  (res) => res,
+  (err) => handleError(err),
+)

admin-frontend/src/api/passport.ts

@@ -0,0 +1,8 @@
+import { passportClient } from './client'
+import type { ApiResponse, LoginRequest, LoginResponse } from '@/types/api'
+
+export function login(data: LoginRequest): Promise<ApiResponse<LoginResponse>> {
+  return passportClient
+    .post<ApiResponse<LoginResponse>>('/auth/login', data)
+    .then((res) => res.data)
+}

admin-frontend/src/layouts/AdminLayout.vue

@@ -0,0 +1,180 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
+import { useAuthStore } from '@/stores/auth'
+import { useAppStore } from '@/stores/app'
+import {
+  Odometer,
+  SwitchButton,
+  Fold,
+  Expand,
+  Sunny,
+  Moon,
+} from '@element-plus/icons-vue'
+
+const route = useRoute()
+const router = useRouter()
+const auth = useAuthStore()
+const app = useAppStore()
+
+const sidebarWidth = computed(() => app.sidebarCollapsed ? '64px' : '220px')
+
+const menuItems = [
+  { index: '/dashboard', title: '仪表盘', icon: Odometer },
+]
+
+function handleMenuSelect(index: string) {
+  router.push(index)
+}
+
+function handleLogout() {
+  auth.logout()
+  router.push('/login')
+}
+</script>
+
+<template>
+  <ElContainer class="admin-layout">
+    <ElAside :width="sidebarWidth" class="admin-aside">
+      <div class="aside-logo">
+        <h1 v-if="!app.sidebarCollapsed">Xboard</h1>
+        <span v-else>X</span>
+      </div>
+      <ElMenu
+        :default-active="route.path"
+        :collapse="app.sidebarCollapsed"
+        :collapse-transition="false"
+        router
+        @select="handleMenuSelect"
+      >
+        <ElMenuItem
+          v-for="item in menuItems"
+          :key="item.index"
+          :index="item.index"
+        >
+          <ElIcon><component :is="item.icon" /></ElIcon>
+          <template #title>{{ item.title }}</template>
+        </ElMenuItem>
+      </ElMenu>
+    </ElAside>
+
+    <ElContainer>
+      <ElHeader class="admin-header">
+        <div class="header-left">
+          <ElIcon
+            class="collapse-btn"
+            @click="app.toggleSidebar"
+          >
+            <Fold v-if="!app.sidebarCollapsed" />
+            <Expand v-else />
+          </ElIcon>
+          <ElBreadcrumb separator="/">
+            <ElBreadcrumbItem :to="{ path: '/dashboard' }">首页</ElBreadcrumbItem>
+            <ElBreadcrumbItem v-if="route.name !== 'Dashboard'">
+              {{ route.name }}
+            </ElBreadcrumbItem>
+          </ElBreadcrumb>
+        </div>
+
+        <div class="header-right">
+          <ElIcon class="theme-btn" @click="app.toggleTheme">
+            <Sunny v-if="app.isDark" />
+            <Moon v-else />
+          </ElIcon>
+          <ElButton text @click="handleLogout">
+            <ElIcon><SwitchButton /></ElIcon>
+            退出
+          </ElButton>
+        </div>
+      </ElHeader>
+
+      <ElMain class="admin-main">
+        <RouterView />
+      </ElMain>
+    </ElContainer>
+  </ElContainer>
+</template>
+
+<style scoped>
+.admin-layout {
+  height: 100vh;
+}
+
+.admin-aside {
+  background: var(--el-bg-color);
+  border-right: 1px solid var(--el-border-color-light);
+  overflow: hidden;
+  transition: width 0.3s;
+}
+
+.aside-logo {
+  height: 56px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-bottom: 1px solid var(--el-border-color-light);
+  font-size: 18px;
+  font-weight: 700;
+  color: var(--el-text-color-primary);
+}
+
+.aside-logo h1 {
+  margin: 0;
+  font-size: 18px;
+}
+
+.admin-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  background: var(--el-bg-color);
+  border-bottom: 1px solid var(--el-border-color-light);
+  padding: 0 20px;
+  height: 56px;
+}
+
+.header-left {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+}
+
+.collapse-btn {
+  font-size: 20px;
+  cursor: pointer;
+  color: var(--el-text-color-regular);
+}
+
+.collapse-btn:hover {
+  color: var(--el-color-primary);
+}
+
+.header-right {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.theme-btn {
+  font-size: 18px;
+  cursor: pointer;
+  color: var(--el-text-color-regular);
+}
+
+.theme-btn:hover {
+  color: var(--el-color-primary);
+}
+
+.admin-main {
+  background: var(--el-bg-color-page);
+  overflow-y: auto;
+}
+
+@media (max-width: 768px) {
+  .admin-aside {
+    position: fixed;
+    z-index: 100;
+    height: 100vh;
+  }
+}
+</style>

admin-frontend/src/main.ts

@@ -0,0 +1,31 @@
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import router from './router'
+import App from './App.vue'
+
+import 'element-plus/theme-chalk/dark/css-vars.css'
+import 'element-plus/dist/index.css'
+import './styles/index.scss'
+
+import { setupGuards } from './router/guards'
+import { initSecurePath } from './utils/runtime'
+import { useAppStore } from './stores/app'
+import { useAuthStore } from './stores/auth'
+
+initSecurePath()
+
+const app = createApp(App)
+const pinia = createPinia()
+
+app.use(pinia)
+
+const appStore = useAppStore()
+appStore.initConfig()
+
+const authStore = useAuthStore()
+authStore.initFromStorage()
+
+setupGuards(router)
+app.use(router)
+
+app.mount('#app')

admin-frontend/src/router/guards.ts

@@ -0,0 +1,33 @@
+import type { Router } from 'vue-router'
+import { useAuthStore } from '@/stores/auth'
+import { hasToken } from '@/utils/token'
+
+export function setupGuards(router: Router) {
+  router.beforeEach(async (to) => {
+    const auth = useAuthStore()
+
+    if (to.meta.public) {
+      if (hasToken() && !auth.validated) {
+        const ok = await auth.validateAdmin()
+        if (ok) return '/dashboard'
+      }
+      if (auth.validated) {
+        return '/dashboard'
+      }
+      return true
+    }
+
+    if (!hasToken()) {
+      return '/login'
+    }
+
+    if (!auth.validated) {
+      const ok = await auth.validateAdmin()
+      if (!ok) {
+        return '/login'
+      }
+    }
+
+    return true
+  })
+}

admin-frontend/src/router/index.ts

@@ -0,0 +1,33 @@
+import { createRouter, createWebHashHistory } from 'vue-router'
+import type { RouteRecordRaw } from 'vue-router'
+
+const routes: RouteRecordRaw[] = [
+  {
+    path: '/login',
+    name: 'Login',
+    component: () => import('@/views/login/LoginView.vue'),
+    meta: { public: true },
+  },
+  {
+    path: '/',
+    component: () => import('@/layouts/AdminLayout.vue'),
+    children: [
+      {
+        path: '',
+        redirect: '/dashboard',
+      },
+      {
+        path: 'dashboard',
+        name: 'Dashboard',
+        component: () => import('@/views/dashboard/DashboardView.vue'),
+      },
+    ],
+  },
+]
+
+const router = createRouter({
+  history: createWebHashHistory(),
+  routes,
+})
+
+export default router

admin-frontend/src/stores/app.ts

@@ -0,0 +1,43 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { getSecurePath, getApiBaseUrl, getAppTitle, getLogo, getVersion } from '@/utils/runtime'
+
+export const useAppStore = defineStore('app', () => {
+  const securePath = ref('')
+  const apiBaseUrl = ref('')
+  const title = ref('Xboard Admin')
+  const logo = ref('')
+  const version = ref('')
+  const sidebarCollapsed = ref(false)
+  const isDark = ref(false)
+
+  function initConfig() {
+    securePath.value = getSecurePath()
+    apiBaseUrl.value = getApiBaseUrl()
+    title.value = getAppTitle()
+    logo.value = getLogo()
+    version.value = getVersion()
+
+    const saved = localStorage.getItem('xboard_theme_dark')
+    if (saved !== null) {
+      isDark.value = saved === 'true'
+    }
+    applyTheme()
+  }
+
+  function toggleSidebar() {
+    sidebarCollapsed.value = !sidebarCollapsed.value
+  }
+
+  function toggleTheme() {
+    isDark.value = !isDark.value
+    localStorage.setItem('xboard_theme_dark', String(isDark.value))
+    applyTheme()
+  }
+
+  function applyTheme() {
+    document.documentElement.classList.toggle('dark', isDark.value)
+  }
+
+  return { securePath, apiBaseUrl, title, logo, version, sidebarCollapsed, isDark, initConfig, toggleSidebar, toggleTheme }
+})

admin-frontend/src/stores/auth.ts

@@ -0,0 +1,81 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { login as apiLogin } from '@/api/passport'
+import { getSystemStatus } from '@/api/admin'
+import { getToken, setToken, removeToken, hasToken } from '@/utils/token'
+import axios from 'axios'
+
+export const useAuthStore = defineStore('auth', () => {
+  const authHeader = ref<string | null>(getToken())
+  const isAdmin = ref(false)
+  const isLoading = ref(false)
+  const validated = ref(false)
+
+  async function login(email: string, password: string, remember: boolean = false) {
+    isLoading.value = true
+    try {
+      const res = await apiLogin({ email, password })
+
+      if (!res.data.is_admin) {
+        throw new Error('该账号无管理员权限')
+      }
+
+      authHeader.value = res.data.auth_data
+      isAdmin.value = res.data.is_admin
+      setToken(res.data.auth_data, remember)
+
+      const probeOk = await validateAdmin()
+      if (!probeOk) {
+        validated.value = true
+        isAdmin.value = true
+      }
+
+      return true
+    } catch (err) {
+      authHeader.value = null
+      isAdmin.value = false
+      removeToken()
+      throw err
+    } finally {
+      isLoading.value = false
+    }
+  }
+
+  async function validateAdmin(): Promise<boolean> {
+    if (!hasToken()) {
+      return false
+    }
+    try {
+      await getSystemStatus()
+      validated.value = true
+      isAdmin.value = true
+      return true
+    } catch (err) {
+      if (axios.isAxiosError(err)) {
+        const status = err.response?.status
+        if (status === 401 || status === 403) {
+          logout()
+          return false
+        }
+      }
+      console.warn('[Xboard] Admin probe failed, proceeding with login token')
+      return false
+    }
+  }
+
+  function logout() {
+    authHeader.value = null
+    isAdmin.value = false
+    validated.value = false
+    removeToken()
+  }
+
+  function initFromStorage() {
+    const token = getToken()
+    if (token) {
+      authHeader.value = token
+    }
+  }
+
+  return { authHeader, isAdmin, isLoading, validated, login, logout, validateAdmin, initFromStorage }
+})

admin-frontend/src/styles/index.scss

@@ -0,0 +1,32 @@
+@use 'element-plus/theme-chalk/src/mixins/config' as *;
+
+:root {
+  --xboard-primary: #409eff;
+  --xboard-sidebar-bg: #ffffff;
+  --xboard-header-bg: #ffffff;
+}
+
+html.dark {
+  --xboard-sidebar-bg: #1d1e1f;
+  --xboard-header-bg: #1d1e1f;
+}
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+html,
+body,
+#app {
+  width: 100%;
+  height: 100%;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial,
+    'Noto Sans', sans-serif;
+}
+
+a {
+  text-decoration: none;
+  color: inherit;
+}

admin-frontend/src/types/api.d.ts

@@ -0,0 +1,36 @@
+export interface ApiResponse<T = unknown> {
+  status: 'success' | 'fail'
+  message: string
+  data: T
+  error?: string | null
+}
+
+export interface LoginRequest {
+  email: string
+  password: string
+}
+
+export interface LoginResponse {
+  token: string
+  auth_data: string
+  is_admin: boolean
+}
+
+export interface SystemStatus {
+  [key: string]: unknown
+}
+
+declare global {
+  interface Window {
+    settings?: {
+      secure_path?: string
+      title?: string
+      logo?: string
+      version?: string
+      theme_sidebar?: string
+      theme_header?: string
+      theme_color?: string
+      background_url?: string
+    }
+  }
+}

admin-frontend/src/types/auto-imports.d.ts

@@ -0,0 +1,90 @@
+/* eslint-disable */
+/* prettier-ignore */
+// @ts-nocheck
+// noinspection JSUnusedGlobalSymbols
+// Generated by unplugin-auto-import
+// biome-ignore lint: disable
+export {}
+declare global {
+  const EffectScope: typeof import('vue').EffectScope
+  const acceptHMRUpdate: typeof import('pinia').acceptHMRUpdate
+  const computed: typeof import('vue').computed
+  const createApp: typeof import('vue').createApp
+  const createPinia: typeof import('pinia').createPinia
+  const customRef: typeof import('vue').customRef
+  const defineAsyncComponent: typeof import('vue').defineAsyncComponent
+  const defineComponent: typeof import('vue').defineComponent
+  const defineStore: typeof import('pinia').defineStore
+  const effectScope: typeof import('vue').effectScope
+  const getActivePinia: typeof import('pinia').getActivePinia
+  const getCurrentInstance: typeof import('vue').getCurrentInstance
+  const getCurrentScope: typeof import('vue').getCurrentScope
+  const getCurrentWatcher: typeof import('vue').getCurrentWatcher
+  const h: typeof import('vue').h
+  const inject: typeof import('vue').inject
+  const isProxy: typeof import('vue').isProxy
+  const isReactive: typeof import('vue').isReactive
+  const isReadonly: typeof import('vue').isReadonly
+  const isRef: typeof import('vue').isRef
+  const isShallow: typeof import('vue').isShallow
+  const mapActions: typeof import('pinia').mapActions
+  const mapGetters: typeof import('pinia').mapGetters
+  const mapState: typeof import('pinia').mapState
+  const mapStores: typeof import('pinia').mapStores
+  const mapWritableState: typeof import('pinia').mapWritableState
+  const markRaw: typeof import('vue').markRaw
+  const nextTick: typeof import('vue').nextTick
+  const onActivated: typeof import('vue').onActivated
+  const onBeforeMount: typeof import('vue').onBeforeMount
+  const onBeforeRouteLeave: typeof import('vue-router').onBeforeRouteLeave
+  const onBeforeRouteUpdate: typeof import('vue-router').onBeforeRouteUpdate
+  const onBeforeUnmount: typeof import('vue').onBeforeUnmount
+  const onBeforeUpdate: typeof import('vue').onBeforeUpdate
+  const onDeactivated: typeof import('vue').onDeactivated
+  const onErrorCaptured: typeof import('vue').onErrorCaptured
+  const onMounted: typeof import('vue').onMounted
+  const onRenderTracked: typeof import('vue').onRenderTracked
+  const onRenderTriggered: typeof import('vue').onRenderTriggered
+  const onScopeDispose: typeof import('vue').onScopeDispose
+  const onServerPrefetch: typeof import('vue').onServerPrefetch
+  const onUnmounted: typeof import('vue').onUnmounted
+  const onUpdated: typeof import('vue').onUpdated
+  const onWatcherCleanup: typeof import('vue').onWatcherCleanup
+  const provide: typeof import('vue').provide
+  const reactive: typeof import('vue').reactive
+  const readonly: typeof import('vue').readonly
+  const ref: typeof import('vue').ref
+  const resolveComponent: typeof import('vue').resolveComponent
+  const setActivePinia: typeof import('pinia').setActivePinia
+  const setMapStoreSuffix: typeof import('pinia').setMapStoreSuffix
+  const shallowReactive: typeof import('vue').shallowReactive
+  const shallowReadonly: typeof import('vue').shallowReadonly
+  const shallowRef: typeof import('vue').shallowRef
+  const storeToRefs: typeof import('pinia').storeToRefs
+  const toRaw: typeof import('vue').toRaw
+  const toRef: typeof import('vue').toRef
+  const toRefs: typeof import('vue').toRefs
+  const toValue: typeof import('vue').toValue
+  const triggerRef: typeof import('vue').triggerRef
+  const unref: typeof import('vue').unref
+  const useAttrs: typeof import('vue').useAttrs
+  const useCssModule: typeof import('vue').useCssModule
+  const useCssVars: typeof import('vue').useCssVars
+  const useId: typeof import('vue').useId
+  const useLink: typeof import('vue-router').useLink
+  const useModel: typeof import('vue').useModel
+  const useRoute: typeof import('vue-router').useRoute
+  const useRouter: typeof import('vue-router').useRouter
+  const useSlots: typeof import('vue').useSlots
+  const useTemplateRef: typeof import('vue').useTemplateRef
+  const watch: typeof import('vue').watch
+  const watchEffect: typeof import('vue').watchEffect
+  const watchPostEffect: typeof import('vue').watchPostEffect
+  const watchSyncEffect: typeof import('vue').watchSyncEffect
+}
+// for type re-export
+declare global {
+  // @ts-ignore
+  export type { Component, Slot, Slots, ComponentPublicInstance, ComputedRef, DirectiveBinding, ExtractDefaultPropTypes, ExtractPropTypes, ExtractPublicPropTypes, InjectionKey, PropType, Ref, ShallowRef, MaybeRef, MaybeRefOrGetter, VNode, WritableComputedRef } from 'vue'
+  import('vue')
+}

admin-frontend/src/types/components.d.ts

@@ -0,0 +1,35 @@
+/* eslint-disable */
+// @ts-nocheck
+// biome-ignore lint: disable
+// oxlint-disable
+// ------
+// Generated by unplugin-vue-components
+// Read more: https://github.com/vuejs/core/pull/3399
+
+export {}
+
+/* prettier-ignore */
+declare module 'vue' {
+  export interface GlobalComponents {
+    ElAside: typeof import('element-plus/es')['ElAside']
+    ElBreadcrumb: typeof import('element-plus/es')['ElBreadcrumb']
+    ElBreadcrumbItem: typeof import('element-plus/es')['ElBreadcrumbItem']
+    ElButton: typeof import('element-plus/es')['ElButton']
+    ElCard: typeof import('element-plus/es')['ElCard']
+    ElCheckbox: typeof import('element-plus/es')['ElCheckbox']
+    ElCol: typeof import('element-plus/es')['ElCol']
+    ElContainer: typeof import('element-plus/es')['ElContainer']
+    ElDivider: typeof import('element-plus/es')['ElDivider']
+    ElForm: typeof import('element-plus/es')['ElForm']
+    ElFormItem: typeof import('element-plus/es')['ElFormItem']
+    ElHeader: typeof import('element-plus/es')['ElHeader']
+    ElIcon: typeof import('element-plus/es')['ElIcon']
+    ElInput: typeof import('element-plus/es')['ElInput']
+    ElMain: typeof import('element-plus/es')['ElMain']
+    ElMenu: typeof import('element-plus/es')['ElMenu']
+    ElMenuItem: typeof import('element-plus/es')['ElMenuItem']
+    ElRow: typeof import('element-plus/es')['ElRow']
+    RouterLink: typeof import('vue-router')['RouterLink']
+    RouterView: typeof import('vue-router')['RouterView']
+  }
+}

admin-frontend/src/utils/runtime.ts

@@ -0,0 +1,41 @@
+let cachedSecurePath: string | null = null
+
+export function getApiBaseUrl(): string {
+  return import.meta.env.VITE_API_BASE_URL || '/api/v2'
+}
+
+export function initSecurePath(): string {
+  if (window.settings?.secure_path) {
+    cachedSecurePath = window.settings.secure_path
+    return cachedSecurePath
+  }
+
+  const envPath = import.meta.env.VITE_ADMIN_PATH
+  if (envPath) {
+    cachedSecurePath = envPath
+    return cachedSecurePath
+  }
+
+  console.error('[Xboard] secure_path 未配置。请设置 window.settings.secure_path 或环境变量 VITE_ADMIN_PATH')
+  cachedSecurePath = ''
+  return ''
+}
+
+export function getSecurePath(): string {
+  if (cachedSecurePath === null) {
+    return initSecurePath()
+  }
+  return cachedSecurePath
+}
+
+export function getAppTitle(): string {
+  return window.settings?.title || 'Xboard Admin'
+}
+
+export function getLogo(): string {
+  return window.settings?.logo || ''
+}
+
+export function getVersion(): string {
+  return window.settings?.version || ''
+}

admin-frontend/src/utils/token.ts

@@ -0,0 +1,28 @@
+const TOKEN_KEY = 'xboard_admin_auth'
+const REMEMBER_KEY = 'xboard_admin_remember'
+
+export function getToken(): string | null {
+  const remember = localStorage.getItem(REMEMBER_KEY)
+  const storage = remember === 'true' ? localStorage : sessionStorage
+  return storage.getItem(TOKEN_KEY)
+}
+
+export function setToken(token: string, remember: boolean = false): void {
+  removeToken()
+  if (remember) {
+    localStorage.setItem(REMEMBER_KEY, 'true')
+    localStorage.setItem(TOKEN_KEY, token)
+  } else {
+    sessionStorage.setItem(TOKEN_KEY, token)
+  }
+}
+
+export function removeToken(): void {
+  sessionStorage.removeItem(TOKEN_KEY)
+  localStorage.removeItem(TOKEN_KEY)
+  localStorage.removeItem(REMEMBER_KEY)
+}
+
+export function hasToken(): boolean {
+  return getToken() !== null
+}

admin-frontend/src/views/dashboard/DashboardView.vue

@@ -0,0 +1,60 @@
+<script setup lang="ts">
+import { useAppStore } from '@/stores/app'
+
+const app = useAppStore()
+</script>
+
+<template>
+  <div class="dashboard">
+    <ElRow :gutter="20">
+      <ElCol :span="24">
+        <ElCard shadow="never">
+          <template #header>
+            <div class="card-header">
+              <span>欢迎使用</span>
+            </div>
+          </template>
+          <div class="welcome">
+            <h2>{{ app.title }}</h2>
+            <p class="version" v-if="app.version">版本：{{ app.version }}</p>
+            <ElDivider />
+            <p class="hint">管理后台正在建设中，更多功能即将上线。</p>
+          </div>
+        </ElCard>
+      </ElCol>
+    </ElRow>
+  </div>
+</template>
+
+<style scoped>
+.dashboard {
+  padding: 0;
+}
+
+.card-header {
+  display: flex;
+  align-items: center;
+  font-weight: 600;
+}
+
+.welcome {
+  text-align: center;
+  padding: 40px 0;
+}
+
+.welcome h2 {
+  margin: 0 0 8px;
+  font-size: 22px;
+  color: var(--el-text-color-primary);
+}
+
+.version {
+  color: var(--el-text-color-secondary);
+  font-size: 14px;
+}
+
+.hint {
+  color: var(--el-text-color-secondary);
+  font-size: 14px;
+}
+</style>

admin-frontend/src/views/login/LoginView.vue

@@ -0,0 +1,148 @@
+<script setup lang="ts">
+import { reactive, ref } from 'vue'
+import { useRouter } from 'vue-router'
+import { useAuthStore } from '@/stores/auth'
+import { ElMessage } from 'element-plus'
+import type { FormInstance, FormRules } from 'element-plus'
+
+const router = useRouter()
+const auth = useAuthStore()
+
+const formRef = ref<FormInstance>()
+const loading = ref(false)
+
+const form = reactive({
+  email: '',
+  password: '',
+  remember: false,
+})
+
+const rules: FormRules = {
+  email: [
+    { required: true, message: '请输入邮箱', trigger: 'blur' },
+    { type: 'email', message: '邮箱格式不正确', trigger: 'blur' },
+  ],
+  password: [
+    { required: true, message: '请输入密码', trigger: 'blur' },
+    { min: 8, message: '密码至少 8 位', trigger: 'blur' },
+  ],
+}
+
+async function onSubmit() {
+  const valid = await formRef.value?.validate().catch(() => false)
+  if (!valid) return
+
+  loading.value = true
+  try {
+    await auth.login(form.email, form.password, form.remember)
+    ElMessage.success('登录成功')
+    router.push('/dashboard')
+  } catch (err: unknown) {
+    const msg = err instanceof Error ? err.message : '登录失败'
+    ElMessage.error(msg)
+  } finally {
+    loading.value = false
+  }
+}
+</script>
+
+<template>
+  <div class="login-container">
+    <div class="login-card">
+      <div class="login-header">
+        <h1 class="login-title">Xboard Admin</h1>
+        <p class="login-subtitle">管理后台</p>
+      </div>
+
+      <ElForm
+        ref="formRef"
+        :model="form"
+        :rules="rules"
+        label-position="top"
+        size="large"
+        @keyup.enter="onSubmit"
+      >
+        <ElFormItem label="邮箱" prop="email">
+          <ElInput
+            v-model="form.email"
+            placeholder="admin@example.com"
+            prefix-icon="Message"
+          />
+        </ElFormItem>
+
+        <ElFormItem label="密码" prop="password">
+          <ElInput
+            v-model="form.password"
+            type="password"
+            placeholder="请输入密码"
+            prefix-icon="Lock"
+            show-password
+          />
+        </ElFormItem>
+
+        <ElFormItem>
+          <ElCheckbox v-model="form.remember">记住登录</ElCheckbox>
+        </ElFormItem>
+
+        <ElFormItem>
+          <ElButton
+            type="primary"
+            :loading="loading"
+            class="login-btn"
+            @click="onSubmit"
+          >
+            {{ loading ? '登录中...' : '登 录' }}
+          </ElButton>
+        </ElFormItem>
+      </ElForm>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.login-container {
+  min-height: 100vh;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(135deg, #1a1a2e 0%, #16213e 50%, #0f3460 100%);
+  padding: 20px;
+}
+
+.login-card {
+  width: 100%;
+  max-width: 420px;
+  padding: 40px;
+  background: var(--el-bg-color);
+  border-radius: 12px;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);
+}
+
+.login-header {
+  text-align: center;
+  margin-bottom: 32px;
+}
+
+.login-title {
+  font-size: 24px;
+  font-weight: 700;
+  color: var(--el-text-color-primary);
+  margin: 0 0 8px;
+}
+
+.login-subtitle {
+  font-size: 14px;
+  color: var(--el-text-color-secondary);
+  margin: 0;
+}
+
+.login-btn {
+  width: 100%;
+}
+
+@media (max-width: 480px) {
+  .login-card {
+    padding: 24px;
+  }
+}
+</style>