将 web-admin 从子模块改为仓库内普通目录,便于单仓克隆与维护。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-05-12 16:41:08 +08:00
1 parent 2e9d020d50
commit c87732fcd5
515 files changed
+74372 -1

No files matched your search

+66
View File
@@ -0,0 +1,66 @@
/**
* v-auth 权限指令
*
* 适用于后端权限控制模式,基于权限标识控制 DOM 元素的显示和隐藏。
* 如果用户没有对应权限,元素将从 DOM 中移除。
*
* ## 主要功能
*
* - 权限验证 - 根据路由 meta 中的权限列表验证用户权限
* - DOM 控制 - 无权限时自动移除元素,而非隐藏
* - 响应式更新 - 权限变化时自动更新元素状态
*
* ## 使用示例
*
* ```vue
* <!-- 只有拥有 'add' 权限的用户才能看到新增按钮 -->
* <el-button v-auth="'add'">新增</el-button>
*
* <!-- 只有拥有 'edit' 权限的用户才能看到编辑按钮 -->
* <el-button v-auth="'edit'">编辑</el-button>
*
* <!-- 只有拥有 'delete' 权限的用户才能看到删除按钮 -->
* <el-button v-auth="'delete'">删除</el-button>
* ```
*
* ## 注意事项
*
* - 该指令会直接移除 DOM 元素,而不是使用 v-if 隐藏
* - 权限列表从当前路由的 meta.authList 中获取
*
* @module directives/auth
* @author Art Design Pro Team
*/
import { router } from '@/router'
import { App, Directive, DirectiveBinding } from 'vue'
export type AuthDirective = Directive<HTMLElement, string>
function checkAuthPermission(el: HTMLElement, binding: DirectiveBinding<string>): void {
// 获取当前路由的权限列表
const authList = (router.currentRoute.value.meta.authList as Array<{ authMark: string }>) || []
// 检查是否有对应的权限标识
const hasPermission = authList.some((item) => item.authMark === binding.value)
// 如果没有权限,移除元素
if (!hasPermission) {
removeElement(el)
}
}
function removeElement(el: HTMLElement): void {
if (el.parentNode) {
el.parentNode.removeChild(el)
}
}
const authDirective: AuthDirective = {
mounted: checkAuthPermission,
updated: checkAuthPermission
}
export function setupAuthDirective(app: App): void {
app.directive('auth', authDirective)
}
+87
View File
@@ -0,0 +1,87 @@
/**
* v-roles 角色权限指令
*
* 基于用户角色控制 DOM 元素的显示和隐藏。
* 只要用户拥有指定角色中的任意一个,元素就会显示,否则从 DOM 中移除。
*
* ## 主要功能
*
* - 角色验证 - 检查用户是否拥有指定角色
* - 多角色支持 - 支持单个角色或多个角色(满足其一即可)
* - DOM 控制 - 无权限时自动移除元素,而非隐藏
* - 响应式更新 - 角色变化时自动更新元素状态
*
* ## 使用示例
*
* ```vue
* <template>
* <!-- 单个角色 - 只有超级管理员可见 -->
* <el-button v-roles="'R_SUPER'">超级管理员功能</el-button>
*
* <!-- 多个角色 - 超级管理员或普通管理员可见 -->
* <el-button v-roles="['R_SUPER', 'R_ADMIN']">管理员功能</el-button>
*
* <!-- 应用到任意元素 -->
* <div v-roles="['R_SUPER', 'R_ADMIN', 'R_USER']">
* 所有登录用户可见的内容
* </div>
* </template>
* ```
*
* ## 权限逻辑
*
* - 用户角色从 userStore.getUserInfo.roles 获取
* - 只要用户拥有指定角色中的任意一个,元素就会显示
* - 如果用户没有任何角色或不满足条件,元素将被移除
*
* ## 注意事项
*
* - 该指令会直接移除 DOM 元素,而不是使用 v-if 隐藏
* - 适用于基于角色的粗粒度权限控制
* - 如需基于具体操作的细粒度权限控制,请使用 v-auth 指令
*
* @module directives/roles
* @author Art Design Pro Team
*/
import { useUserStore } from '@/store/modules/user'
import { App, Directive, DirectiveBinding } from 'vue'
export type RolesDirective = Directive<HTMLElement, string | string[]>
function checkRolePermission(el: HTMLElement, binding: DirectiveBinding<string | string[]>): void {
const userStore = useUserStore()
const userRoles = userStore.getUserInfo.roles
// 如果用户角色为空或未定义,移除元素
if (!userRoles?.length) {
removeElement(el)
return
}
// 确保指令值为数组格式
const requiredRoles = Array.isArray(binding.value) ? binding.value : [binding.value]
// 检查用户是否具有所需角色之一
const hasPermission = requiredRoles.some((role: string) => userRoles.includes(role))
// 如果没有权限,安全地移除元素
if (!hasPermission) {
removeElement(el)
}
}
function removeElement(el: HTMLElement): void {
if (el.parentNode) {
el.parentNode.removeChild(el)
}
}
const rolesDirective: RolesDirective = {
mounted: checkRolePermission,
updated: checkRolePermission
}
export function setupRolesDirective(app: App): void {
app.directive('roles', rolesDirective)
}