权限
Yi.Mini 默认使用后端访问控制。后端负责返回用户可访问的菜单和权限码，前端负责把菜单转换为路由，并用权限码控制按钮显示。
当前流程
登录成功后，apps/web-antd/src/store/auth.ts 会执行：
loginApi()获取 token。getUserInfoApi()请求/account获取用户信息。- 从响应中读取
permissionCodes、roleCodes、user。 - 写入 Vben 用户信息和权限仓储：
const { permissionCodes = [], roleCodes = [], user } = backUserInfo;
const userInfo = {
permissions: permissionCodes,
roles: roleCodes,
userId: user.userId,
username: user.userName,
};
userStore.setUserInfo(userInfo);
accessStore.setAccessCodes(userInfo.permissions);菜单路由由 apps/web-antd/src/router/access.ts 请求 /account/router 后动态生成。
后端访问控制
apps/web-antd/src/preferences.ts 中保持：
export const overridesPreferences = defineOverridesPreferences({
app: {
accessMode: 'backend',
},
});后端菜单接口需要返回 name、path、component、meta、children 等路由字段。前端通过 backMenuToVbenMenu() 转换后注册到路由表。
权限码
2.1 推荐权限码格式：
{module}:{entity}:{action}示例：
system:user:query
system:user:add
system:user:edit
system:user:remove
monitor:operlog:query后端 Yi.Framework.Operation 会根据模块、实体和动作自动推断权限码，也可以通过 [Permission] 或配置映射显式指定。
兼容说明
历史菜单数据中可能仍有 remove、query、resetPwd 等权限码。新增功能建议使用标准动作；兼容旧菜单时，需要后端显式映射或在服务方法上指定权限。
超级管理员
2.1 起平台超级管理员角色码为 superadmin，普通租户管理员角色码为 admin。平台超管通常同时拥有 *:*:* 权限码，前端权限判断会把它视为全部按钮权限。
租户中不应出现 superadmin 角色。租户用户能访问哪些菜单，取决于租户套餐和角色菜单授权。
按钮权限
组件方式
<script lang="ts" setup>
import { AccessControl } from '@vben/access';
</script>
<template>
<AccessControl :codes="['system:user:add']" type="code">
<Button>新增用户</Button>
</AccessControl>
</template>API 方式
<script lang="ts" setup>
import { useAccess } from '@vben/access';
const { hasAccessByCodes } = useAccess();
</script>
<template>
<Button v-if="hasAccessByCodes(['system:user:edit'])">
编辑用户
</Button>
</template>指令方式
<template>
<Button v-access:code="'system:user:add'">新增用户</Button>
<Button v-access:code="['system:user:remove']">删除用户</Button>
</template>角色控制
角色码来自 /account 响应中的 roleCodes，适合控制少量纯前端入口或特殊展示。
<script lang="ts" setup>
import { useAccess } from '@vben/access';
const { hasAccessByRoles } = useAccess();
</script>
<template>
<Button v-if="hasAccessByRoles(['superadmin'])">平台超管可见</Button>
<Button v-access:role="['admin']">租户管理员可见</Button>
</template>前端访问控制
Vben 仍支持 frontend 和 mixed 模式，但 Yi.Mini 默认不推荐把业务菜单权限写死在前端。只有登录页、异常页、本地辅助页等基础路由建议放在 localMenuList 或本地静态路由中。
如果确实需要前端模式，可在路由 meta.authority 中写角色码：
{
meta: {
authority: ['admin'],
},
}贡献者
wcg dubai