涨球小助手产品系统

面向台球爱好者与线下球房运营场景，解决练球数据难沉淀、比赛计分不便、附近球房信息分散、球友社交与约球缺乏统一入口等痛点。项目覆盖中式八球、斯诺克、九球等主流玩法，服务从入门到进阶的广大台球用户，并支持用户众包发现球房、平台审核入库，形成「练球—比赛—找场—社交」的完整台球服务闭环。

微信小程序提供记分板（多赛制实时计分与房间协作）、训练记录与统计、挡位测试、课程学习、社交动态与好友关注、即时聊天、附近球房查询与提交审核、用户反馈及积分等级成长体系；管理端支持行政区划与球房数据同步（高德/百度地图）、球房与用户提交审核、反馈处理及定时任务；用户通过比赛、训练、贡献球房等行为获取积分并升级，激励持续使用与社区共建。

采用前后端分离与多模块架构：billiards-helper-wechat 为微信小程序端；billiards-helper-provider 基于 Spring Boot 3、MyBatis-Plus、MySQL、Redis、JWT 与微信 SDK 提供业务 API；billiards-helper-manager 承担管理后台与区域/球房同步定时任务；billiards-helper-dashboard 为 Vue + Element Plus 管理界面；billiards-helper-proxy 通过 Nginx 提供 HTTPS 反向代理与负载均衡；各模块配合 GitLab CI、Docker 部署，数据库脚本统一维护于 database 目录。