# 一杆云枢 **Repository Path**: li-wei-12138/CloudPivot ## Basic Information - **Project Name**: 一杆云枢 - **Description**: 基于 `Vue3` + `Node.js` 的全栈解决方案，将传统台球俱乐部升级为 **云端智慧运营体**。 以“一杆击球”的精准为灵感，打造 **资源调度、会员服务、商业决策** 三位一体的数据枢纽。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2025-06-18 - **Last Updated**: 2026-02-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🎱 一杆云枢 ©版权归levi所有，侵权必究 一个完整的台球吧管理系统，包含用户管理、订单管理、数据统计和可视化功能。专业、智能、高效的台球场馆数字化管理解决方案。 ## 🌟 功能特性 ### 👥 用户管理 - ✅ 用户注册/登录 - ✅ 用户信息管理 - ✅ 余额管理 - ✅ 用户状态控制 - ✅ 用户统计分析 ### 📋 订单管理 - ✅ 台球桌预订 - ✅ 订单状态跟踪 - ✅ 订单统计分析 - ✅ 收入统计 ### 📊 数据可视化45651 - ✅ 实时数据统计45651 - ✅ 图表展示 - ✅ Grafana 集成 - ✅ 多维度数据分析 ### 🔐 权限管理 - ✅ 管理员/普通用户角色 - ✅ 接口权限控制 - ✅ JWT 身份验证 ## 🏗️ 技术架构 ### 前端技术栈 - **Vue 3** - 渐进式JavaScript框架 - **Element Plus** - Vue 3 UI组件库 - **ECharts** - 数据可视化图表库 - **Vue Router** - 路由管理 - **Axios** - HTTP客户端 ### 后端技术栈 - **Node.js** - JavaScript运行环境 - **Express** - Web应用框架 - **MySQL** - 关系型数据库 - **JWT** - 身份验证 - **bcryptjs** - 密码加密 ### 数据可视化 - **Grafana** - 开源数据可视化平台 - **MySQL** - 数据源 ## 🚀 快速开始 ### 方法一：使用快速安装脚本 **Windows:** ```cmd quick-setup.bat ``` **Linux/macOS:** ```bash ./quick-setup.sh ``` ### 方法二：手动安装 1. **安装依赖** ```bash # 后端 cd backend npm install # 前端 cd ../frontend npm install ``` 2. **配置环境** ```bash cd backend cp .env.example .env # 编辑 .env 文件配置数据库连接 ``` 3. **启动服务** ```bash # 启动后端（端口3001） cd backend npm run dev # 启动前端（端口8081） cd frontend npm run dev ``` 4. **访问系统** - 前端地址：http://113.46.199.88:8081 - 管理员账户：admin / admin123 ## 📊 数据可视化设置 ### 1. 安装 MySQL 参考 `backend/database/README.md` ### 2. 初始化数据库 ```bash mysql -u root -p < backend/database/init.sql mysql -u root -p < backend/database/seed.sql ``` ### 3. 安装 Grafana 参考 `grafana/install-grafana.md` ### 4. 配置仪表板 导入 `grafana/dashboard-config.json` ## 📁 项目结构 ``` BallSystem/ ├── frontend/ # 前端项目 │ ├── src/ │ │ ├── views/ # 页面组件 │ │ ├── components/ # 公共组件 │ │ ├── api/ # API接口 │ │ ├── utils/ # 工具函数 │ │ └── router/ # 路由配置 │ └── package.json ├── backend/ # 后端项目 │ ├── src/ │ │ ├── controllers/ # 控制器 │ │ ├── models/ # 数据模型 │ │ ├── routes/ # 路由 │ │ └── middlewares/ # 中间件 │ ├── config/ # 配置文件 │ ├── database/ # 数据库脚本 │ └── package.json ├── grafana/ # Grafana配置 │ ├── install-grafana.md # 安装指南 │ └── dashboard-config.json # 仪表板配置 ├── quick-setup.bat # Windows快速安装 ├── quick-setup.sh # Linux/macOS快速安装 └── deploy.md # 部署指南 ``` ## 🔧 API 接口 ### 认证接口 - `POST /api/auth/login` - 用户登录 - `POST /api/auth/register` - 用户注册 - `GET /api/auth/me` - 获取当前用户信息 ### 用户管理接口 - `GET /api/admin/users` - 获取用户列表 - `GET /api/admin/users/stats` - 获取用户统计 - `PUT /api/admin/users/:id` - 更新用户信息 - `PUT /api/admin/users/:id/balance` - 更新用户余额 - `DELETE /api/admin/users/:id` - 删除用户 ### 订单管理接口 - `GET /api/orders` - 获取订单列表 - `GET /api/admin/orders/stats` - 获取订单统计 - `POST /api/orders` - 创建订单 - `PUT /api/orders/:id/status` - 更新订单状态 - `DELETE /api/admin/orders/:id` - 删除订单 ## 📊 数据统计 ### 用户统计 - 总用户数、活跃用户数 - 用户注册趋势 - 用户余额分布 - 用户角色分布 ### 订单统计 - 总订单数、今日订单数 - 订单状态分布 - 收入统计 - 台球桌使用情况 ## 🔒 安全特性 - JWT身份验证 - 密码加密存储 - 接口权限控制 - SQL注入防护 - XSS攻击防护 ## 🌐 浏览器支持 - Chrome (推荐) - Firefox - Safari - Edge ## 📝 更新日志 ### v2.1.0 (2025-03-18) **🚀 功能更新** - 🔐 **安全增强**：完善系统安全机制 - 🛡️ **新增**：API访问频率限制 - 🔑 **改进**：用户认证机制优化 - 📁 **优化**：文件管理功能 - 🌐 **改进**：跨域访问配置 - 📤 **改进**：文件上传功能增强 - 📦 **更新**：依赖项版本升级 ### v2.0.13 (2025-01-15) **🎯 功能优化** - 📊 **改进**：优化数据可视化图表性能 - 🔄 **新增**：实时数据同步功能 - 💰 **改进**：财务报表导出功能增强 - 🎨 **改进**：用户界面响应式设计优化 - 🐛 **修复**：修复订单状态更新延迟问题 ### v2.0.12 (2025-01-08) **💳 支付系统** - 💰 **新增**：虚拟支付QR码功能 - 💳 **新增**：余额充值系统 - 📱 **新增**：支付记录查询功能 - 🔄 **改进**：订单支付流程优化 - 📊 **新增**：支付统计分析 ### v2.0.11 (2024-12-28) **📦 库存管理** - 📋 **新增**：库存管理模块 - 📊 **新增**：库存统计和预警功能 - 🔄 **新增**：库存进出记录追踪 - 📈 **新增**：库存数据可视化 - ⚠️ **新增**：低库存自动提醒 ### v2.0.10 (2024-12-20) **🎯 预订系统优化** - ⏰ **改进**：固定时间段预订系统 - 🚫 **新增**：过期时间段自动禁用 - 🔄 **新增**：实时预订状态同步 - 📅 **改进**：预订界面用户体验优化 - 🎨 **改进**：更人性化的UI设计 ### v2.0.9 (2024-12-12) **📊 数据分析增强** - 📈 **新增**：用户行为分析模块 - 📊 **新增**：收入趋势分析 - 🎯 **新增**：台球桌使用率统计 - 📋 **新增**：详细的数据导出功能 - 🔍 **改进**：高级数据筛选功能 ### v2.0.8 (2024-12-05) **👥 用户管理优化** - 📝 **新增**：用户注册时间数据绑定 - 👀 **新增**：用户数据可视化切换功能 - 📊 **改进**：用户统计图表优化 - 🔍 **新增**：用户搜索和筛选功能 - 📤 **改进**：用户数据导出功能增强 ### v2.0.7 (2024-11-28) **🎨 界面体验** - 🎨 **改进**：整体UI/UX设计优化 - 📱 **改进**：移动端适配优化 - 🌙 **新增**：深色模式支持 - 🎯 **改进**：操作反馈和提示优化 - ⚡ **改进**：页面加载性能优化 ### v2.0.6 (2024-11-20) **📋 订单系统增强** - 📦 **新增**：批量订单处理功能 - 🕐 **改进**：订单时间显示格式优化（中文可读格式） - 🔄 **新增**：订单状态实时同步 - 📊 **新增**：订单统计报表功能 - 🐛 **修复**：订单创建时的时区问题 ### v2.0.5 (2024-11-12) **🎱 台球桌管理** - 🎱 **新增**：台球桌类型管理（斯诺克、美式8球、中式8球） - 💰 **新增**：不同类型台球桌差异化定价 - 🔧 **新增**：台球桌维护状态管理 - 📊 **新增**：台球桌使用统计 - 🎯 **改进**：台球桌预订界面优化 ### v2.0.4 (2024-11-05) **🔐 权限系统** - 👑 **改进**：管理员权限细化 - 🔒 **新增**：操作日志记录 - 👥 **新增**：用户角色管理 - 🛡️ **改进**：接口权限验证增强 - 📝 **新增**：权限变更审计功能 ### v2.0.3 (2024-10-28) **💾 数据库优化** - ⚡ **改进**：数据库查询性能优化 - 🔄 **新增**：数据库连接池管理 - 📊 **改进**：数据统计查询优化 - 🔧 **新增**：数据库备份功能 - 🐛 **修复**：并发访问数据一致性问题 ### v2.0.2 (2024-10-20) **📊 Grafana集成优化** - 📈 **改进**：Grafana仪表板配置优化 - 🔄 **新增**：实时数据刷新功能 - 📊 **新增**：自定义图表配置 - 🎯 **改进**：数据源连接稳定性 - 📋 **新增**：仪表板模板导入导出 ### v2.0.1 (2024-10-12) **🐛 Bug修复版本** - 🐛 **修复**：用户登录状态异常问题 - 🐛 **修复**：订单创建时间显示错误 - 🐛 **修复**：数据统计计算精度问题 - 🐛 **修复**：文件上传大小限制问题 - 🔧 **改进**：错误处理和用户提示优化 ### v2.0.0 (2024-10-05) **🎉 重大版本更新** - 🆕 **新增**：全新的用户界面设计 - 📊 **新增**：高级数据可视化功能 - 💰 **新增**：财务管理模块 - 📱 **新增**：响应式设计支持 - ⚡ **改进**：整体性能优化50% - 🔄 **重构**：前端架构升级到Vue 3 - 🎨 **新增**：Element Plus UI组件库 ### v1.3.2 (2024-09-28) **🔧 维护更新** - 🔧 **改进**：系统稳定性优化 - 📝 **改进**：API文档完善 - 🐛 **修复**：内存泄漏问题 - 📊 **改进**：日志记录优化 - 🔒 **改进**：密码加密算法升级 ### v1.3.1 (2024-09-20) **📈 功能增强** - 📊 **新增**：订单趋势分析图表 - 🎯 **新增**：用户活跃度统计 - 💰 **新增**：收入预测功能 - 📋 **改进**：数据导出格式优化 - 🔍 **新增**：高级搜索功能 ### v1.3.0 (2024-09-16) **🚀 功能扩展** - 🎱 **新增**：台球桌状态实时监控 - 📅 **新增**：预订日历视图 - 💬 **新增**：用户反馈系统 - 📧 **新增**：邮件通知功能 - 🔔 **新增**：系统消息推送 - 📱 **改进**：移动端用户体验优化 --- ### 📋 版本说明 - **主版本号**：重大功能更新或架构变更 - **次版本号**：新功能添加或重要改进 - **修订版本号**：Bug修复和小幅优化 ### 🔄 升级指南 升级到最新版本前，请： 1. 备份数据库 2. 查看对应版本的更新说明 3. 按照部署文档进行升级 4. 验证功能正常运行 ### 🐛 问题反馈 如发现问题，请提供： - 版本号信息 - 详细的错误描述 - 复现步骤 - 系统环境信息 ## 🤝 贡献指南 1. Fork 项目 2. 创建功能分支 3. 提交更改 4. 推送到分支 5. 创建 Pull Request ## 📞 技术支持 如有问题，请查看： 1. `deploy.md` - 详细部署指南 2. `backend/database/README.md` - 数据库配置 3. `grafana/install-grafana.md` - Grafana安装指南 --- **🎉 感谢使用一杆云枢！** **当前版本：v2.1.0** | **最后更新：2025-06-18**