# 台球管理

**Repository Path**: sbh521/taiqiu_public

## Basic Information

- **Project Name**: 台球管理
- **Description**: 台球收费管理系统，带智能灯控、
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
	<img alt="logo" src="https://oscimg.oschina.net/oscnet/up-d3d0a9303e11d522a06cd263f3079027715.png">
</p>
<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">台球社预约管理系统</h1>
<h4 align="center">基于 SpringBoot + Vue 前后端分离的台球社经营管理平台</h4>
<p align="center">
	<a href="https://gitee.com/sbh521/taiqiu_manage"><img src="https://img.shields.io/badge/Gitee-台球管理系统-brightgreen.svg"></a>
	<a href="https://gitee.com/y_project/RuoYi-Vue"><img src="https://img.shields.io/badge/RuoYi-v3.9.1-blue.svg"></a>
	<a href="https://gitee.com/sbh521/taiqiu_manage/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg"></a>
</p>

## 系统简介

台球社预约管理系统是一套专为台球厅、台球俱乐部设计的综合性经营管理平台，覆盖会员管理、球台管理、预约订台、收银结算、财务报表、灯控设备等核心业务场景，帮助台球社实现数字化、智能化运营。

## 技术架构

- **后端**：Spring Boot 2.5.x + MyBatis + MySQL + Redis
- **前端**：Vue 2.6 + Element UI + Vuex + Vue Router
- **权限**：Spring Security + JWT Token
- **灯控**：MQTT 协议（Mosquitto/EMQX）+ 预留 Modbus/TCP 接口

## 核心功能模块

### 1. 会员中心
- 会员档案管理（基础信息、等级、标签）
- 会员等级体系（等级规则、升降级）
- 会员卡类型（储值卡、次卡、日卡等）
- 会员储值与消费记录
- 积分管理（积分获取、兑换）
- 会员权益与黑名单

### 2. 台球管理
- 球厅区域管理（大厅、VIP区、比赛区等）
- 球台管理（球台状态、定价关联）
- 定价策略（按时段、区域、会员等级）
- 预约订台（在线预约、球台锁定）

### 3. 收银结算
- 订单创建与开台
- 消费明细添加
- 多种结算方式（现金、储值、微信、支付宝）
- 自动生成结账单据

### 4. 财务结算
- 营业报表（日/周/月/年统计）
- 资金流水记录
- 发票管理

### 5. 管理者驾驶舱
- 实时经营数据看板
- 球台使用率统计
- 会员消费分析
- 财务趋势图表

### 6. 灯控设备
- 灯控设备管理（MQTT/Modbus/TCP）
- 球台灯光远程控制
- 批量开灯/关灯
- 设备状态监控

## 项目结构

```
RuoYi-Vue/
├── ruoyi-admin/          # 启动入口模块
├── ruoyi-framework/      # 框架核心模块
├── ruoyi-system/         # 系统模块（实体/服务/Mapper）
├── ruoyi-common/         # 公共模块（工具/注解/常量）
├── ruoyi-quartz/         # 定时任务模块
├── ruoyi-generator/      # 代码生成模块
├── ruoyi-ui/             # 前端 Vue 项目
└── sql/                  # SQL 脚本
```

## 快速开始

### 环境要求

- JDK 1.8+
- MySQL 5.7+
- Maven 3.6+
- Node.js 14+
- Redis（可选）
- MQTT Broker（可选，用于灯控）

### 后端启动




2. 修改数据库连接配置 `ruoyi-admin/src/main/resources/application-druid.yml`

3. 修改 MQTT 配置 `ruoyi-admin/src/main/resources/application.yml`（如不需要灯控，保持 mqtt.enabled=false）

4. 编译打包：
```bash
mvn clean package -DskipTests
```

5. 运行：
```bash
java -jar ruoyi-admin/target/ruoyi-admin.jar
```

### 前端启动

```bash
cd ruoyi-ui
npm install
npm run dev
```

访问 http://localhost:80 即可进入系统。

### 默认账号

- 管理员：admin / admin123
- 普通用户：ry / admin123

## 灯控设备配置（可选）

### 安装 MQTT Broker（以 Mosquitto 为例）

1. 下载 Mosquitto：https://mosquitto.org/download/
2. 安装后启动服务
3. 修改 `application.yml`：
```yaml
mqtt:
  enabled: true
  broker-url: tcp://localhost:1883
  username: ""
  password: ""
```

### 灯控消息格式

- **主题**：`billiard/light/{设备编号}`
- **消息**：`ON`（开灯）/ `OFF`（关灯）

## 截图预览

![输入图片说明](ruoyi-ui/src/assets/images/666.png)

### 系统首页
![系统首页](ruoyi-ui/src/assets/images/img_1.png)

### 会员管理
![会员管理](ruoyi-ui/src/assets/images/img_2.png)

### 灯控设备
![灯控设备](ruoyi-ui/src/assets/images/img.png)


## 许可证

MIT License

需要全部源码 加Q 1538494554
需要全部源码 加Q 1538494554
需要全部源码 加Q 1538494554