一、項(xiàng)目簡(jiǎn)介本系統(tǒng)是一套基于 SpringBoot2 Vue3 MySQL 的前后端分離臺(tái)球廳綜合管理平臺(tái)覆蓋前臺(tái)展示、會(huì)員自助、服務(wù)員操作、管理員后臺(tái)四大應(yīng)用場(chǎng)景。系統(tǒng)內(nèi)置 JWT 身份認(rèn)證與攔截器鑒權(quán)支持球桌計(jì)時(shí)計(jì)費(fèi)、商品銷售、會(huì)員儲(chǔ)值、預(yù)約管理、財(cái)務(wù)報(bào)表導(dǎo)出等核心業(yè)務(wù)。系統(tǒng)分為三種角色普通用戶會(huì)員可瀏覽球桌、選購商品、管理個(gè)人訂單與預(yù)約服務(wù)員負(fù)責(zé)開臺(tái)、加購商品、結(jié)賬等日常運(yùn)營(yíng)操作管理員則統(tǒng)籌球桌、商品、會(huì)員、訂單、預(yù)約、輪播圖及財(cái)務(wù)報(bào)表的全量管理。二、技術(shù)棧技術(shù)說明后端框架SpringBoot 2.xORM 框架MyBatis-Plus含分頁插件、邏輯刪除、字段自動(dòng)填充權(quán)限認(rèn)證JWTjjwt 自定義攔截器前端框架Vue 3Composition API狀態(tài)管理PiniaUI 組件庫Element Plus構(gòu)建工具Vite路由管理Vue Router含路由守衛(wèi)數(shù)據(jù)庫MySQL 8.xExcel 導(dǎo)出Apache POIXSSFWorkbook工具庫HutoolMD5 加密三、功能模塊管理員端儀表盤統(tǒng)計(jì)展示訂單總數(shù)、今日訂單數(shù)、累計(jì)營(yíng)業(yè)額、今日營(yíng)業(yè)額、會(huì)員總數(shù)等核心經(jīng)營(yíng)指標(biāo)以卡片形式呈現(xiàn)。球桌管理分頁查詢球桌列表支持按類型/狀態(tài)篩選可新增、編輯、刪除球桌配置散客價(jià)、會(huì)員價(jià)、類型、圖片及描述信息。球桌狀態(tài)修改直接切換球桌狀態(tài)空閑/使用中/已預(yù)約/維護(hù)用于人工干預(yù)特殊場(chǎng)景如臨時(shí)鎖臺(tái)或應(yīng)急釋放。商品管理分頁查詢商品列表支持按分類/關(guān)鍵詞篩選可新增、編輯、刪除商品維護(hù)名稱、分類、售價(jià)、成本價(jià)、庫存及上下架狀態(tài)。訂單管理分頁查詢?nèi)坑唵沃С职礌顟B(tài)/訂單號(hào)/會(huì)員/球桌篩選可查看訂單詳情及商品明細(xì)支持取消進(jìn)行中的訂單。會(huì)員管理分頁查詢會(huì)員列表支持按角色/關(guān)鍵詞篩選可新增會(huì)員、編輯會(huì)員資料姓名/手機(jī)號(hào)/頭像、刪除會(huì)員。會(huì)員充值為指定會(huì)員執(zhí)行充值操作輸入充值金額、贈(zèng)送金額、支付方式自動(dòng)更新余額并生成充值記錄。服務(wù)員管理分頁查詢服務(wù)員賬號(hào)可新增、編輯、刪除服務(wù)員統(tǒng)一管理員工賬號(hào)信息。預(yù)約管理分頁查詢?nèi)款A(yù)約單支持按狀態(tài)/會(huì)員篩選確認(rèn)預(yù)約后球桌狀態(tài)自動(dòng)變?yōu)橐杨A(yù)約取消或完成后自動(dòng)釋放球桌。輪播圖管理維護(hù)首頁輪播圖配置標(biāo)題、圖片、跳轉(zhuǎn)鏈接、排序號(hào)、啟用狀態(tài)支持新增、編輯、刪除。充值記錄查詢分頁查看會(huì)員充值流水展示充值金額、贈(zèng)送金額、余額快照、支付方式及操作員信息。財(cái)務(wù)報(bào)表導(dǎo)出一鍵導(dǎo)出已結(jié)算訂單 Excel 報(bào)表包含訂單號(hào)、球桌、會(huì)員、臺(tái)費(fèi)、商品費(fèi)、總金額、優(yōu)惠、實(shí)付、支付方式、時(shí)間等字段。普通用戶端用戶注冊(cè)填寫用戶名、密碼、真實(shí)姓名、手機(jī)號(hào)完成注冊(cè)密碼經(jīng) MD5 加密存儲(chǔ)注冊(cè)成功自動(dòng)跳轉(zhuǎn)登錄頁。用戶登錄輸入用戶名和密碼進(jìn)行登錄校驗(yàn)通過后簽發(fā) JWT Token并返回用戶基本信息密碼字段置空。首頁輪播圖展示啟用狀態(tài)status1的輪播圖列表按 sortOrder 升序排列支持跳轉(zhuǎn)鏈接配置。球桌瀏覽查看全部球桌列表按桌號(hào)升序展示球桌類型、散客價(jià)/會(huì)員價(jià)、當(dāng)前狀態(tài)空閑/使用中/已預(yù)約/維護(hù)。商品選購按分類瀏覽上架商品status1展示商品名稱、分類、售價(jià)、庫存、圖片及描述。球桌狀態(tài)統(tǒng)計(jì)查看球桌總數(shù)及空閑、使用中、已預(yù)約、維護(hù)中的數(shù)量分布便于快速判斷可用資源。會(huì)員余額查詢登錄會(huì)員可查看個(gè)人賬戶余額及歷史充值記錄。會(huì)員訂單查詢查看個(gè)人歷史開臺(tái)訂單列表包含訂單號(hào)、球桌、臺(tái)費(fèi)、商品費(fèi)、實(shí)付金額、支付方式等。會(huì)員預(yù)約管理提交球桌預(yù)約申請(qǐng)選擇日期、時(shí)間段、球桌查看預(yù)約狀態(tài)待確認(rèn)/已確認(rèn)/已取消/已完成。服務(wù)員端球桌狀態(tài)看板以卡片形式查看所有球桌實(shí)時(shí)狀態(tài)區(qū)分空閑、使用中、已預(yù)約、維護(hù)四種狀態(tài)便于快速定位可用球桌。開臺(tái)操作選擇空閑球桌支持關(guān)聯(lián)會(huì)員可選和服務(wù)員開臺(tái)后球桌狀態(tài)自動(dòng)變?yōu)槭褂弥胁⑸蛇M(jìn)行中訂單。訂單商品加購對(duì)進(jìn)行中的訂單添加商品輸入商品和數(shù)量自動(dòng)扣減庫存并計(jì)算小計(jì)金額。訂單商品刪除刪除進(jìn)行中的訂單商品項(xiàng)自動(dòng)回補(bǔ)庫存并重新計(jì)算商品費(fèi)用。結(jié)賬操作選擇支付方式現(xiàn)金/微信/支付寶/余額可輸入優(yōu)惠金額系統(tǒng)自動(dòng)計(jì)算臺(tái)費(fèi)按散客價(jià)或會(huì)員價(jià)、商品費(fèi)、總金額、實(shí)付金額。余額支付校驗(yàn)選擇余額支付時(shí)自動(dòng)校驗(yàn)會(huì)員余額是否充足扣款成功后同步更新會(huì)員余額。取消訂單對(duì)進(jìn)行中的訂單執(zhí)行取消操作訂單狀態(tài)變更為已取消球桌自動(dòng)釋放為空閑。四、項(xiàng)目總結(jié)本項(xiàng)目的技術(shù)亮點(diǎn)在于完整覆蓋了臺(tái)球廳運(yùn)營(yíng)的核心業(yè)務(wù)閉環(huán)從會(huì)員自助查詢、服務(wù)員開臺(tái)結(jié)賬到管理員全量管控三端角色權(quán)限清晰、數(shù)據(jù)聯(lián)動(dòng)一致。JWT 認(rèn)證 攔截器鑒權(quán)保證了接口安全MyBatis-Plus 的分頁與邏輯刪除簡(jiǎn)化了數(shù)據(jù)層開發(fā)前端 Vue3 Pinia Element Plus 的組合提供了良好的交互體驗(yàn)和狀態(tài)管理能力。財(cái)務(wù)報(bào)表導(dǎo)出功能直接滿足實(shí)際經(jīng)營(yíng)場(chǎng)景的結(jié)算需求。整套系統(tǒng)前后端分離、代碼結(jié)構(gòu)規(guī)范適合作為 SpringBoot2 Vue3 全棧項(xiàng)目的學(xué)習(xí)案例也可直接作為臺(tái)球廳或類似計(jì)時(shí)計(jì)費(fèi)場(chǎng)所如棋牌室、網(wǎng)咖的二次開發(fā)基礎(chǔ)。界面展示交付內(nèi)容本項(xiàng)目為完整交付包含完整后端源碼完整前端源碼數(shù)據(jù)庫初始化腳本SQL萬字項(xiàng)目文檔設(shè)計(jì)文檔 / 論文可作課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)參考獲取完整源碼完整前后端源碼 數(shù)據(jù)庫腳本 萬字項(xiàng)目文檔見 Gitee 倉庫https://gitee.com/kangxihuang/src-K335