一、项目简介本系统是一套基于 Spring Boot 3 Vue 3 MySQL 的游戏化健身打卡系统采用前后端分离架构。后端提供 RESTful API前端为单页应用。系统包含普通用户端、管理员端两大角色通过积分、等级、徽章、成就、团队挑战等游戏化机制激励用户坚持健身打卡。用户可自定义健身计划、每日打卡记录、参与团队挑战、维护好友关系管理员则通过数据大屏和后台管理模块对全站用户、计划、徽章、成就、团队、挑战、等级配置进行统一管理。整体功能闭环覆盖了从运动记录到社交激励的完整链路适合作为毕业设计或 Spring Boot 3 Vue 3 全栈项目学习参考。二、技术栈技术说明后端框架Spring Boot 3.xORMMyBatis-Plus权限认证Spring Security JWT前端框架Vue 3状态管理Pinia路由管理Vue Router构建工具Vite数据库MySQL文件存储本地文件系统三、功能模块管理员端用户管理分页查看用户列表支持按用户名/昵称模糊搜索按创建时间倒序展示。用户状态管理启用或禁用用户账号禁用后该用户无法登录系统。用户信息编辑修改用户昵称、角色、状态、等级、经验、积分、邮箱、手机号等字段。新增用户手动创建用户设置初始密码默认 123456可指定等级、经验、积分等初始值。删除用户永久删除指定用户账号及其关联数据。健身计划管理分页查看计划列表创建系统计划编辑计划信息软删除计划状态置 0。徽章管理查看、创建、编辑、删除徽章维护徽章名称、图标与获取条件。成就管理查看、创建、编辑、删除成就维护成就描述与完成条件。团队管理查看所有团队列表创建团队编辑团队信息删除团队。挑战管理查看所有挑战列表创建挑战编辑挑战信息删除挑战。等级配置管理按等级升序查看等级配置创建新等级编辑等级经验要求删除等级。管理员仪表盘展示总用户数、活跃用户数、总计划数、总团队数、总打卡数、今日打卡数。近 7 天打卡趋势以图表形式展示最近 7 天每日打卡数量。积分 TOP5 用户查看全站积分最高的前 5 名用户。数据大屏展示总用户数、总打卡数、总团队数、活跃挑战数近 30 天打卡趋势积分/打卡/团队排行榜热门计划列表。普通用户端注册/登录通过用户名密码注册新账号登录后获取 JWT Token 用于接口鉴权。个人资料管理查看和修改昵称、邮箱、手机号、头像头像支持图片文件上传。每日健身打卡选择运动类型、输入运动时长分钟和消耗卡路里填写心情和备注可上传运动图片。打卡结果展示打卡后即时返回基础积分10 分起和基础经验5 点起运动超 30 分钟或消耗超 200 卡路里获得额外奖励。连续打卡统计查看今日是否已打卡系统自动记录连续打卡天数、总打卡次数连续天数突破历史最高值自动更新。打卡日历按年月查看打卡日历日历上标记已打卡日期展示当月打卡总数和月度天数。打卡记录列表分页查看个人历史打卡记录按时间倒序排列。打卡统计图表查看近 7 天打卡趋势统计以及各运动类型的分布统计。健身计划浏览分页查看系统推荐的健身计划列表支持按分类和难度筛选。智能计划推荐根据用户历史数据获取个性化推荐计划默认推荐 4 条。加入健身计划选择计划加入系统记录计划进度当前天数每日打卡自动推进计划天数。查看我的计划查看已加入的所有计划列表以及当前正在进行的计划。计划任务管理查看计划下的具体任务列表支持创建、修改、删除自定义任务。创建自定义计划填写计划名称、分类、难度、描述并添加任务列表。完成/放弃计划手动标记计划为已完成或已放弃。重置计划进度重置指定计划当前天数为第 1 天并删除该计划下的所有打卡记录。删除自定义计划删除自己创建的非系统计划。个人仪表盘概览个人信息、近 7 天打卡趋势、运动类型分布、今日打卡状态、已获得徽章数/总徽章数。等级与经验根据经验值自动升级可查看所有等级配置等级序号、所需经验、等级名称。积分排行榜查看全站用户按总积分排名的榜单默认前 10 名。打卡次数排行榜查看全站用户按总打卡次数排名的榜单默认前 10 名。等级排行榜查看全站用户按等级排名的榜单默认前 10 名。个人统计数据查看个人总积分、总经验、等级、总打卡数、连续打卡数、最大连续打卡数等统计。好友管理查看好友列表、发送好友请求按用户 ID 或用户名搜索、接受/拒绝好友请求、删除好友。团队浏览分页查看所有团队列表查看团队详情和团队成员列表。创建团队填写团队名称、描述、最大人数创建者自动成为队长。加入/退出团队申请加入团队或退出已加入的团队。解散团队队长解散自己创建的团队。我的团队查看当前用户加入的所有团队。团队排行榜查看按团队总积分排名的榜单默认前 10 名。挑战列表分页查看所有挑战支持按状态筛选进行中/已完成。创建挑战设置目标值、积分奖励等创建者自动加入挑战。加入/退出挑战参与公开挑战或退出已参与的挑战创建者不能退出只能删除。挑战打卡在挑战中打卡按进度值推进每次打卡获得积分奖励至少 5 分按进度/2 计算。挑战详情与参与者查看挑战详情及参与者列表按进度降序排列。修改/删除挑战创建者可以修改挑战信息或删除挑战。我的挑战查看当前用户参与的所有挑战。徽章系统查看所有可获得的徽章列表以及个人已获得的徽章及获得时间。成就系统查看所有成就列表个人成就进度和完成状态手动同步成就进度。文件上传通用文件上传接口支持任意文件类型返回可访问的文件 URL。四、项目总结本项目的技术亮点在于将游戏化激励体系积分、等级、徽章、成就、团队挑战完整落地到健身打卡业务中后端基于 Spring Boot 3 与 MyBatis-Plus 实现了清晰的分层架构权限模块采用 Spring Security JWT 保障接口安全前端使用 Vue 3 Pinia Vite 构建了组件化的单页应用配合 ECharts 完成仪表盘与数据大屏的可视化展示。项目覆盖了从用户注册、打卡记录、计划管理、社交好友、团队协作到管理员后台的全流程功能接口设计规范、模块边界清晰适合作为 Spring Boot 3 Vue 3 前后端分离项目的实战学习与二次开发基础。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K298