cool-admin(midway版)数据权限过滤：实现方案与对比

cool-admin(midway版)数据权限过滤：实现方案与对比

【免费下载链接】cool-admin-midway🔥 cool-admin(midway版)一个很酷的后台权限管理框架，模块化、插件化、CRUD极速开发，永久开源免费，基于midway.js 3.x、typescript、typeorm、mysql、jwt、vue3、vite、element-ui等构建项目地址: https://gitcode.com/gh_mirrors/co/cool-admin-midway

cool-admin(midway版)是一个基于midway.js 3.x构建的后台权限管理框架，提供了完善的数据权限过滤机制，帮助开发者快速实现复杂的权限控制需求。本文将详细介绍其数据权限过滤的实现方案及不同方案间的对比分析。

数据权限过滤核心实现机制

cool-admin(midway版)的数据权限过滤主要通过角色(Role)与部门(Department)的关联关系实现，核心实现集中在以下模块：

1. 角色-部门关联模型

在系统设计中，角色与部门的多对多关系通过BaseSysRoleDepartmentEntity实体维护，定义文件位于：

// 角色-部门关联实体 ./src/modules/base/entity/sys/role_department.ts

该实体存储了角色与部门的映射关系，使系统能够根据用户所属角色确定其可访问的部门数据范围。

2. 权限服务实现

权限过滤的核心逻辑在BaseSysPermsService中实现，关键代码如下：

// 权限服务实现 ./src/modules/base/service/sys/perms.ts

该服务提供了departmentIds方法，通过缓存机制获取用户可访问的部门ID列表：

async departmentIds(userId: number) { const department: any = await this.midwayCache.get( `admin:department:${userId}` ); if (department) { return department; } // 从数据库获取部门信息的逻辑 }

三种数据权限过滤方案对比

cool-admin(midway版)提供了多种数据权限过滤方案，适用于不同业务场景：

方案一：基于部门的权限过滤

实现位置：BaseSysDepartmentService

核心特点：根据用户所属部门限制数据访问范围，适合层级分明的组织架构。

使用场景：企业内部管理系统，如人力资源、财务数据等按部门隔离的场景。

实现代码参考：

// 部门服务 ./src/modules/base/service/sys/department.ts

方案二：基于角色的权限过滤

实现位置：BaseSysRoleService

核心特点：通过角色分配不同数据访问权限，一个用户可拥有多个角色。

使用场景：需要跨部门数据访问的场景，如管理层查看多部门数据。

关键方法：

// 更新角色权限 async updatePerms(roleId, menuIdList?, departmentIds = []) { // 角色权限更新逻辑 }

方案三：混合权限过滤

实现位置：BaseSysLoginService

核心特点：结合角色和部门权限，提供更精细的数据控制。

使用场景：复杂企业应用，需要同时考虑角色和部门维度的权限控制。

实现逻辑：

// 登录时获取用户权限信息 const roleIds = await this.baseSysRoleService.getByUser(user.id); const departments = await this.baseSysDepartmentService.getByRoleIds(roleIds);

数据权限过滤的最佳实践

1. 权限缓存策略

系统采用缓存机制提升权限检查性能：

// 缓存用户部门权限 await this.midwayCache.set(`admin:department:${userId}`, departments);

2. 权限设计建议

• 为管理员角色设置全部门访问权限
• 普通用户按最小权限原则分配部门权限
• 定期清理权限缓存，确保权限变更及时生效

3. 权限检查中间件

虽然未在中间件目录中找到直接的权限过滤中间件，但可参考UserMiddleware实现自定义权限检查：

// 用户中间件参考 ./src/modules/user/middleware/app.ts

总结

cool-admin(midway版)提供了灵活且强大的数据权限过滤机制，通过角色-部门关联模型实现了多维度的权限控制。开发者可根据实际业务需求选择合适的权限过滤方案，或组合使用多种方案以达到更精细的数据访问控制。系统的权限设计遵循了模块化和插件化原则，便于扩展和定制，是构建企业级后台系统的理想选择。

通过合理配置角色权限[./src/modules/base/entity/sys/role.ts]和部门关系[./src/modules/base/entity/sys/department.ts]，可以快速实现复杂的权限需求，保护敏感数据安全。

【免费下载链接】cool-admin-midway🔥 cool-admin(midway版)一个很酷的后台权限管理框架，模块化、插件化、CRUD极速开发，永久开源免费，基于midway.js 3.x、typescript、typeorm、mysql、jwt、vue3、vite、element-ui等构建项目地址: https://gitcode.com/gh_mirrors/co/cool-admin-midway