商业球房管理系统-客稻云

1. 立项背景与目标
针对传统大中型台球俱乐部普遍依赖手工记录台费、财务对账繁琐、多门店管理混乱、会员营销手段单一等核心运营痛点，我独立全栈设计并开发了这套商业球房管理系统。项目核心目标是构建一个一体化、数字化、智能化的运营平台，通过技术手段实现从顾客入场到离店结算的全流程自动化管理，并打通多门店数据，为经营者提供实时决策支持，最终达到降本增效、提升营收与客户体验的商业目的。系统上线后已稳定运营两年，验证了其可靠性与实用性。
2. 软件功能与核心模块介绍
系统采用模块化设计，核心功能模块围绕“人、货、场”的精细化运营展开：
（1）核心运营模块：包括台桌管理（支持大型球房分区、排班与状态实时监控）、助教管理（排班、绩效与订单绑定）、消费流程核心（上桌开单、智能计费、多种方式结算）以及店内外卖系统，覆盖线下服务全场景。
（2）管理与决策模块：包含多门店管理（总部统一管控各分店资源、价格与会员体系）、客户关系与营销管理（会员等级、积分、储值、优惠券与营销活动）、以及报表与财务中心（自动生成每日营业报表、门店财报、助教提成、商品销售分析等），实现数据驱动的经营决策。
（3）基础支持模块：涉及角色权限管理、系统操作日志、硬件（扫码枪、打印机）对接等，保障系统稳定与安全。
3. 业务流程与功能路径描述
系统的核心业务流程遵循顾客消费动线，形成管理闭环：
（1）入场与开台：顾客到店（或通过预约），前台在系统“台桌视图”中选择空闲台桌开单，可关联指定助教，系统自动开始计时计费。
（2）消费中服务：过程中，顾客可通过扫描台卡二维码在手机端点购外卖（饮品、小吃），订单实时推送至后厨与前台。所有消费项目实时挂单至该台桌账单。
（3）结算与离店：顾客结账时，前台进入结算界面，系统自动汇总台费、商品费等，支持会员卡、积分、现金、移动支付等多种方式混合结算。支付成功后，系统自动释放台桌、更新库存，并生成账单。
（4）运营与复盘：每日营业结束后，店长通过“报表中心”一键生成当日门店财报，清晰展示营收、商品成本、助教绩效等核心数据。总部管理者可通过“多门店管理”后台，横向对比各店经营健康度，并基于“客户管理”模块数据分析，在“营销管理”中策划定向优惠活动，提升复购率。

项目为我个人全栈开发（包含APP和商米手持机、小程序）
1. 整体架构与设计思路
本项目采用 前后端分离与模块化架构，旨在构建支持多门店高并发运营的稳定系统。
（1）后端：使用 PHP (thinkphp) 框架构建 RESTful API，按业务划分为交易、会员、报表等服务模块。采用 MySQL 主从读写分离，并大量使用 Redis 缓存实时状态（如台桌占用）和会话。
（2）前端：管理后台使用uniapp开发；小程序含助教端、客户端、收银端。通过 WebSocket 实现台桌状态在多终端（前台、大屏）的实时同步。
2. 我的负责模块与量化结果（具体功能看图片及视频）
作为项目全栈负责人，我主导了系统从设计到上线运维的全过程：
（1）系统规模：系统已稳定支撑超过12家门店7x24小时运营逾两年。
（2）性能指标：核心交易接口平均响应时间<100ms，高峰并发支撑>300TPS。
（3）业务效能：将门店日结对账时间从2小时缩短至15分钟内，财务效率提升超过85%。
3. 遇到的难点与解决方案
难点一：台桌状态实时同步与并发控制
问题：多终端需实时同步数百张台桌状态，并发操作易导致数据冲突。
解决：以Redis为中心化状态源，利用其发布订阅机制与WebSocket实现实时推送；对关键操作使用Redis分布式锁确保一致性。
难点二：营销活动与计费规则频繁变更
问题：复杂的优惠活动（如折扣、满赠）若硬编码，会导致代码难以维护。
解决：采用策略模式设计可配置的规则引擎，将优惠逻辑抽象化、可视化，允许运营人员后台灵活配置，使新增营销活动无需修改核心代码。
难点三：多门店数据汇总性能瓶颈
问题：总部实时查询全部门店报表时，直接查询业务库会导致性能压力。
解决：采用异步消息队列，将订单事件同步至独立的报表汇总数据库。总部查询时访问汇总库，实现了交易与分析的解耦，保障了线上业务性能。