# billards

**Repository Path**: x_195/billards

## Basic Information

- **Project Name**: billards
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 介绍

**台球预约平台**是一款基于 Spring Boot + Vue.js 技术栈前后端分离开发的线上预约管理系统，旨在为台球厅商家和用户提供便捷的场地预订、订单管理、时段查询等服务。

## 系统核心价值：

    - 用户端：支持注册登录、在线选台预约、支付下单、预约凭证生成
    - 后台：提供后台数据统计、场地状态管理、订单核销、确定订单等处理
    - 解决痛点：有效改善线下台球厅预约效率低、场地利用率不均、订单管理混乱等问题

## 软件架构

    1. 后端架构
    
        - 核心框架：Spring Boot 2.x（依赖注入、自动配置、简化开发流程）
        - 持久层：MyBatis-Plus（简化CRUD操作，支持分页查询、条件构造器）
        - 数据库：MySQL 8.0（存储用户信息、场地数据、订单记录等核心数据）
        - 安全认证：Spring Security + JWT（实现登录态校验、基于角色的权限控制）
        - 接口规范：RESTful API（标准化前后端数据交互格式）
    
    2. 前端架构
    
        - 核心框架：Vue.js（轻量高效，提升开发与构建速度）
        - 状态管理：Pinia（替代Vuex，简化状态管理，支持模块化）
        - UI组件库：LayUI（提供表单、表格、弹窗等丰富UI组件）
        - 网络请求：Axios（封装请求/响应拦截器，统一处理JWT令牌传递与错误信息）
    
    3. 部署架构
    
        - 前端：打包为静态资源，部署至Nginx服务器，实现高效访问与反向代理
        - 后端：打包为Jar包，部署至Tomcat或直接通过Java命令独立运行
        - 数据库：独立部署，开启主从备份机制，保障数据安全性与可用性

## 安装教程

## 环境准备

    - JDK：17 或 21 版本
    - MySQL：8.0 版本
    - Maven：3.12.x 版本（用于后端项目构建）

## 安装步骤

    1. 克隆代码到本地：git clone https://gitee.com/[你的用户名]/billards.git
    2. 进入后端项目目录：cd billards/backend
    3. 创建MySQL数据库：CREATE DATABASE billards_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    4. 修改数据库配置：编辑 application.yml 文件，替换数据库连接的用户名、密码
    5. 打包项目：执行Maven命令 mvn clean package -DskipTests（跳过测试环节，加快打包速度）
    6. 运行项目：java -jar target/billards-0.0.1-SNAPSHOT.jar

## 前端安装步骤

    1. 访问前端页面：打开浏览器访问http://localhost:8081，确认页面正常加载

## 使用说明(注：本地登录注册必须要先打开Redis服务)

    ### 普通用户端
    
        1. 注册/登录：通过qq邮箱验证码和账号密码完成注册并登录系统
        2. 场地选择：选择目标台球厅，查看场地类型（中式八球、斯诺克等）及当前可用状态
        3. 预约下单：选择预约日期与时段，确认订单信息（场地、时长、费用）
        4. 在线支付：通过支付宝沙箱的支付方式完成订单支付
    
    ### 管理员端
    
        1. 登录：使用管理员账号登录系统后台
        2. 订单管理：主要负责所有支付的订单，将订单的状态更改为已确定（为后续的逻辑）
        3. 球桌管理：新增、编辑、下架场地信息，设置类型与收费标准，并且将有故障的球桌状态更改为维修中（用户不可下单）
        4. 商品管理：新增、编辑价格、下架商品、库存等信息
        5. 优惠券管理：添加优惠券的相关信息，（例如：有效时间、过期时间）
        6. 会员管理：编辑会员价格或者会员时长等信息

    ### 超级管理员
        1. 登录：使用超级管理员账号登录系统后台
        2. 用户管理：管理用户账号（禁用、解封）
        3. 管理员管理：管理管理员职位
        4. 查看经营数据报表（订单量、营收统计、热门场地排行等）