一、项目简介FitPro 智能健身房管理系统是一套基于 Spring Boot 2 Vue 3 的前后端分离项目面向健身房日常运营场景覆盖会员卡管理、课程预约、教练排班、设备维护、训练计划、消费记录、数据统计等核心业务。系统内置管理员、前台、教练、会员四种角色各角色拥有独立的功能入口与操作边界。后端提供 RESTful API 供前端调用前端通过 Vue Router 管理路由、Vuex 管理全局状态整体结构清晰适合作为毕业设计、课程设计或 Java 全栈开发的学习与二次开发参考。二、技术栈技术说明后端框架Spring Boot 2.xORMMyBatis Plus权限认证JWT无状态 Token 鉴权前端框架Vue 3Composition API状态管理Vuex 4前端构建Vue CLI / ViteUI 组件库Element PlusHTTP 客户端Axios数据库MySQL 5.7文件存储本地文件上传头像文档Swagger / Knife4j 接口文档三、功能模块管理员端仪表盘数据统计展示会员总数、教练总数、总预约数、已确认预约数、设备总数、设备损坏数、设备维护中数、课程总数、有效会员卡数等核心运营指标便于管理者快速掌握系统运行状态。人员管理查看所有用户列表支持按角色ADMIN/STAFF/COACH/MEMBER和关键词姓名/用户名/手机号筛选分页展示支持新增用户检查用户名唯一性、编辑用户修改姓名、手机号、邮箱、角色等不可改密码、删除用户、启用/禁用用户禁用后无法登录。会员管理按角色 MEMBER 筛选查看会员列表支持关键词搜索可延长指定会员卡的有效期修改结束日期并将卡状态置为有效。设备管理查看设备列表支持按名称/分类关键词、设备状态NORMAL/FAULT/MAINTENANCE筛选支持新增设备填写名称、分类、位置、购买日期、维护周期、编辑、删除设备。设备维护记录按设备 ID 查看维护历史按维护日期倒序展示维护内容、费用、操作人添加维护记录时自动更新设备的上次/下次维护日期并将设备状态置为 NORMAL。课程管理查看课程列表支持按课程类型、名称关键词筛选支持新增课程课程名称、类型、教练、封面、描述、最大人数、时长、编辑课程。排班管理查看所有课程排班按日期和开始时间升序排列展示课程名称与教练姓名支持新增排班选择课程、教练、日期、起止时间、最大人数初始人数为 0状态为 1、编辑、删除排班。轮播图管理查看轮播图列表按排序字段升序支持新增标题、图片 URL、链接 URL、排序、状态、编辑、删除轮播图用于控制首页展示内容。普通用户端首页轮播图展示按状态与排序字段获取活跃轮播图用于首页推广位展示。公开课程浏览查看课程列表支持按课程类型、名称关键词筛选分页展示课程封面、简介、教练等信息。未来 7 天可预约排班按日期范围筛选仅显示状态为 1 的课程排班供未登录用户了解近期课程安排。注册与登录支持用户名密码注册注册时自动赋予 MEMBER 角色禁止注册管理员账号登录后获取 JWT Token。个人信息管理查看当前登录用户的基本资料、头像、角色支持修改真实姓名、手机号、邮箱、性别等字段不可修改密码与角色。修改密码需验证原密码正确后将密码更新为新密码。头像上传通过文件上传接口上传图片返回图片 URL 并更新用户头像字段。会员端会员卡信息查看获取当前有效的会员卡展示卡类型、起止日期、金额、状态另可查看所有历史会员卡记录按创建时间倒序排列。课程排班浏览与预约默认展示未来 7 天可预约排班支持自定义日期范围选择排班 ID 创建预约成功后排班当前人数 1满员时排班状态自动置为 0不可预约。取消预约仅允许取消自己未取消、未完成的预约取消后排班人数 -1 并恢复状态为 1。我的预约记录按创建时间倒序展示预约列表含课程名称、教练姓名、排班日期、起止时间、状态PENDING/CONFIRMED/COMPLETED/CANCELLED。训练计划查看与反馈查看教练为自己制定的训练计划列表含教练姓名、计划标题、内容、反馈可对指定计划提交文字反馈。消费记录查询按创建时间倒序展示个人消费记录含类型CARD/COURSE/OTHER、金额、描述、操作人。教练端我的课程排班按教练 ID 筛选查看自己的排班支持按开始/结束日期范围查询默认展示未来 14 天。我的课程列表查看自己负责的课程仅显示状态为 1 的课程。预约记录管理查看与自己排班相关的预约记录分页展示会员姓名、课程名称、预约状态、排班日期可执行确认预约PENDING → CONFIRMED和完成预约→ COMPLETED操作。训练计划管理查看自己制定的训练计划列表按教练 ID 筛选含会员姓名、标题、内容、反馈支持创建训练计划为指定会员设置标题、内容状态默认为 1、编辑已创建的计划。会员列表查看按角色 MEMBER 筛选支持按姓名/用户名/手机号关键词搜索分页展示会员信息便于教练选择训练计划对象。前台端会员列表查看与注册按角色 MEMBER 筛选查看会员支持关键词搜索可注册新会员创建时自动赋予 MEMBER 角色并检查用户名唯一性。会员卡办理为指定会员创建会员卡填写卡类型、起止日期、金额办理成功后自动生成一条消费记录类型为 CARD描述为“XX卡办理”。会员卡续费延长指定会员卡的有效期增加卡内金额续费成功后自动生成消费记录描述为“会员卡续费”。会员卡列表查询分页展示所有会员卡含会员用户名、真实姓名、卡类型、起止日期、金额、状态。预约记录管理分页查看所有预约记录含会员姓名、课程名称、教练姓名、排班日期、预约状态可确认预约PENDING → CONFIRMED。可预约排班查看默认展示未来 7 天、状态为 1 的课程排班供前台引导会员选课。四、项目总结本项目技术选型主流Spring Boot 2 MyBatis Plus Vue 3 Element Plus 的组合在中小型管理系统开发中非常典型。业务模块划分清晰四种角色权限边界明确覆盖了健身房运营的核心链路。代码结构上后端按 Controller-Service-Mapper 分层前端按视图组件 Vuex 管理状态适合初学者理解前后端交互、JWT 鉴权、文件上传、数据统计等常见开发场景。同时项目内置了完整的业务逻辑如预约满员自动置位、办卡自动生成消费记录、设备维护自动更新日期等具备一定的业务深度可直接作为课程设计或企业级项目的二次开发底座。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K282 SpringBoot2+Vue3+MySQL健身房管理系统源码 前后端分离实战项目
一、项目简介FitPro 智能健身房管理系统是一套基于 Spring Boot 2 Vue 3 的前后端分离项目面向健身房日常运营场景覆盖会员卡管理、课程预约、教练排班、设备维护、训练计划、消费记录、数据统计等核心业务。系统内置管理员、前台、教练、会员四种角色各角色拥有独立的功能入口与操作边界。后端提供 RESTful API 供前端调用前端通过 Vue Router 管理路由、Vuex 管理全局状态整体结构清晰适合作为毕业设计、课程设计或 Java 全栈开发的学习与二次开发参考。二、技术栈技术说明后端框架Spring Boot 2.xORMMyBatis Plus权限认证JWT无状态 Token 鉴权前端框架Vue 3Composition API状态管理Vuex 4前端构建Vue CLI / ViteUI 组件库Element PlusHTTP 客户端Axios数据库MySQL 5.7文件存储本地文件上传头像文档Swagger / Knife4j 接口文档三、功能模块管理员端仪表盘数据统计展示会员总数、教练总数、总预约数、已确认预约数、设备总数、设备损坏数、设备维护中数、课程总数、有效会员卡数等核心运营指标便于管理者快速掌握系统运行状态。人员管理查看所有用户列表支持按角色ADMIN/STAFF/COACH/MEMBER和关键词姓名/用户名/手机号筛选分页展示支持新增用户检查用户名唯一性、编辑用户修改姓名、手机号、邮箱、角色等不可改密码、删除用户、启用/禁用用户禁用后无法登录。会员管理按角色 MEMBER 筛选查看会员列表支持关键词搜索可延长指定会员卡的有效期修改结束日期并将卡状态置为有效。设备管理查看设备列表支持按名称/分类关键词、设备状态NORMAL/FAULT/MAINTENANCE筛选支持新增设备填写名称、分类、位置、购买日期、维护周期、编辑、删除设备。设备维护记录按设备 ID 查看维护历史按维护日期倒序展示维护内容、费用、操作人添加维护记录时自动更新设备的上次/下次维护日期并将设备状态置为 NORMAL。课程管理查看课程列表支持按课程类型、名称关键词筛选支持新增课程课程名称、类型、教练、封面、描述、最大人数、时长、编辑课程。排班管理查看所有课程排班按日期和开始时间升序排列展示课程名称与教练姓名支持新增排班选择课程、教练、日期、起止时间、最大人数初始人数为 0状态为 1、编辑、删除排班。轮播图管理查看轮播图列表按排序字段升序支持新增标题、图片 URL、链接 URL、排序、状态、编辑、删除轮播图用于控制首页展示内容。普通用户端首页轮播图展示按状态与排序字段获取活跃轮播图用于首页推广位展示。公开课程浏览查看课程列表支持按课程类型、名称关键词筛选分页展示课程封面、简介、教练等信息。未来 7 天可预约排班按日期范围筛选仅显示状态为 1 的课程排班供未登录用户了解近期课程安排。注册与登录支持用户名密码注册注册时自动赋予 MEMBER 角色禁止注册管理员账号登录后获取 JWT Token。个人信息管理查看当前登录用户的基本资料、头像、角色支持修改真实姓名、手机号、邮箱、性别等字段不可修改密码与角色。修改密码需验证原密码正确后将密码更新为新密码。头像上传通过文件上传接口上传图片返回图片 URL 并更新用户头像字段。会员端会员卡信息查看获取当前有效的会员卡展示卡类型、起止日期、金额、状态另可查看所有历史会员卡记录按创建时间倒序排列。课程排班浏览与预约默认展示未来 7 天可预约排班支持自定义日期范围选择排班 ID 创建预约成功后排班当前人数 1满员时排班状态自动置为 0不可预约。取消预约仅允许取消自己未取消、未完成的预约取消后排班人数 -1 并恢复状态为 1。我的预约记录按创建时间倒序展示预约列表含课程名称、教练姓名、排班日期、起止时间、状态PENDING/CONFIRMED/COMPLETED/CANCELLED。训练计划查看与反馈查看教练为自己制定的训练计划列表含教练姓名、计划标题、内容、反馈可对指定计划提交文字反馈。消费记录查询按创建时间倒序展示个人消费记录含类型CARD/COURSE/OTHER、金额、描述、操作人。教练端我的课程排班按教练 ID 筛选查看自己的排班支持按开始/结束日期范围查询默认展示未来 14 天。我的课程列表查看自己负责的课程仅显示状态为 1 的课程。预约记录管理查看与自己排班相关的预约记录分页展示会员姓名、课程名称、预约状态、排班日期可执行确认预约PENDING → CONFIRMED和完成预约→ COMPLETED操作。训练计划管理查看自己制定的训练计划列表按教练 ID 筛选含会员姓名、标题、内容、反馈支持创建训练计划为指定会员设置标题、内容状态默认为 1、编辑已创建的计划。会员列表查看按角色 MEMBER 筛选支持按姓名/用户名/手机号关键词搜索分页展示会员信息便于教练选择训练计划对象。前台端会员列表查看与注册按角色 MEMBER 筛选查看会员支持关键词搜索可注册新会员创建时自动赋予 MEMBER 角色并检查用户名唯一性。会员卡办理为指定会员创建会员卡填写卡类型、起止日期、金额办理成功后自动生成一条消费记录类型为 CARD描述为“XX卡办理”。会员卡续费延长指定会员卡的有效期增加卡内金额续费成功后自动生成消费记录描述为“会员卡续费”。会员卡列表查询分页展示所有会员卡含会员用户名、真实姓名、卡类型、起止日期、金额、状态。预约记录管理分页查看所有预约记录含会员姓名、课程名称、教练姓名、排班日期、预约状态可确认预约PENDING → CONFIRMED。可预约排班查看默认展示未来 7 天、状态为 1 的课程排班供前台引导会员选课。四、项目总结本项目技术选型主流Spring Boot 2 MyBatis Plus Vue 3 Element Plus 的组合在中小型管理系统开发中非常典型。业务模块划分清晰四种角色权限边界明确覆盖了健身房运营的核心链路。代码结构上后端按 Controller-Service-Mapper 分层前端按视图组件 Vuex 管理状态适合初学者理解前后端交互、JWT 鉴权、文件上传、数据统计等常见开发场景。同时项目内置了完整的业务逻辑如预约满员自动置位、办卡自动生成消费记录、设备维护自动更新日期等具备一定的业务深度可直接作为课程设计或企业级项目的二次开发底座。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K282