feat: migrate from Element Plus to Ant Design Vue and update Vite configuration for better dependency management

- Updated Vite configuration to manually chunk Ant Design Vue for improved dependency management.
- Added a comprehensive migration testing checklist for transitioning from Element Plus 2.13.0 to Ant Design Vue 4.x, covering various components and functionalities.
This commit is contained in:
2026-01-03 01:38:38 +08:00
parent 42a1046750
commit 827c9198ae
57 changed files with 5517 additions and 2982 deletions
+65
View File
@@ -0,0 +1,65 @@
import { ref, onMounted, onUnmounted } from 'vue'
/**
* 响应式断点检测 Composable
* 基于 Ant Design 的断点系统
* - xs: <576px (手机)
* - sm: ≥576px (平板竖屏)
* - md: ≥768px (平板横屏)
* - lg: ≥992px (桌面)
* - xl: ≥1200px (大屏)
* - xxl: ≥1600px (超大屏)
*/
export function useBreakpoint() {
const isMobile = ref(window.innerWidth < 768)
const isTablet = ref(window.innerWidth >= 768 && window.innerWidth < 992)
const isDesktop = ref(window.innerWidth >= 992)
// Ant Design 断点
const isXs = ref(window.innerWidth < 576)
const isSm = ref(window.innerWidth >= 576 && window.innerWidth < 768)
const isMd = ref(window.innerWidth >= 768 && window.innerWidth < 992)
const isLg = ref(window.innerWidth >= 992 && window.innerWidth < 1200)
const isXl = ref(window.innerWidth >= 1200 && window.innerWidth < 1600)
const isXxl = ref(window.innerWidth >= 1600)
const updateBreakpoints = () => {
const width = window.innerWidth
// 简化断点
isMobile.value = width < 768
isTablet.value = width >= 768 && width < 992
isDesktop.value = width >= 992
// Ant Design 断点
isXs.value = width < 576
isSm.value = width >= 576 && width < 768
isMd.value = width >= 768 && width < 992
isLg.value = width >= 992 && width < 1200
isXl.value = width >= 1200 && width < 1600
isXxl.value = width >= 1600
}
onMounted(() => {
window.addEventListener('resize', updateBreakpoints)
})
onUnmounted(() => {
window.removeEventListener('resize', updateBreakpoints)
})
return {
// 简化断点(常用)
isMobile,
isTablet,
isDesktop,
// Ant Design 断点(详细)
isXs,
isSm,
isMd,
isLg,
isXl,
isXxl,
}
}
+161
View File
@@ -0,0 +1,161 @@
import { ref, computed, onMounted, onUnmounted } from 'vue'
import { message } from 'ant-design-vue'
import { useAuthStore } from '@/stores/auth'
import { useUserStore } from '@/stores/user'
import { useRouter } from 'vue-router'
/**
* Token 过期监控 Composable
*
* 功能:
* 1. 定时检查 Token 状态
* 2. Token 过期后 5 分钟内提醒用户
* 3. 为有密码的用户提供友好的过期处理
*/
let monitorTimer = null
let warningShown = false
export function useTokenMonitor() {
const authStore = useAuthStore()
const userStore = useUserStore()
const router = useRouter()
const tokenStatus = computed(() => userStore.tokenStatus)
const hasPassword = computed(() => authStore.user?.has_password || false)
// 计算 Token 剩余分钟数
const getRemainingMinutes = () => {
if (!tokenStatus.value?.expires_at) return null
const now = Math.floor(Date.now() / 1000)
const expiresAt = tokenStatus.value.expires_at
const diffSeconds = expiresAt - now
return Math.floor(diffSeconds / 60)
}
// 检查 Token 状态并显示提醒
const checkTokenStatus = async () => {
// 如果未登录,不检查
if (!authStore.isAuthenticated) {
return
}
try {
// 获取最新的 Token 状态
await userStore.fetchTokenStatus()
const remainingMinutes = getRemainingMinutes()
// Token 已过期(负数分钟)
if (remainingMinutes !== null && remainingMinutes < 0) {
const expiredMinutes = Math.abs(remainingMinutes)
// Token 过期后 5 分钟内提醒
if (expiredMinutes <= 5) {
if (hasPassword.value) {
// 有密码的用户:友好提示
if (!warningShown) {
message.warning({
content: `您的登录凭证已过期 ${expiredMinutes} 分钟,部分功能可能受限。建议您扫码刷新凭证。`,
duration: 8,
key: 'token-expired-warning',
})
warningShown = true
}
} else {
// 没有密码的用户:必须重新登录
message.error({
content: '您的登录凭证已过期,请重新扫码登录',
duration: 5,
key: 'token-expired-error',
})
// 清除登录状态并跳转
authStore.logout()
router.push('/login')
}
} else if (expiredMinutes > 5) {
// 过期超过 5 分钟
if (!hasPassword.value) {
// 没有密码的用户:强制退出
authStore.logout()
router.push('/login')
}
}
}
// Token 即将过期(1小时内)
else if (remainingMinutes !== null && remainingMinutes > 0 && remainingMinutes <= 60) {
if (!warningShown) {
message.warning({
content: `您的登录凭证将在 ${remainingMinutes} 分钟后过期,建议您提前刷新`,
duration: 6,
key: 'token-expiring-warning',
})
warningShown = true
}
}
// Token 状态正常
else if (remainingMinutes !== null && remainingMinutes > 60) {
// 重置警告标志
warningShown = false
}
} catch (error) {
console.error('检查 Token 状态失败:', error)
}
}
// 启动监控
const startMonitoring = () => {
// 避免重复启动
if (monitorTimer) {
return
}
// 立即检查一次
checkTokenStatus()
// 每 2 分钟检查一次
monitorTimer = setInterval(() => {
checkTokenStatus()
}, 2 * 60 * 1000) // 2 分钟
}
// 停止监控
const stopMonitoring = () => {
if (monitorTimer) {
clearInterval(monitorTimer)
monitorTimer = null
}
warningShown = false
}
// 手动触发检查
const checkNow = () => {
warningShown = false // 重置警告标志,允许再次显示
checkTokenStatus()
}
// 组件挂载时启动监控
onMounted(() => {
if (authStore.isAuthenticated) {
startMonitoring()
}
})
// 组件卸载时停止监控
onUnmounted(() => {
stopMonitoring()
})
return {
tokenStatus,
hasPassword,
startMonitoring,
stopMonitoring,
checkNow,
getRemainingMinutes,
}
}