GogoAI连锁自助健身方案，总部后台权限管理实现

GogoAI连锁自助健身方案总部后台权限管理实现痛点分析连锁自助健身采用总部统一管控、门店独立运营模式权限管控很容易出现两类问题要么权限放得太宽店长可以查看其他门店营收、会员数据造成数据泄露要么管控过死所有配置都需要总部操作运营效率低下。传统RBAC只控制菜单和接口缺少门店维度的数据隔离新增区域经理、督导、门店教练这类角色时扩展麻烦。权限变更之后缓存不及时失效出现权限延迟生效缺少操作审计谁修改卡种、调整套餐、解锁门禁没有可追溯记录。部分敏感接口没有做二次校验前端隐藏菜单后依然可以通过接口直接访问其他门店数据。GogoAI连锁自助健身后台在RBAC基础上扩展数据权限范围区分功能权限和门店数据权限支持总部、区域、门店三级权限适配连锁品牌分级管理的诉求。整体权限模型设计后端基于Spring Boot开发采用RBAC数据范围的权限模型。用户绑定角色角色绑定菜单、接口功能权限同时给用户分配可访问门店集合。权限分为两层功能权限控制能不能点菜单、调用接口数据权限控制能看到哪些门店的数据。预设几类基础角色超级管理员全部门店、全部功能、总部运营全部门店仅运营配置、区域经理指定片区门店、门店店长仅本店、门店教练本店会员、核销权限。核心数据表sys_user用户表、sys_role角色表、sys_menu菜单权限表、sys_user_role用户角色关联、sys_role_menu角色权限关联、sys_user_store用户门店关联表。登录后权限信息存入Redis缓存减少数据库频繁查询。数据权限拦截核心Java实现自定义注解标记需要门店数据隔离的接口通过AOP切面自动注入门店过滤条件防止越权查询。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface DataScope { // 是否开启门店数据过滤 boolean storeFilter() default true; }Aspect Component Slf4j public class DataScopeAspect { Autowired private HttpServletRequest request; Autowired private UserContext userContext; Before(annotation(dataScope)) public void doBefore(DataScope dataScope) { LoginUser loginUser userContext.getLoginUser(); if(!dataScope.storeFilter() || loginUser.isSuperAdmin()){ return; } ListLong storeIdList loginUser.getStoreIdList(); if(CollectionUtils.isEmpty(storeIdList)){ throw new ServiceException(当前账号没有可访问门店); } // 将门店列表放入线程上下文MyBatis拦截器拼接SQL条件 store_id in (xxx) DataScopeContextHolder.setStoreIds(storeIdList); } }Service public class StoreMemberService { DataScope public PageMemberVO pageMember(MemberQuery query){ return memberMapper.selectPage(query); } }通过ThreadLocal传递门店ID集合MyBatis拦截器统一拼接过滤条件不需要每个业务接口手动写门店判断逻辑减少重复代码和漏写校验的风险。登录鉴权与权限缓存用户登录成功后生成JWT令牌令牌内存储用户ID不存放门店和权限列表。每次接口请求解析token从Redis读取该用户的菜单权限、可访问门店集合。修改角色、调整门店权限之后主动清理该用户的权限缓存保证权限即时生效不需要用户重新登录。网关层统一拦截未登录请求接口内部使用注解校验功能权限例如PreAuthorize(hasPerm(store:card:edit))控制卡种编辑权限。功能权限和数据权限双重校验就算绕过前端菜单也无法访问无权限的接口和数据。分级管理策略总部管理员可以新增门店、配置全局卡模板、统一营销活动、查看所有门店财务和安防数据可以给门店账号分配角色和门店范围但不能直接重置其他总部管理员权限。 区域经理绑定一片区域的多家门店只能查看分配范围内门店数据无法新增门店不能修改总部全局配置。 门店店长仅能操作本店会员、预约、套餐、门禁记录看不到其他门店营收可以给本店教练分配账号但无法跨门店查看会员信息。 教练角色权限进一步收缩只保留会员查看、到场核销、签到登记没有财务、套餐定价、安防配置权限。后台支持自定义角色运营可以新增“财务专员”“安防运维”这类角色勾选需要的菜单权限再分配门店范围不用开发新增角色。敏感操作审计日志卡种修改、套餐价格变更、远程开门、会员余额调整、权限变更都属于高危操作无论成功失败自动记录审计日志。日志包含操作人、IP、门店ID、操作类型、操作前后对比、请求参数后台支持按门店、操作人员检索。审计日志异步投递消息队列写入数据库避免影响主接口响应。发生数据纠纷、异常开门事件时可以快速回溯是谁、在什么时间做的操作。权限联动与业务隔离权限模块和前面的购卡预约、时段计费、安防预警、财务分账模块联动。店长登录后首页看板自动只展示本店客流、营收、告警总部登录支持多门店汇总报表、门店对比。硬件设备权限同样隔离门店账号只能查看本店门禁、摄像头、传感器设备无法查看其他门店安防设备状态。套餐、卡模板区分全局模板和门店私有模板总部模板下发到门店门店私有模板仅本店可见。权限安全优化禁止前端传递storeId作为查询条件所有数据来源以登录上下文的门店集合为准防止前端篡改参数越权查询。敏感操作增加二次验证远程开门、批量调整会员余额需要短信验证码校验。密码策略、登录失败锁定、单点登录控制统一在权限模块实现同一个账号不支持多地点同时在线异地登录会踢掉之前会话。后台支持账号临时冻结门店人员离职时一键冻结自动清除缓存权限。落地效果总结这套分级权限方案落地GogoAI连锁自助健身系统之后解决了连锁模式下数据越权、角色扩展困难、权限变更延迟的问题。功能权限门店数据权限双层隔离既能满足总部统一标准化管理又给到门店独立运营的空间。权限配置可视化新增门店、新增岗位角色由运营人员在后台完成不需要开发改代码。审计日志留存所有高危操作记录降低连锁门店的数据安全风险和会员、计费、安防、财务模块一起形成完整的连锁自助健身管控闭环。