# rbac-demos **Repository Path**: ake1205_admin_admin_admin/rbac-demos ## Basic Information - **Project Name**: rbac-demos - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-05 - **Last Updated**: 2026-11-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RBAC + 数据权限 + 多租户隔离 演示项目 基于 **Spring Boot 3(JDK 21)+ MyBatis-Plus + Spring Security(JWT) + Vue3** 的全栈示例, 参考《一文讲透企业级权限管理:RBAC+数据权限+多租户隔离》的实现思路,结构清晰、便于本地运行调试。 > 三大机制均通过 **MyBatis 拦截器** 实现,业务代码零侵入: > - **RBAC**:用户 / 角色 / 菜单(权限) / 关联关系表 + `@PreAuthorize("hasAuthority('xxx')")` 注解鉴权 > - **数据权限**:自定义 `InnerInterceptor`,按部门 / 用户维度自动向 SQL 追加 `WHERE` 条件 > - **多租户隔离**:MyBatis-Plus `TenantLineHandler`,对带 `tenant_id` 的表自动注入 `tenant_id = ?` --- ## 1. 环境要求 - JDK 21 - Maven 3.8+ - Node.js 18+(前端) - MySQL 8.x,地址 `192.168.20.37:3306`,账号 `root` / `111111` ## 2. 目录结构 ``` rbac-demos/ ├── rbac-demo/ # 后端(Maven + Spring Boot 3) │ ├── db/init.sql # 建库建表 + 贴近真实的示例数据 │ ├── pom.xml │ └── src/main/java/com/example/rbacdemo/ │ ├── common/ # Result 统一响应、BaseDO / TenantBaseDO │ ├── config/ # MybatisPlus / Security / Cors / 全局异常 │ ├── framework/ │ │ ├── security/ # JwtTokenProvider、JwtAuthenticationFilter、LoginUser、UserContextHolder │ │ ├── tenant/ # TenantContextHolder、TenantLineHandlerImpl(多租户) │ │ └── datapermission/ # DataScopeEnum、@DataPermission、规则与拦截器 │ ├── domain/ mapper/ service/ controller/ # RBAC 与业务模块 │ └── RbacDemoApplication.java └── rbac-demo-web/ # 前端(Vue3 + Vite + Element Plus) ├── src/ │ ├── views/login/ # 登录页(含一键预置账号) │ ├── views/layout/ # 动态菜单布局 │ ├── views/dashboard/ # 工作台(展示当前角色/权限/数据范围) │ ├── views/system/ # 用户 / 角色 / 部门 / 菜单 │ └── views/business/ # 订单(核心演示数据权限 + 多租户) └── ... ``` ## 3. 初始化数据库 ```bash mysql -h 192.168.20.37 -u root -p111111 < rbac-demo/db/init.sql ``` 脚本会创建 `rbac_demo` 库,并建立 9 张表,预置: - **2 个租户**(北京科技有限公司 / 上海贸易有限公司) - **部门层级**(总公司 → 技术部 → 后端组/前端组;财务部;销售部 等) - **8 个用户 / 8 个角色**,覆盖超管、管理员、部门管理员、普通员工、财务、自定义范围、以及租户2 的管理员/员工 - **订单业务数据**,分布在不同租户、部门、创建人,用于演示隔离 ## 4. 启动后端 ```bash cd rbac-demo mvn spring-boot:run # 默认端口 8080 ``` `application.yml` 已开启 MyBatis-Plus SQL 日志(`stdout`),可在控制台直接观察 **租户条件 `tenant_id = ?`** 与 **数据权限条件 `dept_id IN (...) OR create_user_id = ?`** 的自动注入。 ## 5. 启动前端 ```bash cd rbac-demo-web npm install npm run dev # 默认 http://localhost:5173 ``` 前端通过 Vite 代理把 `/api` 转发到后端 `:8080`。 ## 6. 预置账号与预期效果 所有账号密码均为 **`123456`**,可在登录页一键填充。 | 账号 | 角色 | 数据范围 | 订单页预期(关键点) | |------|------|----------|----------------------| | `superadmin` | 超管(super_admin) | 全部 | 租户1 全部 **7** 条 | | `admin01` | 管理员 | 全部 | 租户1 全部 **7** 条 | | `techmgr` | 部门管理员 | 本部门及子部门(技术部=2,3,4) | **4** 条 | | `dev01` | 普通员工 | 仅本人 | 仅本人创建 **2** 条 | | `fin01` | 财务 | 仅本部门(财务部=5) | **1** 条 | | `custom01` | 自定义查看员 | 自定义部门(2,5,含子部门) | **5** 条 | | `shadmin` | 上海管理员 | 全部(租户2) | 租户2 全部 **3** 条 | | `shdev` | 上海研发 | 仅本人(租户2) | **1** 条 | > 观察要点: > 1. **多租户**:用 `shadmin` / `shdev` 登录,订单只显示租户2 数据,与租户1 完全隔离。 > 2. **数据权限**:同一接口 `/business/order/list`,不同账号看到的行数/内容不同。 > 3. **按钮级权限**:`部门管理员(techmgr)` 没有 `system:user:add` 等权限,用户管理页的「新增/删除」按钮自动隐藏(`v-auth` 指令)。 ## 7. 核心实现位置(便于阅读源码) | 机制 | 关键类 | |------|--------| | 多租户隔离 | `framework/tenant/TenantLineHandlerImpl.java`、`config/MybatisPlusConfig.java` | | 数据权限 | `framework/datapermission/DataPermissionInterceptor.java`、`DeptDataPermissionRule.java`、`DataScopeEnum.java` | | 防递归 | `framework/datapermission/DataPermissionUtils.java` + `@DataPermission(enable=false)` 注解 + `DataPermissionAspect.java`(如部门树查询) | | JWT 认证 | `framework/security/JwtTokenProvider.java`、`JwtAuthenticationFilter.java`、`config/SecurityConfig.java` | | RBAC 鉴权 | `controller/*` 上的 `@PreAuthorize`、前端 `directives/auth.js` 的 `v-auth` | ## 8. 调试建议 - 后端已开启 SQL 日志,重点关注 `WHERE` 子句的变化。 - 可在 `UserController.me()`(`GET /system/user/me`)查看当前登录用户的角色、权限、数据范围。 - 新增租户只需在 `system_tenant` 插入记录;新增一张需要隔离的业务表,只要其 DO 继承 `TenantBaseDO` 即可自动获得租户隔离,无需改拦截器。 - 演示用明文密码 + 无 Session 的 JWT;**生产环境请使用 BCrypt 加密密码并妥善管理密钥**。