一、项目简介本系统是一套基于 SpringBoot2 Vue3 MySQL 的前后端分离台球厅综合管理平台覆盖前台展示、会员自助、服务员操作、管理员后台四大应用场景。系统内置 JWT 身份认证与拦截器鉴权支持球桌计时计费、商品销售、会员储值、预约管理、财务报表导出等核心业务。系统分为三种角色普通用户会员可浏览球桌、选购商品、管理个人订单与预约服务员负责开台、加购商品、结账等日常运营操作管理员则统筹球桌、商品、会员、订单、预约、轮播图及财务报表的全量管理。二、技术栈技术说明后端框架SpringBoot 2.xORM 框架MyBatis-Plus含分页插件、逻辑删除、字段自动填充权限认证JWTjjwt 自定义拦截器前端框架Vue 3Composition API状态管理PiniaUI 组件库Element Plus构建工具Vite路由管理Vue Router含路由守卫数据库MySQL 8.xExcel 导出Apache POIXSSFWorkbook工具库HutoolMD5 加密三、功能模块管理员端仪表盘统计展示订单总数、今日订单数、累计营业额、今日营业额、会员总数等核心经营指标以卡片形式呈现。球桌管理分页查询球桌列表支持按类型/状态筛选可新增、编辑、删除球桌配置散客价、会员价、类型、图片及描述信息。球桌状态修改直接切换球桌状态空闲/使用中/已预约/维护用于人工干预特殊场景如临时锁台或应急释放。商品管理分页查询商品列表支持按分类/关键词筛选可新增、编辑、删除商品维护名称、分类、售价、成本价、库存及上下架状态。订单管理分页查询全部订单支持按状态/订单号/会员/球桌筛选可查看订单详情及商品明细支持取消进行中的订单。会员管理分页查询会员列表支持按角色/关键词筛选可新增会员、编辑会员资料姓名/手机号/头像、删除会员。会员充值为指定会员执行充值操作输入充值金额、赠送金额、支付方式自动更新余额并生成充值记录。服务员管理分页查询服务员账号可新增、编辑、删除服务员统一管理员工账号信息。预约管理分页查询全部预约单支持按状态/会员筛选确认预约后球桌状态自动变为已预约取消或完成后自动释放球桌。轮播图管理维护首页轮播图配置标题、图片、跳转链接、排序号、启用状态支持新增、编辑、删除。充值记录查询分页查看会员充值流水展示充值金额、赠送金额、余额快照、支付方式及操作员信息。财务报表导出一键导出已结算订单 Excel 报表包含订单号、球桌、会员、台费、商品费、总金额、优惠、实付、支付方式、时间等字段。普通用户端用户注册填写用户名、密码、真实姓名、手机号完成注册密码经 MD5 加密存储注册成功自动跳转登录页。用户登录输入用户名和密码进行登录校验通过后签发 JWT Token并返回用户基本信息密码字段置空。首页轮播图展示启用状态status1的轮播图列表按 sortOrder 升序排列支持跳转链接配置。球桌浏览查看全部球桌列表按桌号升序展示球桌类型、散客价/会员价、当前状态空闲/使用中/已预约/维护。商品选购按分类浏览上架商品status1展示商品名称、分类、售价、库存、图片及描述。球桌状态统计查看球桌总数及空闲、使用中、已预约、维护中的数量分布便于快速判断可用资源。会员余额查询登录会员可查看个人账户余额及历史充值记录。会员订单查询查看个人历史开台订单列表包含订单号、球桌、台费、商品费、实付金额、支付方式等。会员预约管理提交球桌预约申请选择日期、时间段、球桌查看预约状态待确认/已确认/已取消/已完成。服务员端球桌状态看板以卡片形式查看所有球桌实时状态区分空闲、使用中、已预约、维护四种状态便于快速定位可用球桌。开台操作选择空闲球桌支持关联会员可选和服务员开台后球桌状态自动变为使用中并生成进行中订单。订单商品加购对进行中的订单添加商品输入商品和数量自动扣减库存并计算小计金额。订单商品删除删除进行中的订单商品项自动回补库存并重新计算商品费用。结账操作选择支付方式现金/微信/支付宝/余额可输入优惠金额系统自动计算台费按散客价或会员价、商品费、总金额、实付金额。余额支付校验选择余额支付时自动校验会员余额是否充足扣款成功后同步更新会员余额。取消订单对进行中的订单执行取消操作订单状态变更为已取消球桌自动释放为空闲。四、项目总结本项目的技术亮点在于完整覆盖了台球厅运营的核心业务闭环从会员自助查询、服务员开台结账到管理员全量管控三端角色权限清晰、数据联动一致。JWT 认证 拦截器鉴权保证了接口安全MyBatis-Plus 的分页与逻辑删除简化了数据层开发前端 Vue3 Pinia Element Plus 的组合提供了良好的交互体验和状态管理能力。财务报表导出功能直接满足实际经营场景的结算需求。整套系统前后端分离、代码结构规范适合作为 SpringBoot2 Vue3 全栈项目的学习案例也可直接作为台球厅或类似计时计费场所如棋牌室、网咖的二次开发基础。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K335
