# VibeVote-Live

**Repository Path**: jesse_yang/VibeVote-Live

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VibeVote-Live: 2026 年度盛典实时互动投票系统

VibeVote-Live 是一个专为各类年会、盛典、创意市集、路演演说设计的**全流程实时互动投票系统**。系统采用现代化的视觉设计，通过手机端扫码投票与大屏幕 3D 实时渲染，极大地提升了活动现场的参与感与品牌质感。

<img width="1349" height="605" alt="image" src="https://github.com/user-attachments/assets/412345bc-1383-4d6e-98a1-70d5c7d458ab" />



---

## 🌟 核心特性

- **🚀 极致实时**: 基于 Socket.io，票数更新、主题修改、数据重置均实现秒级同步，无需手动刷新。
- **📊 3D 视觉盛典**: 大屏幕采用 3D 质感柱状图，为前五名设计了莫兰迪五级专属色系，并伴随全屏礼花特效。
- **🛡️ 商业级安全**:
  - **防刷票**: 结合设备指纹、IP 地址及 User-Agent 的多重校验，有效杜绝恶意刷票。
  - **管理保护**: 管理后台受用户名密码保护，确保系统控制权安全。
- **⚙️ 高级自定义**: 管理员可实时修改活动标题，系统将自动适配并同步到所有屏幕。
- **📱 全场景二维码**: 大屏幕、后台及投票端均集成动态生成二维码，支持现场快速分享。
- **💾 数据库持久化**: 采用轻量级 SQLite 存储，确保活动数据在断电或重启后不丢失。
- **⚡️ 一键部署**: 提供 `start.sh` 脚本，实现依赖安装与服务启动的自动化。

---

---

## 🛠 部署要求

### 1. 软件环境
- **Node.js**: 推荐 **v18.0.0** 或更高版本。
- **SQLite**: 内置支持，无需配置。

### 2. 云服务器/公网部署设置 (重要)
VibeVote-Live 已针对云服务器环境进行了**自适应网络优化**，您无需手动修改代码中的 IP 地址：

- **0.0.0.0 绑定**: 后端与 Vite 前端均已配置为监听 `0.0.0.0`，确保外网可达。
- **IP 自适应**: 前端 API 地址现已改为动态获取。只要您通过公网 IP 访问，系统会自动确保所有手机端请求穿透到正确的公网接口。
- **端口开放**: 请务必在云服务器安全组开启 **3001** 和 **5173** 端口。

---

## 🚀 快速启动

### 方式一：推荐一键启动 (Mac/Linux)

在项目根目录下，直接运行一键脚本：
```bash
chmod +x start.sh
./start.sh
```
该脚本会自动检查依赖并同时启动后端（3001端口）和前端（5173端口）。

### 方式二：手动分步启动

1. **后端 (Server)**:
   ```bash
   cd server
   npm install
   npm start
   ```
2. **前端 (Client)**:
   ```bash
   cd client
   npm install
   npm run dev
   ```

---

## ⚙️ 管理员操作指南

- **管理入口**: `http://localhost:5173/admin`
- **默认账户**: 
  - **用户名**: `admin`
  - **密  码**: `admin123`
- **主要逻辑**:
  - **系统设置**: 修改“活动名称”后，大屏和手机端将实时更新。
  - **重置投票**: 点击“重置所有投票”不仅会清空数据库票数，还会发出广播强制清除所有观众手机端的投票状态（让他们可以重新投票）。
  - **二维码预览**: 后台直接提供投票入口的二维码预览，方便合影或导出。

---

## � 项目结构

- `/client`: 基于 React + Vite 的前端展示层 (大屏/观众端/后台)。
- `/server`: 基于 Node.js + Express + Better-SQLite3 的服务逻辑层。
- `start.sh`: 项目运维管理脚本。

---

## 🧘‍♂️ 适用场景

- 公司年会节目评选
- 创意市集人气摊位投票
- 演讲比赛实时打分
- 兴趣社团竞选现场
- 各类需要营造热烈气氛的现场互动场景

---

© 2026 VibeVote Project. 让每一张选票都闪闪发光。🏆