健身房系统项目:会员端+教练端+管理后台整体架构设计方案
健身房系统包含会员自助预约、教练排课授课、后台运营管控三大角色,不同端的业务诉求、并发特征、权限体系差异较大。会员端偏向自助购卡、约课、扫码通行;教练端聚焦课表查看、签到核销、学员管理;管理后台负责门店、卡种、财务、人员、设备的统一管控。如果多端共用一套臃肿接口,容易出现权限越权、接口互相影响、迭代困难等问题。本文围绕三端分离架构,讲解分层设计、模块划分、权限隔离、数据流转方案,附带核心Java代码,适合连锁健身房项目落地参考。
一、项目多端业务痛点
在项目初期一体化开发模式下,会暴露出不少问题。
会员端访问量大,高峰期集中在晚间预约时段,教练端和后台低频查询报表、导出数据,重SQL查询容易拖慢会员端接口;权限边界模糊,存在教练查看财务数据、普通会员访问后台接口的风险;课时资源属于竞争资源,多人同时预约同一课程容易出现超约;消息分散,课程提醒、上课通知、教练工单没有统一推送通道;IoT门禁、储物柜和课务模块耦合,新增门店或者硬件时改动范围大。
单纯依靠前端隐藏按钮无法保障安全,必须从架构层面做隔离,把业务按领域拆分,统一鉴权、统一资源竞争控制。
二、整体分层架构设计
整体采用网关统一接入 + 领域服务拆分 + 中间件支撑的前后端分离架构。
接入层:包含会员小程序、教练H5、PC管理后台,所有请求统一经过API网关,网关完成鉴权、限流、路由、日志记录。
业务服务层拆分为多个独立模块:会员服务、课程排课服务、教练服务、营销卡券服务、财务对账服务、IoT门禁服务。服务之间通过Feign调用,核心异步流程使用消息队列解耦。
存储层:MySQL存储订单、会员、课程、教练、财务等持久化数据;Redis用于缓存卡状态、课时锁、接口限流、会话信息;MQTT对接IoT硬件,消息队列处理课程通知、核销异步记录。
所有端共用一套数据源,但是通过网关和业务权限层做数据隔离,教练只能操作自己的课程,会员只能查看自己的订单和约课记录,后台拥有全门店管理权限。
三、三大端能力边界划分
会员端:门店浏览、卡种购买、课程预约、课时查看、扫码通行门禁、订单查询、消息通知、评价。
教练端:个人课表、学员名单、课程签到、课时核销、学员评价查看、提交请假调课申请。教练端不开放卡种配置、财务报表、门店设置能力。
管理后台:门店管理、卡种套餐配置、教练信息管理、课程编排、订单对账、流水导出、设备管理、告警查看、角色权限配置。
四、核心权限与课时预约代码实现
@Service
public class GymCourseService {
@Autowired
private StringRedisTemplate redisTemplate;
@Autowired
private RedissonClient redissonClient;
@Autowired
private CourseScheduleMapper scheduleMapper;
@Autowired
private MemberCourseRecordMapper recordMapper;
private static final String COURSE_LOCK_PREFIX = "gym:course:lock:";
@Transactional(rollbackFor = Exception.class)
public ResultDTO<String> reserveCourse(Long memberId, Long scheduleId) {
// 分布式锁,防止课程超约
RLock lock = redissonClient.getLock(COURSE_LOCK_PREFIX + scheduleId);
boolean lockOk = lock.tryLock(3, 10, TimeUnit.SECONDS);
if (!lockOk) {
return ResultDTO.fail("课程预约繁忙,请稍后重试");
}
try {
// 查询课程排期
CourseSchedule schedule = scheduleMapper.selectById(scheduleId);
if (schedule == null || !schedule.getStatus().equals("normal")) {
return ResultDTO.fail("课程排期不存在或已取消");
}
// 判断是否已经约满
if (schedule.getSignedCount() >= schedule.getMaxCount()) {
return ResultDTO.fail("课程名额已满");
}
// 校验会员是否拥有有效卡,支持该课程类型
boolean validCard = memberCardService.checkMemberCardValid(memberId, schedule.getCourseType());
if (!validCard) {
return ResultDTO.fail("没有可用健身卡,无法预约该课程");
}
// 新增预约记录,名额+1
MemberCourseRecord record = new MemberCourseRecord();
record.setMemberId(memberId);
record.setScheduleId(scheduleId);
record.setCoachId(schedule.getCoachId());
record.setReserveStatus(1);
recordMapper.insert(record);
schedule.setSignedCount(schedule.getSignedCount() + 1);
scheduleMapper.updateById(schedule);
// 清除课程缓存
redisTemplate.delete("gym:schedule:info:" + scheduleId);
return ResultDTO.success("预约成功,请按时上课");
} finally {
lock.unlock();
}
}
}
签到核销逻辑由教练端接口触发,接口会校验操作者是否为该课程绑定教练,避免其他教练随意核销他人课时。
五、网关鉴权与角色隔离策略
网关统一识别token,解析出用户身份、角色标识:MEMBER、COACH、ADMIN。
网关配置路由规则:
- MEMBER角色:仅允许访问会员相关接口;
- COACH角色:仅允许访问课表、签到、学员查看接口;
- ADMIN角色:放行后台管理接口。
接口内部二次校验数据归属,即使路由被绕过,也无法操作不属于自己的数据。token统一使用JWT,会话信息存入Redis,支持后台一键强制下线。
六、异步消息与IoT集成方案
课程预约成功、上课前提醒、课程取消,通过消息队列异步推送模板消息,不阻塞主业务流程。
IoT门禁服务独立部署,会员扫码通行时,单独调用IoT服务校验权限下发开门指令,和课程业务解耦。门禁通行日志、课时预约日志分开存储,便于分别做统计和对账。
七、缓存、限流与运维优化
会员端热门课程列表、门店信息、卡种配置做Redis缓存,降低数据库压力;网关对会员端预约接口做限流,避免整点预约时大量请求打垮服务。
教练端报表查询、后台导出功能,走异步任务,不使用同步接口返回,防止长查询占用连接。
日志统一收集,区分三端请求来源,便于定位是会员端、教练端还是后台产生的异常。
八、测试验证重点场景
测试场景:会员预约课程,名额正常扣减,并发预约不会超员;教练只能看到分配给自己的课程,不能修改卡种价格;管理员后台可以调整课程名额,变更后三端同步刷新;不同角色token越权访问接口被拦截;课程取消后名额自动释放,会员课时状态同步更新。
总结
这套健身房三端架构方案,核心思路是接入网关做统一鉴权限流,按业务领域拆分服务,严格区分会员、教练、管理员的权限边界,使用分布式锁控制课程预约这类竞争资源,消息队列处理通知类异步任务。会员、教练、后台共享核心数据,但是接口和操作权限隔离,兼顾开发效率和系统稳定性。该架构支持单店使用,也可以横向扩展到连锁门店,后续新增私教、团课、体能测评等功能时,在对应领域模块扩展即可。落地时重点做好角色权限二次校验、课时并发控制、慢查询隔离,保障高峰预约时段系统稳定。