用途:面向 SpringBoot + Vben Admin 的应急管理系统,提供权限体系开发规范,用于新建功能模块、配置菜单权限、设置数据权限时的统一约定。
主要能力:
- 定义 RBAC 权限架构:用户-角色-菜单(目录/菜单/按钮),角色携带数据权限范围。
- 约定数据库表结构,包括 sys_menu、sys_role 及 sys_user_role、sys_role_menu、sys_role_dept 关联表。
- 权限标识命名规范:{模块}:{实体}:{操作},标准操作含 list、detail、add、edit、delete、export、import,示例如 sys:user:add、emergency:plan:approve。
- 数据权限五种范围:全部数据(1)、本部门(2)、本部门及下级(3)、仅本人(4)、自定义部门(5)。
- CX 命令集成:执行 /cx:do 或 /cx:plan 创建新功能模块时,必须同时创建 Flyway 迁移 SQL 文件,命名 V{版本号}__{描述}.sql,包含菜单数据插入与超级管理员角色菜单权限分配语句。
- 提供迁移 SQL 模板与应急事件模块完整示例,含目录、菜单、按钮三级结构,菜单 ID 使用 @max_menu_id + N 避免冲突。
- 后端 Controller 使用 @SaCheckPermission 注解;Service 层结合 @DataScope 与 DataScopeHelper 添加数据权限过滤。
- 前端路由由后端 /api/auth/routes 接口动态返回,无需手动配置。
使用方式:新建模块时按检查清单核对——创建迁移 SQL、菜单 ID 递增、三级结构完整、权限标识符合规范、为超级管理员分配权限、Controller 添加权限注解、需要数据权限的查询添加 DataScopeHelper 过滤、前端组件路径与菜单 component 一致。命令需保持原样执行。
限制:本文档未提供具体版本号规则、部署方式、收费信息及实际运行效果说明;相关内容暂未提供。